feat: add auth_tools support to text plugin

- Add auth_tools field to TextCallTemplate for OpenAPI-generated tools
- Pass auth_tools to OpenApiConverter when processing local OpenAPI specs
- Update documentation to reflect new authentication capabilities
- Add test coverage for auth_tools functionality
- Maintains backward compatibility (auth_tools is optional)

This allows text plugin to apply authentication to tools generated from
local OpenAPI specifications, enabling secure API calls while keeping
file access authentication-free.

Author: perrozzi

README.md

@@ -479,7 +479,13 @@ Note the name change from `http_stream` to `streamable_http`.
   "name": "my_text_manual",
   "call_template_type": "text", // Required
   "file_path": "./manuals/my_manual.json", // Required
-  "auth": null // Optional (always null for Text)
+  "auth": null, // Optional (always null for Text)
+  "auth_tools": { // Optional, authentication for generated tools from OpenAPI specs
+    "auth_type": "api_key",
+    "api_key": "Bearer ${API_TOKEN}",
+    "var_name": "Authorization",
+    "location": "header"
+  }
 }
 ```
 

plugins/communication_protocols/text/README.md

@@ -8,9 +8,11 @@ A simple, file-based resource plugin for UTCP. This plugin allows you to define
 
 - **Local File Content**: Define tools that read and return the content of local files.
 - **UTCP Manual Discovery**: Load tool definitions from local UTCP manual files in JSON or YAML format.
+- **OpenAPI Support**: Automatically converts local OpenAPI specs to UTCP tools with optional authentication.
 - **Static & Simple**: Ideal for returning mock data, configuration, or any static text content from a file.
 - **Version Control**: Tool definitions and their corresponding content files can be versioned with your code.
-- **No Authentication**: Designed for simple, local file access without authentication.
+- **No File Authentication**: Designed for simple, local file access without authentication for file reading.
+- **Tool Authentication**: Supports authentication for generated tools from OpenAPI specs via `auth_tools`.
 
 ## Installation
 

plugins/communication_protocols/text/src/utcp_text/text_call_template.py

@@ -1,7 +1,8 @@
-from typing import Literal
+from typing import Literal, Optional
 from pydantic import Field
 
 from utcp.data.call_template import CallTemplate
+from utcp.data.auth import Auth
 from utcp.interfaces.serializer import Serializer
 from utcp.exceptions import UtcpSerializerValidationError
 import traceback
@@ -16,12 +17,14 @@ class TextCallTemplate(CallTemplate):
     Attributes:
         call_template_type: Always "text" for text file call templates.
         file_path: Path to the file containing the UTCP manual or tool definitions.
-        auth: Always None - text call templates don't support authentication.
+        auth: Always None - text call templates don't support authentication for file access.
+        auth_tools: Optional authentication to apply to generated tools from OpenAPI specs.
     """
 
     call_template_type: Literal["text"] = "text"
     file_path: str = Field(..., description="The path to the file containing the UTCP manual or tool definitions.")
     auth: None = None
+    auth_tools: Optional[Auth] = Field(None, description="Authentication to apply to generated tools from OpenAPI specs.")
 
 
 class TextCallTemplateSerializer(Serializer[TextCallTemplate]):

plugins/communication_protocols/text/src/utcp_text/text_communication_protocol.py

@@ -70,7 +70,12 @@ async def register_manual(self, caller: 'UtcpClient', manual_call_template: Call
             utcp_manual: UtcpManual
             if isinstance(data, dict) and ("openapi" in data or "swagger" in data or "paths" in data):
                 self._log_info("Detected OpenAPI specification. Converting to UTCP manual.")
-                converter = OpenApiConverter(data, spec_url=file_path.as_uri(), call_template_name=manual_call_template.name)
+                converter = OpenApiConverter(
+                    data, 
+                    spec_url=file_path.as_uri(), 
+                    call_template_name=manual_call_template.name,
+                    auth_tools=manual_call_template.auth_tools
+                )
                 utcp_manual = converter.convert()
             else:
                 # Try to validate as UTCP manual directly

plugins/communication_protocols/text/tests/test_text_communication_protocol.py

@@ -12,6 +12,7 @@
 from utcp_text.text_call_template import TextCallTemplate
 from utcp.data.call_template import CallTemplate
 from utcp.data.register_manual_response import RegisterManualResult
+from utcp.data.auth_implementations.api_key_auth import ApiKeyAuth
 from utcp.utcp_client import UtcpClient
 
 @pytest_asyncio.fixture
@@ -356,3 +357,18 @@ async def test_call_tool_streaming(text_protocol: TextCommunicationProtocol, sam
         assert chunks == [content]
     finally:
         Path(temp_file).unlink()
+
+
+@pytest.mark.asyncio
+async def test_text_call_template_with_auth_tools():
+    """Test that TextCallTemplate can be created with auth_tools."""
+    auth_tools = ApiKeyAuth(api_key="test-key", var_name="Authorization", location="header")
+    
+    template = TextCallTemplate(
+        name="test-template",
+        file_path="test.json",
+        auth_tools=auth_tools
+    )
+    
+    assert template.auth_tools == auth_tools
+    assert template.auth is None  # auth should still be None for file access