hackagent 0.3.1__py3-none-any.whl

hackagent/models/user_profile_minimal.py

@@ -0,0 +1,76 @@
+from collections.abc import Mapping
+from typing import Any, TypeVar
+from uuid import UUID
+
+from attrs import define as _attrs_define
+from attrs import field as _attrs_field
+
+T = TypeVar("T", bound="UserProfileMinimal")
+
+
+@_attrs_define
+class UserProfileMinimal:
+    """
+    Attributes:
+        user (int):
+        username (str):
+        organization (UUID):
+    """
+
+    user: int
+    username: str
+    organization: UUID
+    additional_properties: dict[str, Any] = _attrs_field(init=False, factory=dict)
+
+    def to_dict(self) -> dict[str, Any]:
+        user = self.user
+
+        username = self.username
+
+        organization = str(self.organization)
+
+        field_dict: dict[str, Any] = {}
+        field_dict.update(self.additional_properties)
+        field_dict.update(
+            {
+                "user": user,
+                "username": username,
+                "organization": organization,
+            }
+        )
+
+        return field_dict
+
+    @classmethod
+    def from_dict(cls: type[T], src_dict: Mapping[str, Any]) -> T:
+        d = dict(src_dict)
+        user = d.pop("user")
+
+        username = d.pop("username")
+
+        organization = UUID(d.pop("organization"))
+
+        user_profile_minimal = cls(
+            user=user,
+            username=username,
+            organization=organization,
+        )
+
+        user_profile_minimal.additional_properties = d
+        return user_profile_minimal
+
+    @property
+    def additional_keys(self) -> list[str]:
+        return list(self.additional_properties.keys())
+
+    def __getitem__(self, key: str) -> Any:
+        return self.additional_properties[key]
+
+    def __setitem__(self, key: str, value: Any) -> None:
+        self.additional_properties[key] = value
+
+    def __delitem__(self, key: str) -> None:
+        del self.additional_properties[key]
+
+    def __contains__(self, key: str) -> bool:
+        return key in self.additional_properties

hackagent/models/user_profile_request.py

@@ -0,0 +1,99 @@
+from collections.abc import Mapping
+from typing import Any, TypeVar, Union
+
+from attrs import define as _attrs_define
+from attrs import field as _attrs_field
+
+from .. import types
+from ..types import UNSET, Unset
+
+T = TypeVar("T", bound="UserProfileRequest")
+
+
+@_attrs_define
+class UserProfileRequest:
+    """
+    Attributes:
+        email (Union[Unset, str]):
+        first_name (Union[Unset, str]):
+        last_name (Union[Unset, str]):
+    """
+
+    email: Union[Unset, str] = UNSET
+    first_name: Union[Unset, str] = UNSET
+    last_name: Union[Unset, str] = UNSET
+    additional_properties: dict[str, Any] = _attrs_field(init=False, factory=dict)
+
+    def to_dict(self) -> dict[str, Any]:
+        email = self.email
+
+        first_name = self.first_name
+
+        last_name = self.last_name
+
+        field_dict: dict[str, Any] = {}
+        field_dict.update(self.additional_properties)
+        field_dict.update({})
+        if email is not UNSET:
+            field_dict["email"] = email
+        if first_name is not UNSET:
+            field_dict["first_name"] = first_name
+        if last_name is not UNSET:
+            field_dict["last_name"] = last_name
+
+        return field_dict
+
+    def to_multipart(self) -> types.RequestFiles:
+        files: types.RequestFiles = []
+
+        if not isinstance(self.email, Unset):
+            files.append(("email", (None, str(self.email).encode(), "text/plain")))
+
+        if not isinstance(self.first_name, Unset):
+            files.append(
+                ("first_name", (None, str(self.first_name).encode(), "text/plain"))
+            )
+
+        if not isinstance(self.last_name, Unset):
+            files.append(
+                ("last_name", (None, str(self.last_name).encode(), "text/plain"))
+            )
+
+        for prop_name, prop in self.additional_properties.items():
+            files.append((prop_name, (None, str(prop).encode(), "text/plain")))
+
+        return files
+
+    @classmethod
+    def from_dict(cls: type[T], src_dict: Mapping[str, Any]) -> T:
+        d = dict(src_dict)
+        email = d.pop("email", UNSET)
+
+        first_name = d.pop("first_name", UNSET)
+
+        last_name = d.pop("last_name", UNSET)
+
+        user_profile_request = cls(
+            email=email,
+            first_name=first_name,
+            last_name=last_name,
+        )
+
+        user_profile_request.additional_properties = d
+        return user_profile_request
+
+    @property
+    def additional_keys(self) -> list[str]:
+        return list(self.additional_properties.keys())
+
+    def __getitem__(self, key: str) -> Any:
+        return self.additional_properties[key]
+
+    def __setitem__(self, key: str, value: Any) -> None:
+        self.additional_properties[key] = value
+
+    def __delitem__(self, key: str) -> None:
+        del self.additional_properties[key]
+
+    def __contains__(self, key: str) -> bool:
+        return key in self.additional_properties

hackagent/router/__init__.py

@@ -0,0 +1,25 @@
+# Copyright 2025 - AI4I. All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Main router logic for dispatching requests to appropriate agent adapters."""
+
+from .adapters import (
+    ADKAgentAdapter,
+)  # This makes it easy to access adapters via router module
+from .router import AgentRouter
+
+__all__ = [
+    "AgentRouter",
+    "ADKAgentAdapter",  # Exporting specific adapters for convenience
+]

hackagent/router/adapters/__init__.py

@@ -0,0 +1,20 @@
+# Copyright 2025 - AI4I. All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from .google_adk import ADKAgentAdapter  # noqa F401
+from .litellm_adapter import LiteLLMAgentAdapter  # noqa F401
+from .openai_adapter import OpenAIAgentAdapter  # noqa F401
+from .base import Agent  # Added re-export
+
+__all__ = ["ADKAgentAdapter", "LiteLLMAgentAdapter", "OpenAIAgentAdapter", "Agent"]

hackagent/router/adapters/base.py

@@ -0,0 +1,63 @@
+# Copyright 2025 - AI4I. All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+from abc import ABC, abstractmethod
+from typing import Any, Dict
+
+
+class Agent(ABC):
+    """
+    Abstract Base Class for all agent implementations.
+    It defines a common interface for the router to interact with various agents.
+    """
+
+    @abstractmethod
+    def __init__(self, id: str, config: Dict[str, Any]):
+        """
+        Initializes the agent.
+
+        Args:
+            id: A unique identifier for this specific agent instance or type.
+            config: Configuration specific to this agent (e.g., API keys, model names).
+        """
+        self.id = id
+        self.config = config
+        pass
+
+    @abstractmethod
+    def handle_request(self, request_data: Dict[str, Any]) -> Dict[str, Any]:
+        """
+        Processes an incoming request and returns a standardized response.
+        The response should be suitable for storage via the API and should ideally
+        include enough information to reconstruct the interaction.
+
+        Args:
+            request_data: The data for the agent to process. This might include
+                          the prompt, session information, user details, etc.
+
+        Returns:
+            A dictionary containing the standardized response. This could include:
+            - 'raw_request': The original request sent to the underlying agent.
+            - 'raw_response': The original response received from the underlying agent.
+            - 'processed_response': The key information extracted/processed from the raw response.
+            - 'status_code': If applicable, the HTTP status code of the interaction.
+            - 'error_message': Any error message encountered.
+            - 'metadata': Any other relevant metadata.
+        """
+        pass
+
+    def get_identifier(self) -> str:
+        """Returns the unique identifier for this agent instance or type."""
+        return self.id