hap.servers.agent

AgentServer implementation for exposing Haive agents via HAP protocol.

This module provides a HAP server that wraps any Haive agent and exposes its functionality through tools, resources, and prompts.

Classes

AgentServer

HAP server that exposes a Haive agent via MCP-like protocol.

Module Contents

class hap.servers.agent.AgentServer(agent, name=None, description=None, expose_tools=True, expose_state=True)

Bases: hap.server.HAPServer

HAP server that exposes a Haive agent via MCP-like protocol.

This server wraps any Haive agent and provides: - Tool for executing the agent - Resources for agent state and configuration - Tools for individual agent tools (if applicable) - Structured output schema access

Initialize AgentServer.

Parameters:

  • agent (Any) – The Haive agent to expose

  • name (Optional[str]) – Server name (defaults to agent-{agent.name})

  • description (Optional[str]) – Server description

  • expose_tools (bool) – Whether to expose agent’s individual tools

  • expose_state (bool) – Whether to expose agent state as resource

get_capabilities()

Get server capabilities including agent-specific ones.

Return type:

List[hap.types.ServerCapability]