stagent 0.10.0 → 0.11.1

package/src/components/documents/document-browser.tsx

@@ -1,9 +1,8 @@
 "use client";
 
 import { useState, useCallback, useRef } from "react";
-import { useRouter } from "next/navigation";
+import { useRouter, useSearchParams } from "next/navigation";
 import { Button } from "@/components/ui/button";
-import { Input } from "@/components/ui/input";
 import {
   Select,
   SelectContent,
@@ -11,7 +10,9 @@ import {
   SelectTrigger,
   SelectValue,
 } from "@/components/ui/select";
-import { LayoutGrid, LayoutList, Upload, Trash2, Search } from "lucide-react";
+import { LayoutGrid, LayoutList, Upload, Trash2 } from "lucide-react";
+import { FilterInput } from "@/components/shared/filter-input";
+import { parseFilterInput, matchesClauses, type FilterClause } from "@/lib/filters/parse";
 import { toast } from "sonner";
 import { DocumentTable } from "./document-table";
 import { DocumentGrid } from "./document-grid";
@@ -30,7 +31,12 @@ export function DocumentBrowser({
 }: DocumentBrowserProps) {
   const [docs, setDocs] = useState(initialDocuments);
   const [view, setView] = useState<"table" | "grid">("table");
-  const [search, setSearch] = useState("");
+  const searchParams = useSearchParams();
+  const initialFilter = searchParams.get("filter") ?? "";
+  const initialParsed = parseFilterInput(initialFilter);
+  const [filterRaw, setFilterRaw] = useState(initialFilter);
+  const [rawQuery, setRawQuery] = useState(initialParsed.rawQuery);
+  const [clauses, setClauses] = useState<FilterClause[]>(initialParsed.clauses);
   const [statusFilter, setStatusFilter] = useState<string>("all");
   const [directionFilter, setDirectionFilter] = useState<string>("all");
   const [projectFilter, setProjectFilter] = useState<string>("all");
@@ -54,16 +60,20 @@ export function DocumentBrowser({
 
   const filtered = docs.filter((doc) => {
     if (
-      search &&
-      !doc.originalName.toLowerCase().includes(search.toLowerCase()) &&
-      !(doc.extractedText ?? "").toLowerCase().includes(search.toLowerCase())
+      rawQuery &&
+      !doc.originalName.toLowerCase().includes(rawQuery.toLowerCase()) &&
+      !(doc.extractedText ?? "").toLowerCase().includes(rawQuery.toLowerCase())
     ) {
       return false;
     }
     if (statusFilter !== "all" && doc.status !== statusFilter) return false;
     if (directionFilter !== "all" && doc.direction !== directionFilter) return false;
     if (projectFilter !== "all" && doc.projectId !== projectFilter) return false;
-    return true;
+    return matchesClauses(doc, clauses, {
+      status: (d, v) => (d.status ?? "").toLowerCase() === v.toLowerCase(),
+      direction: (d, v) => (d.direction ?? "").toLowerCase() === v.toLowerCase(),
+      type: (d, v) => (d.mimeType ?? "").toLowerCase().includes(v.toLowerCase()),
+    });
   });
 
   function toggleSelect(id: string) {
@@ -112,27 +122,35 @@ export function DocumentBrowser({
 
       <FilterBar
         activeCount={
-          (search ? 1 : 0) +
+          (filterRaw ? 1 : 0) +
           (statusFilter !== "all" ? 1 : 0) +
           (directionFilter !== "all" ? 1 : 0) +
           (projectFilter !== "all" ? 1 : 0)
         }
         onClear={() => {
-          setSearch("");
+          setFilterRaw("");
+          setRawQuery("");
+          setClauses([]);
           setStatusFilter("all");
           setDirectionFilter("all");
           setProjectFilter("all");
+          router.replace("?", { scroll: false });
         }}
       >
-        <div className="relative flex-1 min-w-[200px]">
-          <Search className="absolute left-2.5 top-2.5 h-4 w-4 text-muted-foreground" />
-          <Input
-            placeholder="Search by name or content..."
-            value={search}
-            onChange={(e) => setSearch(e.target.value)}
-            className="pl-9"
-          />
-        </div>
+        <FilterInput
+          value={filterRaw}
+          onChange={({ raw, clauses, rawQuery }) => {
+            setFilterRaw(raw);
+            setClauses(clauses);
+            setRawQuery(rawQuery);
+            const params = new URLSearchParams(searchParams.toString());
+            if (raw) params.set("filter", raw);
+            else params.delete("filter");
+            const query = params.toString();
+            router.replace(query ? `?${query}` : "?", { scroll: false });
+          }}
+          placeholder="Search or #status:ready #type:pdf …"
+        />
 
         <Select value={statusFilter} onValueChange={setStatusFilter}>
           <SelectTrigger className="w-[140px]">

package/src/components/notifications/__tests__/permission-response-actions.test.tsx

@@ -62,6 +62,76 @@ describe("permission response actions", () => {
     });
   });
 
+  it("renders option cards for AskUserQuestion with options and posts { answer } on click", async () => {
+    const onResponded = vi.fn();
+    render(
+      <PermissionResponseActions
+        taskId="task-42"
+        notificationId="notif-q1"
+        toolName="AskUserQuestion"
+        toolInput={{
+          question: "Which version?",
+          options: [
+            { label: "Keep my version", description: "Use your changes" },
+            { label: "Take main's version", description: "Use main's changes" },
+          ],
+        }}
+        responded={false}
+        response={null}
+        onResponded={onResponded}
+      />
+    );
+
+    const group = screen.getByRole("radiogroup");
+    expect(group).toBeInTheDocument();
+    fireEvent.click(screen.getByText("Take main's version"));
+
+    await waitFor(() => {
+      expect(fetch).toHaveBeenCalledWith("/api/tasks/task-42/respond", {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify({
+          notificationId: "notif-q1",
+          behavior: "allow",
+          updatedInput: { answer: "Take main's version" },
+        }),
+      });
+      expect(onResponded).toHaveBeenCalled();
+    });
+  });
+
+  it("renders a textarea for AskUserQuestion without options and posts the typed answer", async () => {
+    const onResponded = vi.fn();
+    render(
+      <PermissionResponseActions
+        taskId="task-42"
+        notificationId="notif-q2"
+        toolName="AskUserQuestion"
+        toolInput={{ question: "Move commits to local or abort?" }}
+        responded={false}
+        response={null}
+        onResponded={onResponded}
+      />
+    );
+
+    const textarea = screen.getByPlaceholderText("Type your reply…");
+    fireEvent.change(textarea, { target: { value: "move them to local" } });
+    fireEvent.click(screen.getByRole("button", { name: /Send/i }));
+
+    await waitFor(() => {
+      expect(fetch).toHaveBeenCalledWith("/api/tasks/task-42/respond", {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify({
+          notificationId: "notif-q2",
+          behavior: "allow",
+          updatedInput: { answer: "move them to local" },
+        }),
+      });
+      expect(onResponded).toHaveBeenCalled();
+    });
+  });
+
   it("renders the resolved state label when a response already exists", () => {
     render(
       <PermissionResponseActions

package/src/components/notifications/permission-response-actions.tsx

@@ -1,10 +1,11 @@
 "use client";
 
 import { useState } from "react";
-import { Check, ShieldCheck, X } from "lucide-react";
+import { Check, Send, ShieldCheck, X } from "lucide-react";
 import { toast } from "sonner";
 
 import { Button } from "@/components/ui/button";
+import { Textarea } from "@/components/ui/textarea";
 import { cn } from "@/lib/utils";
 import {
   buildPermissionPattern,
@@ -12,6 +13,28 @@ import {
   type PermissionToolInput,
 } from "@/lib/notifications/permissions";
 
+interface AskUserQuestionOption {
+  label: string;
+  description?: string;
+}
+
+function parseQuestionOptions(toolInput: PermissionToolInput): AskUserQuestionOption[] {
+  const raw = (toolInput as { options?: unknown }).options;
+  if (!Array.isArray(raw)) return [];
+  const out: AskUserQuestionOption[] = [];
+  for (const item of raw) {
+    if (item && typeof item === "object" && typeof (item as { label?: unknown }).label === "string") {
+      const entry: AskUserQuestionOption = {
+        label: (item as { label: string }).label,
+      };
+      const desc = (item as { description?: unknown }).description;
+      if (typeof desc === "string") entry.description = desc;
+      out.push(entry);
+    }
+  }
+  return out;
+}
+
 interface PermissionResponseActionsProps {
   taskId?: string | null;
   notificationId: string;
@@ -87,6 +110,19 @@ export function PermissionResponseActions({
     }
   }
 
+  if (toolName === "AskUserQuestion" || toolName === "ask_user_question") {
+    return (
+      <QuestionReplyActions
+        taskId={taskId}
+        notificationId={notificationId}
+        toolInput={toolInput}
+        onResponded={onResponded}
+        className={className}
+        buttonSize={buttonSize}
+      />
+    );
+  }
+
   return (
     <div
       className={cn(
@@ -124,3 +160,121 @@ export function PermissionResponseActions({
     </div>
   );
 }
+
+interface QuestionReplyActionsProps {
+  taskId?: string | null;
+  notificationId: string;
+  toolInput: PermissionToolInput;
+  onResponded?: () => void;
+  className?: string;
+  buttonSize?: "sm" | "default";
+}
+
+/**
+ * Renders the response UI for an `AskUserQuestion` notification:
+ * - If `toolInput.options` is a non-empty array → card-cluster radiogroup (one click = answer).
+ * - Otherwise → free-form textarea + Send.
+ *
+ * Posts to /api/tasks/[id]/respond with `{ behavior: "allow", updatedInput: { answer } }`.
+ * The task runtime's `waitForToolPermissionResponse()` unblocks and returns `{ answer }`
+ * to the agent.
+ */
+function QuestionReplyActions({
+  taskId,
+  notificationId,
+  toolInput,
+  onResponded,
+  className,
+  buttonSize = "sm",
+}: QuestionReplyActionsProps) {
+  const [loading, setLoading] = useState(false);
+  const [draft, setDraft] = useState("");
+  const options = parseQuestionOptions(toolInput);
+
+  async function sendAnswer(answer: string) {
+    if (!answer.trim()) return;
+    setLoading(true);
+    try {
+      const res = await fetch(`/api/tasks/${taskId ?? "_checkpoint"}/respond`, {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify({
+          notificationId,
+          behavior: "allow",
+          updatedInput: { answer: answer.trim() },
+        }),
+      });
+
+      if (!res.ok) {
+        const data = (await res.json().catch(() => null)) as
+          | { error?: string }
+          | null;
+        throw new Error(data?.error ?? "Failed to send answer");
+      }
+
+      onResponded?.();
+    } catch (error) {
+      toast.error(
+        error instanceof Error ? error.message : "Failed to send answer"
+      );
+    } finally {
+      setLoading(false);
+    }
+  }
+
+  if (options.length > 0) {
+    return (
+      <div
+        role="radiogroup"
+        aria-label="Choose a response"
+        className={cn("grid gap-2 sm:grid-cols-1", className)}
+      >
+        {options.map((option) => (
+          <button
+            key={option.label}
+            type="button"
+            role="radio"
+            aria-checked={false}
+            onClick={() => sendAnswer(option.label)}
+            disabled={loading}
+            className="rounded-lg border border-border/60 bg-background/60 p-3 text-left transition-colors hover:bg-accent/40 focus-visible:ring-2 focus-visible:ring-ring focus-visible:ring-offset-2 focus-visible:outline-none disabled:opacity-60"
+          >
+            <div className="text-sm font-medium text-foreground">{option.label}</div>
+            {option.description && (
+              <div className="mt-1 text-xs text-muted-foreground">{option.description}</div>
+            )}
+          </button>
+        ))}
+      </div>
+    );
+  }
+
+  return (
+    <div className={cn("flex flex-col gap-2", className)}>
+      <Textarea
+        value={draft}
+        onChange={(e) => setDraft(e.target.value)}
+        placeholder="Type your reply…"
+        rows={3}
+        disabled={loading}
+        onKeyDown={(e) => {
+          if (e.key === "Enter" && (e.metaKey || e.ctrlKey)) {
+            e.preventDefault();
+            sendAnswer(draft);
+          }
+        }}
+      />
+      <div className="flex items-center justify-between gap-2">
+        <span className="text-xs text-muted-foreground">⌘/Ctrl + Enter to send</span>
+        <Button
+          size={buttonSize}
+          onClick={() => sendAnswer(draft)}
+          disabled={loading || !draft.trim()}
+        >
+          <Send className="h-3.5 w-3.5" />
+          Send
+        </Button>
+      </div>
+    </div>
+  );
+}

package/src/components/playbook/playbook-detail-view.tsx

@@ -130,7 +130,7 @@ export function PlaybookDetailView({
 
     // Resolve image paths to GitHub raw URLs (public/readme/ excluded from npm package)
     const GITHUB_RAW_BASE =
-      "https://raw.githubusercontent.com/navam-io/stagent/main/public/readme";
+      "https://raw.githubusercontent.com/manavsehgal/stagent/main/public/readme";
     let resolvedSrc = src;
     if (src.includes("screengrabs/")) {
       resolvedSrc = `${GITHUB_RAW_BASE}/${src.split("screengrabs/").pop()}`;

package/src/components/settings/environment-section.tsx

@@ -0,0 +1,102 @@
+"use client";
+
+import { useEffect, useState, useCallback } from "react";
+import { Sparkles, Wand2 } from "lucide-react";
+import { toast } from "sonner";
+import {
+  Card,
+  CardContent,
+  CardDescription,
+  CardHeader,
+  CardTitle,
+} from "@/components/ui/card";
+import { Switch } from "@/components/ui/switch";
+import { Label } from "@/components/ui/label";
+import { FormSectionCard } from "@/components/shared/form-section-card";
+
+interface EnvironmentState {
+  autoPromoteSkills: boolean;
+}
+
+const DEFAULT_STATE: EnvironmentState = {
+  autoPromoteSkills: false,
+};
+
+export function EnvironmentSection() {
+  const [state, setState] = useState<EnvironmentState>(DEFAULT_STATE);
+  const [saving, setSaving] = useState(false);
+
+  const fetchSettings = useCallback(async () => {
+    try {
+      const res = await fetch("/api/settings/environment");
+      if (res.ok) {
+        const data = await res.json();
+        setState(data);
+      }
+    } catch {
+      // Use defaults
+    }
+  }, []);
+
+  useEffect(() => {
+    fetchSettings();
+  }, [fetchSettings]);
+
+  const handleToggle = async (value: boolean) => {
+    setState((prev) => ({ ...prev, autoPromoteSkills: value }));
+    setSaving(true);
+    try {
+      const res = await fetch("/api/settings/environment", {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify({ autoPromoteSkills: value }),
+      });
+      if (res.ok) {
+        const data = await res.json();
+        setState(data);
+        toast.success(`Auto-promote ${value ? "enabled" : "disabled"}`);
+      } else {
+        throw new Error("Save failed");
+      }
+    } catch {
+      toast.error("Failed to save setting");
+      setState((prev) => ({ ...prev, autoPromoteSkills: !value }));
+    } finally {
+      setSaving(false);
+    }
+  };
+
+  return (
+    <Card>
+      <CardHeader>
+        <CardTitle className="flex items-center gap-2">
+          <Sparkles className="h-5 w-5" />
+          Environment
+        </CardTitle>
+        <CardDescription>
+          How Stagent discovers and syncs skills from your environment into the
+          agent profile registry.
+        </CardDescription>
+      </CardHeader>
+      <CardContent className="space-y-4">
+        <FormSectionCard
+          icon={Wand2}
+          title="Auto-promote discovered skills"
+          hint="When enabled, every unlinked skill in ~/.claude/skills/ with a valid SKILL.md is automatically converted into an agent profile on the next environment scan. Leave off to review and promote skills manually from the Environment dashboard."
+        >
+          <div className="flex items-center justify-between">
+            <Label htmlFor="auto-promote-toggle" className="text-sm">
+              {state.autoPromoteSkills ? "Enabled" : "Disabled"}
+            </Label>
+            <Switch
+              id="auto-promote-toggle"
+              checked={state.autoPromoteSkills}
+              disabled={saving}
+              onCheckedChange={handleToggle}
+            />
+          </div>
+        </FormSectionCard>
+      </CardContent>
+    </Card>
+  );
+}

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");
+  });
+});