nia-mcp-server 1.0.20__py3-none-any.whl → 1.0.21__py3-none-any.whl

nia_mcp_server/__init__.py

@@ -2,4 +2,4 @@
 NIA MCP Server - Proxy server for NIA Knowledge Agent
 """
 
-__version__ = "1.0.20"
+__version__ = "1.0.21"

nia_mcp_server/api_client.py

@@ -28,7 +28,7 @@ class NIAApiClient:
         self.client = httpx.AsyncClient(
             headers={
                 "Authorization": f"Bearer {api_key}",
-                "User-Agent": "nia-mcp-server/1.0.20",
+                "User-Agent": "nia-mcp-server/1.0.21",
                 "Content-Type": "application/json"
             },
             timeout=720.0  # 12 minute timeout for deep research operations

nia_mcp_server/server.py

@@ -335,18 +335,19 @@ async def search_documentation(
 
     Args:
         query: Natural language search query. Don't just use keywords or unstrctured query, make a comprehensive question to get the best results possible.
-        sources: List of documentation identifiers to search. Can be:
+        sources: List of documentation identifiers to search. Preferred format is UUID, but also supports:
+            - Source UUIDs (e.g., "550e8400-e29b-41d4-a716-446655440000") - RECOMMENDED
             - Display names (e.g., "Vercel AI SDK - Core")
             - URLs (e.g., "https://sdk.vercel.ai/docs")
-            - Source IDs (UUID format for backwards compatibility)
         include_sources: Whether to include source references in results
 
     Returns:
         Search results with relevant documentation excerpts
 
     Important:
-        - You can now use friendly names instead of UUIDs! Try display names or URLs.
-        - If you don't know the identifiers, use `list_documentation` tool to see available options.
+        - UUIDs are the preferred identifier format for best performance
+        - Use `list_documentation` tool to see available sources and their UUIDs
+        - Display names and URLs are also supported for convenience
     """
     try:
         client = await ensure_api_client()
@@ -356,20 +357,17 @@ async def search_documentation(
             return [TextContent(
                 type="text",
                 text="📚 **Please specify which documentation sources to search:**\n\n"
-                     "1. Use `list_documentation` to see available sources\n"
-                     "2. Then call `search_documentation(\"your query\", [\"source1\", \"source2\"])`\n\n"
-                     "**You can use any of these identifier formats:**\n"
+                     "1. Use `list_documentation` to see available sources and their UUIDs\n"
+                     "2. Then call `search_documentation(\"your query\", [\"uuid1\", \"uuid2\"])`\n\n"
+                     "**Supported identifier formats (UUIDs preferred):**\n"
+                     "- UUIDs: `\"550e8400-e29b-41d4-a716-446655440000\"` - RECOMMENDED\n"
                      "- Display names: `\"Vercel AI SDK - Core\"`\n"
-                     "- URLs: `\"https://docs.trynia.ai/\"`\n"
-                     "- UUIDs: `\"550e8400-e29b-41d4-a716-446655440000\"`\n\n"
-                     "**Example:**\n"
+                     "- URLs: `\"https://docs.trynia.ai/\"`\n\n"
+                     "**Example (preferred):**\n"
                      "```\n"
-                     "search_documentation(\"API reference\", [\"Vercel AI SDK - Core\"])\n"
+                     "search_documentation(\"API reference\", [\"550e8400-e29b-41d4-a716-446655440000\"])\n"
                      "```\n\n"
-                     "**📌 Tip:** Mix different identifier types in the same search:\n"
-                     "```\n"
-                     "search_documentation(\"query\", [\"Display Name\", \"https://docs.example.com/\"])\n"
-                     "```"
+                     "**📌 Tip:** UUIDs provide best performance and reliability"
             )]
         
         # Build messages for the query
@@ -847,7 +845,7 @@ async def rename_resource(
         resource_type: Type of resource - "repository" or "documentation"
         identifier:
             - For repository: Repository in owner/repo format (e.g., "facebook/react")
-            - For documentation: Can be display name, URL, or UUID (e.g., "Vercel AI SDK - Core", "https://docs.trynia.ai/", or "doc-id-123")
+            - For documentation: UUID preferred, also supports display name or URL (e.g., "550e8400-e29b-41d4-a716-446655440000", "Vercel AI SDK - Core", or "https://docs.trynia.ai/")
         new_name: New display name for the resource (1-100 characters)
 
     Returns:
@@ -855,7 +853,7 @@ async def rename_resource(
 
     Examples:
         - rename_resource("repository", "facebook/react", "React Framework")
-        - rename_resource("documentation", "Vercel AI SDK - Core", "Python Official Docs")
+        - rename_resource("documentation", "550e8400-e29b-41d4-a716-446655440000", "Python Official Docs")
         - rename_resource("documentation", "https://docs.trynia.ai/", "NIA Documentation")
     """
     try:
@@ -918,14 +916,14 @@ async def delete_resource(
         resource_type: Type of resource - "repository" or "documentation"
         identifier:
             - For repository: Repository in owner/repo format (e.g., "facebook/react")
-            - For documentation: Can be display name, URL, or UUID (e.g., "Vercel AI SDK - Core", "https://docs.trynia.ai/", or "doc-id-123")
+            - For documentation: UUID preferred, also supports display name or URL (e.g., "550e8400-e29b-41d4-a716-446655440000", "Vercel AI SDK - Core", or "https://docs.trynia.ai/")
 
     Returns:
         Confirmation of deletion
 
     Examples:
         - delete_resource("repository", "facebook/react")
-        - delete_resource("documentation", "Vercel AI SDK - Core")
+        - delete_resource("documentation", "550e8400-e29b-41d4-a716-446655440000")
         - delete_resource("documentation", "https://docs.trynia.ai/")
     """
     try:

{nia_mcp_server-1.0.20.dist-info → nia_mcp_server-1.0.21.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: nia-mcp-server
-Version: 1.0.20
+Version: 1.0.21
 Summary: Nia Knowledge Agent
 Project-URL: Homepage, https://trynia.ai
 Project-URL: Documentation, https://docs.trynia.ai

{nia_mcp_server-1.0.20.dist-info → nia_mcp_server-1.0.21.dist-info}/RECORD

@@ -1,19 +1,19 @@
-nia_mcp_server/__init__.py,sha256=43Fw4mFrmz39fC_Bm1vMdF7Cl78hJiEJskqhB1WfLiA,85
+nia_mcp_server/__init__.py,sha256=U4ztjfv89tU3YlGCCf3CKfTS2ZEeFmjpjjSMHRujBVM,85
 nia_mcp_server/__main__.py,sha256=YQSpFtDeKp18r8mKr084cHnRFV4416_EKCu9FTM8_ik,394
-nia_mcp_server/api_client.py,sha256=U5gARDC2p0-MUUDPCLmDtRgRSl-kRNwhDHXWE0n0dgU,35034
+nia_mcp_server/api_client.py,sha256=e-U_RUGCGrC4DfjokIygWiprNQUAHt-stPxpwdsLG4I,35034
 nia_mcp_server/cli.py,sha256=32VSPNIocXtDgVBDZNZsxvj3kytBn54_a1pIE84vOdY,1834
 nia_mcp_server/profiles.py,sha256=2DD8PFRr5Ij4IK4sPUz0mH8aKjkrEtkKLC1R0iki2bA,7221
 nia_mcp_server/project_init.py,sha256=T0-ziJhofL4L8APwnM43BLhxtlmOHaYH-V9PF2yXLw4,7138
 nia_mcp_server/rule_transformer.py,sha256=wCxoQ1Kl_rI9mUFnh9kG5iCXYU4QInrmFQOReZfAFVo,11000
-nia_mcp_server/server.py,sha256=x5RTZ2Yc8VLL2Jeule_hA7o2EEvp7zl5UHLraDWseg4,130570
+nia_mcp_server/server.py,sha256=BWSeAft-9El_nsf-69rDnt1HpUuz5_vB-9MrPHgsbr8,130666
 nia_mcp_server/setup.py,sha256=nJXVY8NHGtWROtoH8DW-3uOgyuPs4F9dW0cNhcbCLrM,5355
 nia_mcp_server/assets/rules/claude_rules.md,sha256=HNL5GJMUbFxSpNbIAJUQWqAywjMl4lf530I1in69aNY,7380
 nia_mcp_server/assets/rules/cursor_rules.md,sha256=hd6lhzNrK1ULQUYIEVeOnyKnuLKq4hmwZPbMqGUI1Lk,1720
 nia_mcp_server/assets/rules/nia_rules.md,sha256=l6sx000uqoczoHYqOPp4hnNgyfpnhvO9NyT0fVx5nU0,8059
 nia_mcp_server/assets/rules/vscode_rules.md,sha256=fqn4aJO_bhftaCGkVoquruQHf3EaREQJQWHXq6a4FOk,6967
 nia_mcp_server/assets/rules/windsurf_rules.md,sha256=PzU2as5gaiVsV6PAzg8T_-GR7VCyRQGMjAHcSzYF_ms,3354
-nia_mcp_server-1.0.20.dist-info/METADATA,sha256=-akLTFU4GDQE-PpDSvfUYN7l8Va6By8KiZqkq371HYg,1324
-nia_mcp_server-1.0.20.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-nia_mcp_server-1.0.20.dist-info/entry_points.txt,sha256=V74FQEp48pfWxPCl7B9mihtqvIJNVjCSbRfCz4ww77I,64
-nia_mcp_server-1.0.20.dist-info/licenses/LICENSE,sha256=IrdVKi3bsiB2MTLM26MltBRpwyNi-8P6Cy0EnmAN76A,1557
-nia_mcp_server-1.0.20.dist-info/RECORD,,
+nia_mcp_server-1.0.21.dist-info/METADATA,sha256=v0nxEs-TwVywd4bN4HbdCHBLI9AgZkq_kmt84-r8J2o,1324
+nia_mcp_server-1.0.21.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+nia_mcp_server-1.0.21.dist-info/entry_points.txt,sha256=V74FQEp48pfWxPCl7B9mihtqvIJNVjCSbRfCz4ww77I,64
+nia_mcp_server-1.0.21.dist-info/licenses/LICENSE,sha256=IrdVKi3bsiB2MTLM26MltBRpwyNi-8P6Cy0EnmAN76A,1557
+nia_mcp_server-1.0.21.dist-info/RECORD,,