Update app.py

app.py

@@ -314,7 +314,7 @@ def Search_Structured(  # <-- MCP tool #2 (Structured DDG)
     max_results: int = 5,
 ) -> List[Dict[Literal["snippet", "title", "link"], str]]:
     """
-    (layman) Run a DuckDuckGo search and return a list of {snippet, title, link}.
+    Run a DuckDuckGo search and return a list of {snippet, title, link}.
     """
     if not input_query or not input_query.strip():
         return []
@@ -335,7 +335,7 @@ def Search_Raw(  # <-- MCP tool #3 (Unstructured DDG)
     query: str,
 ) -> list[dict]:
     """
-    (layman) Native DDG client. Returns a plain list[dict] — exactly like your separate space.
+    Search using Native DDG client. Returns a plain list[dict] — exactly like your separate space.
     """
     if not query or not query.strip():
         return []
@@ -357,30 +357,26 @@ def Search_Concise(  # <-- MCP tool #4 (Concise DDG)
     title_chars: int = 80,
 ) -> str:
     """
-    (layman) Minimal-output DuckDuckGo search designed to reduce tokens:
+    Minimal-output DuckDuckGo search designed to reduce tokens:
       - Returns newline-delimited JSON (JSONL) with short keys:
-          t=title, u=url, s=snippet (optional)
-      - Titles and snippets are hard-capped to save tokens.
-      - Domain dedupe on by default to avoid near-duplicates.
+            t=title, u=url, s=snippet
 
     Returns:
       A compact string like:
         {"t":"Example","u":"https://example.com/x"}
         {"t":"Another…","u":"https://a.com/y","s":"Short snippet…"}
     """
-    # Fast guard for empty input
+    
     if not query or not query.strip():
         return ""
 
-    # Perform the search
     try:
         with DDGS() as ddgs:
             raw = ddgs.text(query, max_results=max_results)
     except Exception as e:
-        # (layman) Minimal error payload to keep tokens low
+        
         return json.dumps({"error": str(e)[:120]}, ensure_ascii=False, separators=(",", ":"))
 
-    # Optionally dedupe by domain to reduce redundant lines
     seen_domains = set()
     lines: List[str] = []
 
@@ -427,7 +423,7 @@ fetch_interface = gr.Interface(
         gr.Slider(0, 100, value=20, step=1, label="Max Links"),
     ],
     outputs=gr.Markdown(label="Extracted Summary"),
-    title="Fetch — Clean Extract",
+    title="Fetch Webpage",
     description="Extract title, key metadata, readable text, and links. No noisy HTML.",
     allow_flagging="never",
     theme="Nymbo/Nymbo_Theme",
@@ -441,7 +437,7 @@ websearch_interface = gr.Interface(
         gr.Slider(minimum=1, maximum=20, value=5, step=1, label="Max results"),
     ],
     outputs=gr.JSON(label="Search results"),
-    title="Websearch — DuckDuckGo (Structured)",
+    title="DuckDuckGo Search (Structured)",
     description="Search the web using DuckDuckGo; returns snippet, title, and link.",
     allow_flagging="never",
     theme="Nymbo/Nymbo_Theme",
@@ -449,10 +445,10 @@ websearch_interface = gr.Interface(
 
 # --- Unstructured DDG tab (matches your separate app’s output) ---
 unstructured_interface = gr.Interface(
-    fn=ddg_unstructured,                                       # (layman) raw DDG function
-    inputs=gr.Textbox(label="Enter Search Query"),             # (layman) same single input
-    outputs=gr.Textbox(label="Results", interactive=False),    # (layman) Textbox showing str(list[dict])
-    title="Unstructured DDG (Raw List)",                       # (layman) clear label
+    fn=ddg_unstructured,
+    inputs=gr.Textbox(label="Enter Search Query"),
+    outputs=gr.Textbox(label="Results", interactive=False),
+    title="DuckDuckGo Search (Raw)",
     description="Returns the raw list of results (list[dict]) shown as text.",
     allow_flagging="never",
     theme="Nymbo/Nymbo_Theme",
@@ -461,7 +457,7 @@ unstructured_interface = gr.Interface(
 
 # --- Concise DDG tab (JSONL with short keys, minimal tokens) ---
 concise_interface = gr.Interface(
-    fn=ddg_concise,  # (layman) ultra-succinct search
+    fn=ddg_concise,
     inputs=[
         gr.Textbox(label="Query", placeholder="topic OR site:example.com"),
         gr.Slider(minimum=1, maximum=20, value=5, step=1, label="Max results"),
@@ -470,8 +466,8 @@ concise_interface = gr.Interface(
         gr.Checkbox(value=True, label="Dedupe by domain"),
         gr.Slider(minimum=20, maximum=120, value=80, step=5, label="Max title chars"),
     ],
-    outputs=gr.Textbox(label="Results (JSONL)", interactive=False),  # (layman) copy-friendly minimal output
-    title="DDG (Concise) — Minimal Tokens",
+    outputs=gr.Textbox(label="Results (JSONL)", interactive=False),
+    title="DuckDuckGo Search (Concise)",
     description="Emits JSONL with short keys (t,u[,s]). Defaults avoid snippets and duplicate domains.",
     allow_flagging="never",
     theme="Nymbo/Nymbo_Theme",
@@ -482,7 +478,7 @@ concise_interface = gr.Interface(
 demo = gr.TabbedInterface(
     interface_list=[fetch_interface, websearch_interface, unstructured_interface, concise_interface],
     tab_names=["Fetch", "Websearch", "Unstructured DDG", "DDG (Concise)"],
-    title="Web MCP — Fetch + Websearch + Unstructured + Concise",
+    title="Web MCP — Fetch & DuckDuckGo search with customizable output modes.",
     theme="Nymbo/Nymbo_Theme",
 )