gopher-mcp-python 0.1.21__tar.gz → 0.1.30__tar.gz

{gopher_mcp_python-0.1.21 → gopher_mcp_python-0.1.30}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: gopher-mcp-python
-Version: 0.1.21
+Version: 0.1.30
 Summary: Python SDK for Gopher MCP - AI Agent orchestration framework with native performance
 Author-email: Gopher Security <dev@gophersecurity.com>
 License: Apache-2.0
@@ -59,8 +59,16 @@ Python SDK for gopher-mcp-python, providing AI agent orchestration with native C
 ## Requirements
 
 - Python 3.8 or higher
+- `venv` and `pip` for PyPI installation, examples, and development workflows
 - Native gopher-mcp-python library (built from source)
 
+On Debian/Ubuntu, install the Python venv and pip packages before using the
+PyPI install path, running examples, or setting up development dependencies:
+
+```bash
+sudo apt-get install python3 python3-venv python3-pip
+```
+
 ## Installation
 
 ### From Source
@@ -78,7 +86,7 @@ cd gopher-mcp-python
 
 3. Install the Python package:
 ```bash
-pip install -e .
+python3 -m pip install -e .
 ```
 
 ## Quick Start

{gopher_mcp_python-0.1.21 → gopher_mcp_python-0.1.30}/README.md

@@ -15,8 +15,16 @@ Python SDK for gopher-mcp-python, providing AI agent orchestration with native C
 ## Requirements
 
 - Python 3.8 or higher
+- `venv` and `pip` for PyPI installation, examples, and development workflows
 - Native gopher-mcp-python library (built from source)
 
+On Debian/Ubuntu, install the Python venv and pip packages before using the
+PyPI install path, running examples, or setting up development dependencies:
+
+```bash
+sudo apt-get install python3 python3-venv python3-pip
+```
+
 ## Installation
 
 ### From Source
@@ -34,7 +42,7 @@ cd gopher-mcp-python
 
 3. Install the Python package:
 ```bash
-pip install -e .
+python3 -m pip install -e .
 ```
 
 ## Quick Start

gopher_mcp_python-0.1.30/gopher_mcp_python/__init__.py

@@ -0,0 +1,165 @@
+"""
+Gopher Orch Python SDK - AI Agent orchestration framework with native performance.
+
+This module provides Python bindings to the gopher-mcp-python native library through ctypes FFI.
+
+Example:
+    >>> from gopher_mcp_python import GopherAgent, GopherAgentConfig
+    >>>
+    >>> # Create an agent with API key
+    >>> config = (GopherAgentConfig.builder()
+    ...     .provider("AnthropicProvider")
+    ...     .model("claude-3-haiku-20240307")
+    ...     .api_key("your-api-key")
+    ...     .build())
+    >>> agent = GopherAgent.create(config)
+    >>>
+    >>> # Run a query
+    >>> answer = agent.run("What time is it in Tokyo?")
+    >>> print(answer)
+    >>>
+    >>> # Cleanup
+    >>> agent.dispose()
+"""
+
+from gopher_mcp_python.agent import GopherAgent
+from gopher_mcp_python.config import (
+    GopherAgentConfig,
+    GopherAgentConfigBuilder,
+    GopherAgentRuntimeOptions,
+)
+from gopher_mcp_python.result import AgentResult, AgentResultStatus, AgentResultBuilder
+from gopher_mcp_python.errors import (
+    AgentError,
+    ApiKeyError,
+    ConnectionError,
+    TimeoutError,
+)
+from gopher_mcp_python.server_config import ServerConfig
+from gopher_mcp_python.ffi import GopherOrchLibrary, GopherOrchHandle
+
+# Auth module re-exports
+from gopher_mcp_python.ffi.auth import (
+    # Types
+    GopherAuthError,
+    AutoRefreshResult,
+    RegistrationResponse,
+    TokenResponse,
+    ValidationResult,
+    TokenPayload,
+    GopherAuthContext,
+    ERROR_DESCRIPTIONS,
+    get_error_description,
+    gopher_create_empty_auth_context,
+    is_gopher_auth_error,
+    # Classes
+    GopherAuthClient,
+    GopherAuthConfig,
+    GopherOAuthClient,
+    GopherSessionManager,
+    GopherValidationOptions,
+    # Functions
+    gopher_auth_auto_refresh,
+    gopher_auth_build_oidc_discovery_metadata,
+    gopher_auth_build_oauth_server_metadata,
+    gopher_auth_build_protected_resource_metadata,
+    gopher_auth_extract_bearer_token,
+    gopher_auth_extract_method,
+    gopher_auth_extract_path,
+    gopher_auth_url_decode,
+    gopher_auth_url_encode,
+    gopher_auth_validate_all_scopes,
+    gopher_auth_validate_any_scopes,
+    gopher_auth_validate_idp,
+    gopher_create_validation_options,
+    gopher_generate_www_authenticate_header,
+    gopher_generate_www_authenticate_header_v2,
+    gopher_get_auth_library_version,
+    gopher_init_auth_library,
+    gopher_is_auth_library_initialized,
+    gopher_shutdown_auth_library,
+    is_auth_available,
+)
+from gopher_mcp_python.auth import (
+    GopherAuth,
+    GopherAuthError as GopherAuthBaseError,
+    ConfigurationError,
+    InsufficientScopesError,
+    JwksError,
+    TokenExchangeError,
+    TokenValidationError,
+    has_all_scopes,
+    has_any_scope,
+    has_scope,
+)
+
+__version__ = "0.1.30"
+
+__all__ = [
+    # Main classes
+    "GopherAgent",
+    "GopherAgentConfig",
+    "GopherAgentConfigBuilder",
+    "GopherAgentRuntimeOptions",
+    "AgentResult",
+    "AgentResultStatus",
+    "AgentResultBuilder",
+    "ServerConfig",
+    # Errors
+    "AgentError",
+    "ApiKeyError",
+    "ConnectionError",
+    "TimeoutError",
+    # FFI
+    "GopherOrchLibrary",
+    "GopherOrchHandle",
+    # Auth
+    "GopherAuthError",
+    "AutoRefreshResult",
+    "RegistrationResponse",
+    "TokenResponse",
+    "ValidationResult",
+    "TokenPayload",
+    "GopherAuthContext",
+    "ERROR_DESCRIPTIONS",
+    "get_error_description",
+    "gopher_create_empty_auth_context",
+    "is_gopher_auth_error",
+    "GopherAuthClient",
+    "GopherAuthConfig",
+    "GopherOAuthClient",
+    "GopherSessionManager",
+    "GopherValidationOptions",
+    "gopher_auth_auto_refresh",
+    "gopher_auth_build_oidc_discovery_metadata",
+    "gopher_auth_build_oauth_server_metadata",
+    "gopher_auth_build_protected_resource_metadata",
+    "gopher_auth_extract_bearer_token",
+    "gopher_auth_extract_method",
+    "gopher_auth_extract_path",
+    "gopher_auth_url_decode",
+    "gopher_auth_url_encode",
+    "gopher_auth_validate_all_scopes",
+    "gopher_auth_validate_any_scopes",
+    "gopher_auth_validate_idp",
+    "gopher_create_validation_options",
+    "gopher_generate_www_authenticate_header",
+    "gopher_generate_www_authenticate_header_v2",
+    "gopher_get_auth_library_version",
+    "gopher_init_auth_library",
+    "gopher_is_auth_library_initialized",
+    "gopher_shutdown_auth_library",
+    "is_auth_available",
+    "GopherAuth",
+    "GopherAuthBaseError",
+    "ConfigurationError",
+    "InsufficientScopesError",
+    "JwksError",
+    "TokenExchangeError",
+    "TokenValidationError",
+    "has_all_scopes",
+    "has_any_scope",
+    "has_scope",
+    # Version
+    "__version__",
+]