hap.types

Submodules

• hap.types.agents
• hap.types.aliases
• hap.types.engines
• hap.types.graphs
• hap.types.nodes
• hap.types.protocol
• hap.types.schemas

Attributes

AgentId
Entrypoint
JSONMap

Classes

AgentExecutionRequest	Request to execute an agent with validation.
AgentExecutionResult	Result from agent execution with validation.
AgentInfo	Agent metadata for HAP with enhanced validation.
BaseInfo	Base class for all HAP info types.
EdgeInfo	Graph edge metadata with validation.
ErrorCode	Standard error codes.
ExecutionStatus	Agent execution status values.
GraphExecutionRequest	Request to execute a graph with validation.
GraphExecutionResult	Result from graph execution with validation.
GraphExecutionStatus	Graph execution status values.
GraphInfo	Graph metadata for HAP with validation.
HAPError	Error structure for HAP protocol with enhanced validation.
HAPRequest	Base request structure for HAP protocol with JSON-RPC 2.0 compliance.
HAPResponse	Base response structure for HAP protocol with validation.
NodeInfo	Graph node metadata with validation.
NodeType	Graph node types.
PromptArgument	Prompt argument definition with validation.
PromptInfo	Prompt metadata with enhanced validation.
ResourceInfo	Resource metadata with validation.
ServerCapability	Server capabilities.
ServerRegistration	Registration info for a HAP server.
ToolInfo	Tool metadata with enhanced validation.

Package Contents

class hap.types.AgentExecutionRequest(/, **data: Any)

Bases: pydantic.BaseModel

Request to execute an agent with validation.

Parameters:

data (Any)

config_overrides: Dict[str, Any] | None = None

input_data: Dict[str, Any] = None

metadata: Dict[str, Any] = None

model_config

Configuration for the model, should be a dictionary conforming to [ConfigDict][pydantic.config.ConfigDict].

stream: bool = None

timeout: float | None = None

class hap.types.AgentExecutionResult(/, **data: Any)

Bases: pydantic.BaseModel

Result from agent execution with validation.

Parameters:

data (Any)

validate_result_consistency() → AgentExecutionResult

Ensure result/error fields are consistent with status.

Return type:

AgentExecutionResult

error: str | None = None

execution_time: float = None

metadata: Dict[str, Any] = None

model_config

Configuration for the model, should be a dictionary conforming to [ConfigDict][pydantic.config.ConfigDict].

result: Any | None = None

status: ExecutionStatus = None

class hap.types.AgentInfo(/, **data: Any)

Bases: BaseInfo

Agent metadata for HAP with enhanced validation.

Parameters:

data (Any)

classmethod validate_capabilities(v: List[str]) → List[str]

Validate capability names.

Parameters:

v (List[str])

Return type:

List[str]

classmethod validate_tool_names(v: List[str]) → List[str]

Validate tool names format.

Parameters:

v (List[str])

Return type:

List[str]

capabilities: List[str] = None

model_config

Configuration for the model, should be a dictionary conforming to [ConfigDict][pydantic.config.ConfigDict].

state_schema: Dict[str, Any] | None = None

tools: List[str] = None

type: str = None

class hap.types.BaseInfo(/, **data: Any)

Bases: pydantic.BaseModel

Base class for all HAP info types.

Parameters:

data (Any)

classmethod validate_name_format(v: str) → str

Ensure name follows HAP naming conventions.

Parameters:

v (str)

Return type:

str

description: str = None

model_config

Configuration for the model, should be a dictionary conforming to [ConfigDict][pydantic.config.ConfigDict].

name: str = None

class hap.types.EdgeInfo(/, **data: Any)

Bases: pydantic.BaseModel

Graph edge metadata with validation.

Parameters:

data (Any)

validate_edge() → EdgeInfo

Validate edge constraints.

Return type:

EdgeInfo

condition: str | None = None

model_config

Configuration for the model, should be a dictionary conforming to [ConfigDict][pydantic.config.ConfigDict].

source: str = None

target: str = None

class hap.types.ErrorCode

Bases: int, enum.Enum

Standard error codes.

AGENT_NOT_FOUND = -32001

AUTHENTICATION_ERROR = -32007

EXECUTION_ERROR = -32005

GRAPH_NOT_FOUND = -32002

INTERNAL_ERROR = -32603

INVALID_PARAMS = -32602

INVALID_REQUEST = -32600

METHOD_NOT_FOUND = -32601

PARSE_ERROR = -32700

RESOURCE_NOT_FOUND = -32004

TOOL_NOT_FOUND = -32003

VALIDATION_ERROR = -32006

class hap.types.ExecutionStatus

Bases: str, enum.Enum

Agent execution status values.

CANCELLED = 'cancelled'

ERROR = 'error'

SUCCESS = 'success'

TIMEOUT = 'timeout'

class hap.types.GraphExecutionRequest(/, **data: Any)

Bases: pydantic.BaseModel

Request to execute a graph with validation.

Parameters:

data (Any)

classmethod validate_input_not_empty(v: Dict[str, Any]) → Dict[str, Any]

Ensure input data is not empty.

Parameters:

v (Dict[str, Any])

Return type:

Dict[str, Any]

end_node: str | None = None

input_data: Dict[str, Any] = None

metadata: Dict[str, Any] = None

model_config

Configuration for the model, should be a dictionary conforming to [ConfigDict][pydantic.config.ConfigDict].

start_node: str | None = None

stream_nodes: bool = None

timeout: float | None = None

class hap.types.GraphExecutionResult(/, **data: Any)

Bases: pydantic.BaseModel

Result from graph execution with validation.

Parameters:

data (Any)

classmethod validate_path_items(v: List[str]) → List[str]

Validate all path items are valid node IDs.

Parameters:

v (List[str])

Return type:

List[str]

validate_result_consistency() → GraphExecutionResult

Ensure result fields are consistent with status.

Return type:

GraphExecutionResult

error: str | None = None

execution_time: float = None

final_output: Any | None = None

model_config

Configuration for the model, should be a dictionary conforming to [ConfigDict][pydantic.config.ConfigDict].

node_metadata: Dict[str, Any] = None

path: List[str] = None

results: Dict[str, Any] = None

status: GraphExecutionStatus = None

class hap.types.GraphExecutionStatus

Bases: str, enum.Enum

Graph execution status values.

CANCELLED = 'cancelled'

ERROR = 'error'

PARTIAL = 'partial'

SUCCESS = 'success'

TIMEOUT = 'timeout'

class hap.types.GraphInfo(/, **data: Any)

Bases: BaseInfo

Graph metadata for HAP with validation.

Parameters:

data (Any)

validate_graph_structure() → GraphInfo

Validate overall graph structure.

Return type:

GraphInfo

classmethod validate_unique_node_ids(v: List[NodeInfo]) → List[NodeInfo]

Ensure node IDs are unique.

Parameters:

v (List[NodeInfo])

Return type:

List[NodeInfo]

edges: List[EdgeInfo] = None

entry_point: str = None

model_config

Configuration for the model, should be a dictionary conforming to [ConfigDict][pydantic.config.ConfigDict].

nodes: List[NodeInfo] = None

class hap.types.HAPError(/, **data: Any)

Bases: pydantic.BaseModel

Error structure for HAP protocol with enhanced validation.

Parameters:

data (Any)

classmethod validate_error_code(v: int) → int

Validate error code is in expected ranges.

Parameters:

v (int)

Return type:

int

code: int = None

data: Any | None = None

message: str = None

model_config

Configuration for the model, should be a dictionary conforming to [ConfigDict][pydantic.config.ConfigDict].

class hap.types.HAPRequest(/, **data: Any)

Bases: pydantic.BaseModel

Base request structure for HAP protocol with JSON-RPC 2.0 compliance.

Parameters:

data (Any)

classmethod validate_method(v: str) → str

Validate method follows HAP conventions.

Parameters:

v (str)

Return type:

str

id: str | int = None

jsonrpc: str = None

method: str = None

model_config

Configuration for the model, should be a dictionary conforming to [ConfigDict][pydantic.config.ConfigDict].

params: Dict[str, Any] = None

class hap.types.HAPResponse(/, **data: Any)

Bases: pydantic.BaseModel

Base response structure for HAP protocol with validation.

Parameters:

data (Any)

validate_result_or_error() → HAPResponse

Ensure response has either result or error, not both.

Return type:

HAPResponse

error: HAPError | None = None

id: str | int = None

jsonrpc: str = None

model_config

Configuration for the model, should be a dictionary conforming to [ConfigDict][pydantic.config.ConfigDict].

result: Any | None = None

class hap.types.NodeInfo(/, **data: Any)

Bases: pydantic.BaseModel

Graph node metadata with validation.

Parameters:

data (Any)

validate_node_requirements() → NodeInfo

Validate node-type specific requirements.

Return type:

NodeInfo

agent_name: str | None = None

description: str | None = None

id: str = None

model_config

Configuration for the model, should be a dictionary conforming to [ConfigDict][pydantic.config.ConfigDict].

type: NodeType = None

class hap.types.NodeType

Bases: str, enum.Enum

Graph node types.

AGENT = 'agent'

DECISION = 'decision'

END = 'end'

MERGE = 'merge'

PARALLEL = 'parallel'

START = 'start'

TOOL = 'tool'

class hap.types.PromptArgument(/, **data: Any)

Bases: pydantic.BaseModel

Prompt argument definition with validation.

Parameters:

data (Any)

description: str = None

model_config

Configuration for the model, should be a dictionary conforming to [ConfigDict][pydantic.config.ConfigDict].

name: str = None

required: bool = None

class hap.types.PromptInfo(/, **data: Any)

Bases: BaseInfo

Prompt metadata with enhanced validation.

Parameters:

data (Any)

classmethod validate_unique_arguments(v: List[PromptArgument]) → List[PromptArgument]

Ensure argument names are unique.

Parameters:

v (List[PromptArgument])

Return type:

List[PromptArgument]

arguments: List[PromptArgument] = None

model_config

Configuration for the model, should be a dictionary conforming to [ConfigDict][pydantic.config.ConfigDict].

class hap.types.ResourceInfo(/, **data: Any)

Bases: pydantic.BaseModel

Resource metadata with validation.

Parameters:

data (Any)

classmethod validate_uri_format(v: str) → str

Validate URI has proper format.

Parameters:

v (str)

Return type:

str

description: str = None

mime_type: str = None

model_config

Configuration for the model, should be a dictionary conforming to [ConfigDict][pydantic.config.ConfigDict].

name: str = None

uri: str = None

class hap.types.ServerCapability

Bases: str, enum.Enum

Server capabilities.

AUTHENTICATION = 'authentication'

PROMPTS = 'prompts'

RESOURCES = 'resources'

STATE_PERSISTENCE = 'state_persistence'

STREAMING = 'streaming'

TOOLS = 'tools'

class hap.types.ServerRegistration(/, **data: Any)

Bases: pydantic.BaseModel

Registration info for a HAP server.

Parameters:

data (Any)

capabilities: List[ServerCapability] = None

endpoint: str

health_check_url: str | None = None

metadata: dict = None

name: str

registered_at: datetime.datetime = None

type: str

class hap.types.ToolInfo(/, **data: Any)

Bases: BaseInfo

Tool metadata with enhanced validation.

Parameters:

data (Any)

classmethod validate_json_schema(v: Dict[str, Any] | None) → Dict[str, Any] | None

Validate that schema is a valid JSON Schema structure.

Parameters:

v (Optional[Dict[str, Any]])

Return type:

Optional[Dict[str, Any]]

input_schema: Dict[str, Any] = None

model_config

Configuration for the model, should be a dictionary conforming to [ConfigDict][pydantic.config.ConfigDict].

output_schema: Dict[str, Any] | None = None

hap.types.AgentId

hap.types.Entrypoint

hap.types.JSONMap