hap.types.graphs

HAP type definitions for Haive graphs and nodes.

This module defines HAP protocol types for exposing Haive graph structures, nodes, edges, and graph execution capabilities.

Classes

BranchInfo	Information about a conditional branch.
EdgeInfo	Information about an edge in a graph.
GraphCheckpointInfo	Information about a graph checkpoint.
GraphExecutionRequest	Request to execute a graph.
GraphExecutionResult	Result from graph execution.
GraphInfo	Information about a Haive graph exposed through HAP.
GraphModificationRequest	Request to modify a graph structure.
GraphValidationResult	Result of graph validation.
GraphVisualizationRequest	Request for graph visualization.
NodeExecutionInfo	Information about a single node execution.
NodeInfo	Information about a node in a graph.

Module Contents

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

Bases: pydantic.BaseModel

Information about a conditional branch.

Parameters:

data (Any)

branch_type: Literal['function', 'key_value', 'send', 'command'] = None

conditions: dict[str, str] = None

default_target: str | None = None

name: str = None

source_node: str = None

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

Bases: pydantic.BaseModel

Information about an edge in a graph.

Parameters:

data (Any)

condition: str | None = None

edge_type: Literal['direct', 'conditional', 'dynamic'] = None

metadata: dict[str, Any] = None

source: str = None

target: str = None

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

Bases: pydantic.BaseModel

Information about a graph checkpoint.

Parameters:

data (Any)

checkpoint_id: str = None

created_at: str = None

current_node: str = None

graph_name: str = None

metadata: dict[str, Any] = None

state: dict[str, Any] = None

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

Bases: pydantic.BaseModel

Request to execute a graph.

Parameters:

data (Any)

checkpoint_id: str | None = None

config: dict[str, Any] | None = None

graph_name: str = None

input_data: dict[str, Any] = None

interrupt_after: list[str] | None = None

interrupt_before: list[str] | None = None

stream: bool = None

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

Bases: pydantic.BaseModel

Result from graph execution.

Parameters:

data (Any)

checkpoint_id: str | None = None

duration_ms: float | None = None

error: str | None = None

executed_nodes: list[str] = None

execution_path: list[str] = None

metadata: dict[str, Any] = None

result: dict[str, Any] | None = None

status: Literal['success', 'error', 'interrupted'] = None

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

Bases: haive.hap.types.BaseInfo

Information about a Haive graph exposed through HAP.

Parameters:

data (Any)

allow_cycles: bool = None

branches: list[BranchInfo] = None

edges: list[EdgeInfo] = None

entry_points: list[str] = None

finish_points: list[str] = None

graph_class: str = None

graph_id: str = None

is_compiled: bool = None

needs_recompile: bool = None

nodes: list[NodeInfo] = None

require_end_path: bool = None

state_schema: str | None = None

subgraphs: list[str] = None

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

Bases: pydantic.BaseModel

Request to modify a graph structure.

Parameters:

data (Any)

graph_name: str = None

node_config: dict[str, Any] | None = None

node_name: str | None = None

operation: Literal['add_node', 'remove_node', 'add_edge', 'remove_edge', 'update_node'] = None

source: str | None = None

target: str | None = None

updates: dict[str, Any] | None = None

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

Bases: pydantic.BaseModel

Result of graph validation.

Parameters:

data (Any)

cycles_detected: list[list[str]] = None

errors: list[str] = None

missing_handlers: list[str] = None

unreachable_nodes: list[str] = None

valid: bool = None

warnings: list[str] = None

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

Bases: pydantic.BaseModel

Request for graph visualization.

Parameters:

data (Any)

format: Literal['mermaid', 'graphviz', 'json', 'ascii'] = None

graph_name: str = None

highlight_path: list[str] | None = None

include_subgraphs: bool = None

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

Bases: pydantic.BaseModel

Information about a single node execution.

Parameters:

data (Any)

duration_ms: float | None = None

end_time: str | None = None

error: str | None = None

input_state: dict[str, Any] = None

node_name: str = None

output_state: dict[str, Any] | None = None

start_time: str = None

status: Literal['success', 'error', 'skipped'] = None

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

Bases: haive.hap.types.BaseInfo

Information about a node in a graph.

Parameters:

data (Any)

command_goto: str | list[str] | None = None

created_at: str | None = None

input_mapping: dict[str, str] | None = None

node_class: str = None

node_id: str = None

node_type: str = None

output_mapping: dict[str, str] | None = None

retry_policy: dict[str, Any] | None = None