fix: improve query agent tool descriptions and prompt clarity

Author: rejojer

openkb/agent/query.py

@@ -27,10 +27,10 @@
    - PageIndex documents (doc_type: pageindex): use get_page_content(doc_name, pages)
      with tight page ranges. The summary shows document tree structure with page
      ranges to help you target. Never fetch the whole document.
-5. Synthesize a clear, well-cited answer grounded in wiki content.
+5. Synthesize a clear, concise, well-cited answer grounded in wiki content.
 
-Answer based only on wiki content. Before each tool call, briefly state what you
-are about to do. Be concise.
+Answer based only on wiki content. Be concise.
+Before each tool call, briefly state what you are about to do.
 
 If you cannot find relevant information, say so clearly.
 """
@@ -52,9 +52,9 @@ def read_file(path: str) -> str:
 
     @function_tool
     def get_page_content_tool(doc_name: str, pages: str) -> str:
-        """Get text content of specific pages from a long document.
-        Use this when you need detailed content from a document. The summary
-        page shows document tree structure with page ranges.
+        """Get text content of specific pages from a PageIndex (long) document.
+        Only use for documents with doc_type: pageindex. For short documents,
+        use read_file instead.
         Args:
             doc_name: Document name (e.g. 'attention-is-all-you-need').
             pages: Page specification (e.g. '3-5,7,10-12').

openkb/cli.py

@@ -257,7 +257,7 @@ def init():
 
     # Interactive prompts
     model = click.prompt(
-        f"Model (e.g. gpt-5.4, anthropic/claude-sonnet-4-6) [default: {DEFAULT_CONFIG['model']}]",
+        f"Model (e.g. gpt-5.4-mini, anthropic/claude-sonnet-4-6) [default: {DEFAULT_CONFIG['model']}]",
         default=DEFAULT_CONFIG["model"],
         show_default=False,
     )