hackagent 0.3.1__py3-none-any.whl

hackagent/models/result_request.py

@@ -0,0 +1,232 @@
+from collections.abc import Mapping
+from typing import Any, TypeVar, Union, cast
+from uuid import UUID
+
+from attrs import define as _attrs_define
+from attrs import field as _attrs_field
+
+from ..models.evaluation_status_enum import EvaluationStatusEnum
+from ..types import UNSET, Unset
+
+T = TypeVar("T", bound="ResultRequest")
+
+
+@_attrs_define
+class ResultRequest:
+    """Serializer for the Result model, often nested in RunSerializer.
+
+    Attributes:
+        run (UUID):
+        prompt (Union[None, UUID, Unset]):
+        request_payload (Union[Unset, Any]): Payload sent to agent or relevant data for client-submitted results.
+        response_status_code (Union[None, Unset, int]):
+        response_headers (Union[Unset, Any]):
+        response_body (Union[None, Unset, str]):
+        latency_ms (Union[None, Unset, int]):
+        detected_tool_calls (Union[Unset, Any]):
+        evaluation_status (Union[Unset, EvaluationStatusEnum]): * `NOT_EVALUATED` - Not Evaluated
+            * `SUCCESSFUL_JAILBREAK` - Successful Jailbreak
+            * `FAILED_JAILBREAK` - Failed Jailbreak (Mitigated/Refused)
+            * `ERROR_AGENT_RESPONSE` - Error in Agent Response
+            * `ERROR_TEST_FRAMEWORK` - Error in Test Framework
+            * `PASSED_CRITERIA` - Passed Criteria (Not Jailbreak)
+            * `FAILED_CRITERIA` - Failed Criteria (Not Jailbreak)
+        evaluation_notes (Union[Unset, str]):
+        evaluation_metrics (Union[Unset, Any]):
+        agent_specific_data (Union[Unset, Any]):
+    """
+
+    run: UUID
+    prompt: Union[None, UUID, Unset] = UNSET
+    request_payload: Union[Unset, Any] = UNSET
+    response_status_code: Union[None, Unset, int] = UNSET
+    response_headers: Union[Unset, Any] = UNSET
+    response_body: Union[None, Unset, str] = UNSET
+    latency_ms: Union[None, Unset, int] = UNSET
+    detected_tool_calls: Union[Unset, Any] = UNSET
+    evaluation_status: Union[Unset, EvaluationStatusEnum] = UNSET
+    evaluation_notes: Union[Unset, str] = UNSET
+    evaluation_metrics: Union[Unset, Any] = UNSET
+    agent_specific_data: Union[Unset, Any] = UNSET
+    additional_properties: dict[str, Any] = _attrs_field(init=False, factory=dict)
+
+    def to_dict(self) -> dict[str, Any]:
+        run = str(self.run)
+
+        prompt: Union[None, Unset, str]
+        if isinstance(self.prompt, Unset):
+            prompt = UNSET
+        elif isinstance(self.prompt, UUID):
+            prompt = str(self.prompt)
+        else:
+            prompt = self.prompt
+
+        request_payload = self.request_payload
+
+        response_status_code: Union[None, Unset, int]
+        if isinstance(self.response_status_code, Unset):
+            response_status_code = UNSET
+        else:
+            response_status_code = self.response_status_code
+
+        response_headers = self.response_headers
+
+        response_body: Union[None, Unset, str]
+        if isinstance(self.response_body, Unset):
+            response_body = UNSET
+        else:
+            response_body = self.response_body
+
+        latency_ms: Union[None, Unset, int]
+        if isinstance(self.latency_ms, Unset):
+            latency_ms = UNSET
+        else:
+            latency_ms = self.latency_ms
+
+        detected_tool_calls = self.detected_tool_calls
+
+        evaluation_status: Union[Unset, str] = UNSET
+        if not isinstance(self.evaluation_status, Unset):
+            evaluation_status = self.evaluation_status.value
+
+        evaluation_notes = self.evaluation_notes
+
+        evaluation_metrics = self.evaluation_metrics
+
+        agent_specific_data = self.agent_specific_data
+
+        field_dict: dict[str, Any] = {}
+        field_dict.update(self.additional_properties)
+        field_dict.update(
+            {
+                "run": run,
+            }
+        )
+        if prompt is not UNSET:
+            field_dict["prompt"] = prompt
+        if request_payload is not UNSET:
+            field_dict["request_payload"] = request_payload
+        if response_status_code is not UNSET:
+            field_dict["response_status_code"] = response_status_code
+        if response_headers is not UNSET:
+            field_dict["response_headers"] = response_headers
+        if response_body is not UNSET:
+            field_dict["response_body"] = response_body
+        if latency_ms is not UNSET:
+            field_dict["latency_ms"] = latency_ms
+        if detected_tool_calls is not UNSET:
+            field_dict["detected_tool_calls"] = detected_tool_calls
+        if evaluation_status is not UNSET:
+            field_dict["evaluation_status"] = evaluation_status
+        if evaluation_notes is not UNSET:
+            field_dict["evaluation_notes"] = evaluation_notes
+        if evaluation_metrics is not UNSET:
+            field_dict["evaluation_metrics"] = evaluation_metrics
+        if agent_specific_data is not UNSET:
+            field_dict["agent_specific_data"] = agent_specific_data
+
+        return field_dict
+
+    @classmethod
+    def from_dict(cls: type[T], src_dict: Mapping[str, Any]) -> T:
+        d = dict(src_dict)
+        run = UUID(d.pop("run"))
+
+        def _parse_prompt(data: object) -> Union[None, UUID, Unset]:
+            if data is None:
+                return data
+            if isinstance(data, Unset):
+                return data
+            try:
+                if not isinstance(data, str):
+                    raise TypeError()
+                prompt_type_0 = UUID(data)
+
+                return prompt_type_0
+            except:  # noqa: E722
+                pass
+            return cast(Union[None, UUID, Unset], data)
+
+        prompt = _parse_prompt(d.pop("prompt", UNSET))
+
+        request_payload = d.pop("request_payload", UNSET)
+
+        def _parse_response_status_code(data: object) -> Union[None, Unset, int]:
+            if data is None:
+                return data
+            if isinstance(data, Unset):
+                return data
+            return cast(Union[None, Unset, int], data)
+
+        response_status_code = _parse_response_status_code(
+            d.pop("response_status_code", UNSET)
+        )
+
+        response_headers = d.pop("response_headers", UNSET)
+
+        def _parse_response_body(data: object) -> Union[None, Unset, str]:
+            if data is None:
+                return data
+            if isinstance(data, Unset):
+                return data
+            return cast(Union[None, Unset, str], data)
+
+        response_body = _parse_response_body(d.pop("response_body", UNSET))
+
+        def _parse_latency_ms(data: object) -> Union[None, Unset, int]:
+            if data is None:
+                return data
+            if isinstance(data, Unset):
+                return data
+            return cast(Union[None, Unset, int], data)
+
+        latency_ms = _parse_latency_ms(d.pop("latency_ms", UNSET))
+
+        detected_tool_calls = d.pop("detected_tool_calls", UNSET)
+
+        _evaluation_status = d.pop("evaluation_status", UNSET)
+        evaluation_status: Union[Unset, EvaluationStatusEnum]
+        if isinstance(_evaluation_status, Unset):
+            evaluation_status = UNSET
+        else:
+            evaluation_status = EvaluationStatusEnum(_evaluation_status)
+
+        evaluation_notes = d.pop("evaluation_notes", UNSET)
+
+        evaluation_metrics = d.pop("evaluation_metrics", UNSET)
+
+        agent_specific_data = d.pop("agent_specific_data", UNSET)
+
+        result_request = cls(
+            run=run,
+            prompt=prompt,
+            request_payload=request_payload,
+            response_status_code=response_status_code,
+            response_headers=response_headers,
+            response_body=response_body,
+            latency_ms=latency_ms,
+            detected_tool_calls=detected_tool_calls,
+            evaluation_status=evaluation_status,
+            evaluation_notes=evaluation_notes,
+            evaluation_metrics=evaluation_metrics,
+            agent_specific_data=agent_specific_data,
+        )
+
+        result_request.additional_properties = d
+        return result_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/models/run.py

@@ -0,0 +1,233 @@
+import datetime
+from collections.abc import Mapping
+from typing import TYPE_CHECKING, Any, TypeVar, Union, cast
+from uuid import UUID
+
+from attrs import define as _attrs_define
+from attrs import field as _attrs_field
+from dateutil.parser import isoparse
+
+from ..models.status_enum import StatusEnum
+from ..types import UNSET, Unset
+
+if TYPE_CHECKING:
+    from ..models.result import Result
+
+
+T = TypeVar("T", bound="Run")
+
+
+@_attrs_define
+class Run:
+    """Serializer for the Run model, used for both input and output.
+
+    Attributes:
+        id (UUID):
+        agent (UUID):
+        agent_name (str):
+        owner (Union[None, int]):
+        owner_username (Union[None, str]):
+        organization (UUID):
+        organization_name (str):
+        timestamp (datetime.datetime):
+        is_client_executed (bool): Indicates if the run was initiated via an Attack by a client application.
+        results (list['Result']):
+        attack (Union[None, UUID, Unset]): The Attack this run is an instance of, if applicable.
+        run_config (Union[Unset, Any]): JSON containing specific settings for this run. If linked to an Attack, this
+            might be a copy or subset of its configuration.
+        status (Union[Unset, StatusEnum]): * `PENDING` - Pending
+            * `RUNNING` - Running
+            * `COMPLETED` - Completed
+            * `FAILED` - Failed
+            * `CANCELLED` - Cancelled
+        run_notes (Union[Unset, str]):
+    """
+
+    id: UUID
+    agent: UUID
+    agent_name: str
+    owner: Union[None, int]
+    owner_username: Union[None, str]
+    organization: UUID
+    organization_name: str
+    timestamp: datetime.datetime
+    is_client_executed: bool
+    results: list["Result"]
+    attack: Union[None, UUID, Unset] = UNSET
+    run_config: Union[Unset, Any] = UNSET
+    status: Union[Unset, StatusEnum] = UNSET
+    run_notes: Union[Unset, str] = UNSET
+    additional_properties: dict[str, Any] = _attrs_field(init=False, factory=dict)
+
+    def to_dict(self) -> dict[str, Any]:
+        id = str(self.id)
+
+        agent = str(self.agent)
+
+        agent_name = self.agent_name
+
+        owner: Union[None, int]
+        owner = self.owner
+
+        owner_username: Union[None, str]
+        owner_username = self.owner_username
+
+        organization = str(self.organization)
+
+        organization_name = self.organization_name
+
+        timestamp = self.timestamp.isoformat()
+
+        is_client_executed = self.is_client_executed
+
+        results = []
+        for results_item_data in self.results:
+            results_item = results_item_data.to_dict()
+            results.append(results_item)
+
+        attack: Union[None, Unset, str]
+        if isinstance(self.attack, Unset):
+            attack = UNSET
+        elif isinstance(self.attack, UUID):
+            attack = str(self.attack)
+        else:
+            attack = self.attack
+
+        run_config = self.run_config
+
+        status: Union[Unset, str] = UNSET
+        if not isinstance(self.status, Unset):
+            status = self.status.value
+
+        run_notes = self.run_notes
+
+        field_dict: dict[str, Any] = {}
+        field_dict.update(self.additional_properties)
+        field_dict.update(
+            {
+                "id": id,
+                "agent": agent,
+                "agent_name": agent_name,
+                "owner": owner,
+                "owner_username": owner_username,
+                "organization": organization,
+                "organization_name": organization_name,
+                "timestamp": timestamp,
+                "is_client_executed": is_client_executed,
+                "results": results,
+            }
+        )
+        if attack is not UNSET:
+            field_dict["attack"] = attack
+        if run_config is not UNSET:
+            field_dict["run_config"] = run_config
+        if status is not UNSET:
+            field_dict["status"] = status
+        if run_notes is not UNSET:
+            field_dict["run_notes"] = run_notes
+
+        return field_dict
+
+    @classmethod
+    def from_dict(cls: type[T], src_dict: Mapping[str, Any]) -> T:
+        from ..models.result import Result
+
+        d = dict(src_dict)
+        id = UUID(d.pop("id"))
+
+        agent = UUID(d.pop("agent"))
+
+        agent_name = d.pop("agent_name")
+
+        def _parse_owner(data: object) -> Union[None, int]:
+            if data is None:
+                return data
+            return cast(Union[None, int], data)
+
+        owner = _parse_owner(d.pop("owner"))
+
+        def _parse_owner_username(data: object) -> Union[None, str]:
+            if data is None:
+                return data
+            return cast(Union[None, str], data)
+
+        owner_username = _parse_owner_username(d.pop("owner_username"))
+
+        organization = UUID(d.pop("organization"))
+
+        organization_name = d.pop("organization_name")
+
+        timestamp = isoparse(d.pop("timestamp"))
+
+        is_client_executed = d.pop("is_client_executed")
+
+        results = []
+        _results = d.pop("results")
+        for results_item_data in _results:
+            results_item = Result.from_dict(results_item_data)
+
+            results.append(results_item)
+
+        def _parse_attack(data: object) -> Union[None, UUID, Unset]:
+            if data is None:
+                return data
+            if isinstance(data, Unset):
+                return data
+            try:
+                if not isinstance(data, str):
+                    raise TypeError()
+                attack_type_0 = UUID(data)
+
+                return attack_type_0
+            except:  # noqa: E722
+                pass
+            return cast(Union[None, UUID, Unset], data)
+
+        attack = _parse_attack(d.pop("attack", UNSET))
+
+        run_config = d.pop("run_config", UNSET)
+
+        _status = d.pop("status", UNSET)
+        status: Union[Unset, StatusEnum]
+        if isinstance(_status, Unset):
+            status = UNSET
+        else:
+            status = StatusEnum(_status)
+
+        run_notes = d.pop("run_notes", UNSET)
+
+        run = cls(
+            id=id,
+            agent=agent,
+            agent_name=agent_name,
+            owner=owner,
+            owner_username=owner_username,
+            organization=organization,
+            organization_name=organization_name,
+            timestamp=timestamp,
+            is_client_executed=is_client_executed,
+            results=results,
+            attack=attack,
+            run_config=run_config,
+            status=status,
+            run_notes=run_notes,
+        )
+
+        run.additional_properties = d
+        return run
+
+    @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/run_list_status.py

@@ -0,0 +1,12 @@
+from enum import Enum
+
+
+class RunListStatus(str, Enum):
+    CANCELLED = "CANCELLED"
+    COMPLETED = "COMPLETED"
+    FAILED = "FAILED"
+    PENDING = "PENDING"
+    RUNNING = "RUNNING"
+
+    def __str__(self) -> str:
+        return str(self.value)

hackagent/models/run_request.py

@@ -0,0 +1,133 @@
+from collections.abc import Mapping
+from typing import Any, TypeVar, Union, cast
+from uuid import UUID
+
+from attrs import define as _attrs_define
+from attrs import field as _attrs_field
+
+from ..models.status_enum import StatusEnum
+from ..types import UNSET, Unset
+
+T = TypeVar("T", bound="RunRequest")
+
+
+@_attrs_define
+class RunRequest:
+    """Serializer for the Run model, used for both input and output.
+
+    Attributes:
+        agent (UUID):
+        attack (Union[None, UUID, Unset]): The Attack this run is an instance of, if applicable.
+        run_config (Union[Unset, Any]): JSON containing specific settings for this run. If linked to an Attack, this
+            might be a copy or subset of its configuration.
+        status (Union[Unset, StatusEnum]): * `PENDING` - Pending
+            * `RUNNING` - Running
+            * `COMPLETED` - Completed
+            * `FAILED` - Failed
+            * `CANCELLED` - Cancelled
+        run_notes (Union[Unset, str]):
+    """
+
+    agent: UUID
+    attack: Union[None, UUID, Unset] = UNSET
+    run_config: Union[Unset, Any] = UNSET
+    status: Union[Unset, StatusEnum] = UNSET
+    run_notes: Union[Unset, str] = UNSET
+    additional_properties: dict[str, Any] = _attrs_field(init=False, factory=dict)
+
+    def to_dict(self) -> dict[str, Any]:
+        agent = str(self.agent)
+
+        attack: Union[None, Unset, str]
+        if isinstance(self.attack, Unset):
+            attack = UNSET
+        elif isinstance(self.attack, UUID):
+            attack = str(self.attack)
+        else:
+            attack = self.attack
+
+        run_config = self.run_config
+
+        status: Union[Unset, str] = UNSET
+        if not isinstance(self.status, Unset):
+            status = self.status.value
+
+        run_notes = self.run_notes
+
+        field_dict: dict[str, Any] = {}
+        field_dict.update(self.additional_properties)
+        field_dict.update(
+            {
+                "agent": agent,
+            }
+        )
+        if attack is not UNSET:
+            field_dict["attack"] = attack
+        if run_config is not UNSET:
+            field_dict["run_config"] = run_config
+        if status is not UNSET:
+            field_dict["status"] = status
+        if run_notes is not UNSET:
+            field_dict["run_notes"] = run_notes
+
+        return field_dict
+
+    @classmethod
+    def from_dict(cls: type[T], src_dict: Mapping[str, Any]) -> T:
+        d = dict(src_dict)
+        agent = UUID(d.pop("agent"))
+
+        def _parse_attack(data: object) -> Union[None, UUID, Unset]:
+            if data is None:
+                return data
+            if isinstance(data, Unset):
+                return data
+            try:
+                if not isinstance(data, str):
+                    raise TypeError()
+                attack_type_0 = UUID(data)
+
+                return attack_type_0
+            except:  # noqa: E722
+                pass
+            return cast(Union[None, UUID, Unset], data)
+
+        attack = _parse_attack(d.pop("attack", UNSET))
+
+        run_config = d.pop("run_config", UNSET)
+
+        _status = d.pop("status", UNSET)
+        status: Union[Unset, StatusEnum]
+        if isinstance(_status, Unset):
+            status = UNSET
+        else:
+            status = StatusEnum(_status)
+
+        run_notes = d.pop("run_notes", UNSET)
+
+        run_request = cls(
+            agent=agent,
+            attack=attack,
+            run_config=run_config,
+            status=status,
+            run_notes=run_notes,
+        )
+
+        run_request.additional_properties = d
+        return run_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/models/status_enum.py

@@ -0,0 +1,12 @@
+from enum import Enum
+
+
+class StatusEnum(str, Enum):
+    CANCELLED = "CANCELLED"
+    COMPLETED = "COMPLETED"
+    FAILED = "FAILED"
+    PENDING = "PENDING"
+    RUNNING = "RUNNING"
+
+    def __str__(self) -> str:
+        return str(self.value)

hackagent/models/step_type_enum.py

@@ -0,0 +1,14 @@
+from enum import Enum
+
+
+class StepTypeEnum(str, Enum):
+    A2A_COMM = "A2A_COMM"
+    AGENT_RESPONSE_CHUNK = "AGENT_RESPONSE_CHUNK"
+    AGENT_THOUGHT = "AGENT_THOUGHT"
+    MCP_STEP = "MCP_STEP"
+    OTHER = "OTHER"
+    TOOL_CALL = "TOOL_CALL"
+    TOOL_RESPONSE = "TOOL_RESPONSE"
+
+    def __str__(self) -> str:
+        return str(self.value)