:py:mod:`agentic_fabric.capabilities`
=====================================

.. py:module:: agentic_fabric.capabilities

.. autodoc2-docstring:: agentic_fabric.capabilities
   :parser: myst
   :allowtitles:

Module Contents
---------------

Classes
~~~~~~~

.. list-table::
   :class: autosummary longtable
   :align: left

   * - :py:obj:`AgentCapabilitySpec <agentic_fabric.capabilities.AgentCapabilitySpec>`
     - .. autodoc2-docstring:: agentic_fabric.capabilities.AgentCapabilitySpec
          :parser: myst
          :summary:
   * - :py:obj:`AgentCapabilityProviderMixin <agentic_fabric.capabilities.AgentCapabilityProviderMixin>`
     - .. autodoc2-docstring:: agentic_fabric.capabilities.AgentCapabilityProviderMixin
          :parser: myst
          :summary:

Functions
~~~~~~~~~

.. list-table::
   :class: autosummary longtable
   :align: left

   * - :py:obj:`agent_capability <agentic_fabric.capabilities.agent_capability>`
     - .. autodoc2-docstring:: agentic_fabric.capabilities.agent_capability
          :parser: myst
          :summary:
   * - :py:obj:`runtime_capability <agentic_fabric.capabilities.runtime_capability>`
     - .. autodoc2-docstring:: agentic_fabric.capabilities.runtime_capability
          :parser: myst
          :summary:
   * - :py:obj:`tool_capability <agentic_fabric.capabilities.tool_capability>`
     - .. autodoc2-docstring:: agentic_fabric.capabilities.tool_capability
          :parser: myst
          :summary:

Data
~~~~

.. list-table::
   :class: autosummary longtable
   :align: left

   * - :py:obj:`F <agentic_fabric.capabilities.F>`
     - .. autodoc2-docstring:: agentic_fabric.capabilities.F
          :parser: myst
          :summary:

API
~~~

.. py:data:: F
   :canonical: agentic_fabric.capabilities.F
   :value: 'TypeVar(...)'

   .. autodoc2-docstring:: agentic_fabric.capabilities.F
      :parser: myst

.. py:class:: AgentCapabilitySpec
   :canonical: agentic_fabric.capabilities.AgentCapabilitySpec

   .. autodoc2-docstring:: agentic_fabric.capabilities.AgentCapabilitySpec
      :parser: myst

   .. py:attribute:: name
      :canonical: agentic_fabric.capabilities.AgentCapabilitySpec.name
      :type: str
      :value: None

      .. autodoc2-docstring:: agentic_fabric.capabilities.AgentCapabilitySpec.name
         :parser: myst

   .. py:attribute:: kind
      :canonical: agentic_fabric.capabilities.AgentCapabilitySpec.kind
      :type: str
      :value: 'runtime'

      .. autodoc2-docstring:: agentic_fabric.capabilities.AgentCapabilitySpec.kind
         :parser: myst

   .. py:attribute:: aliases
      :canonical: agentic_fabric.capabilities.AgentCapabilitySpec.aliases
      :type: tuple[str, ...]
      :value: ()

      .. autodoc2-docstring:: agentic_fabric.capabilities.AgentCapabilitySpec.aliases
         :parser: myst

   .. py:attribute:: description
      :canonical: agentic_fabric.capabilities.AgentCapabilitySpec.description
      :type: str
      :value: <Multiline-String>

      .. autodoc2-docstring:: agentic_fabric.capabilities.AgentCapabilitySpec.description
         :parser: myst

   .. py:method:: as_dict() -> dict[str, typing.Any]
      :canonical: agentic_fabric.capabilities.AgentCapabilitySpec.as_dict

      .. autodoc2-docstring:: agentic_fabric.capabilities.AgentCapabilitySpec.as_dict
         :parser: myst

.. py:function:: agent_capability(name: str, *, kind: str = 'runtime', aliases: tuple[str, ...] = (), description: str = '') -> collections.abc.Callable[[agentic_fabric.capabilities.F], agentic_fabric.capabilities.F]
   :canonical: agentic_fabric.capabilities.agent_capability

   .. autodoc2-docstring:: agentic_fabric.capabilities.agent_capability
      :parser: myst

.. py:function:: runtime_capability(name: str, *, aliases: tuple[str, ...] = (), description: str = '') -> collections.abc.Callable[[agentic_fabric.capabilities.F], agentic_fabric.capabilities.F]
   :canonical: agentic_fabric.capabilities.runtime_capability

   .. autodoc2-docstring:: agentic_fabric.capabilities.runtime_capability
      :parser: myst

.. py:function:: tool_capability(name: str, *, aliases: tuple[str, ...] = (), description: str = '') -> collections.abc.Callable[[agentic_fabric.capabilities.F], agentic_fabric.capabilities.F]
   :canonical: agentic_fabric.capabilities.tool_capability

   .. autodoc2-docstring:: agentic_fabric.capabilities.tool_capability
      :parser: myst

.. py:class:: AgentCapabilityProviderMixin
   :canonical: agentic_fabric.capabilities.AgentCapabilityProviderMixin

   .. autodoc2-docstring:: agentic_fabric.capabilities.AgentCapabilityProviderMixin
      :parser: myst

   .. py:attribute:: agent_capabilities
      :canonical: agentic_fabric.capabilities.AgentCapabilityProviderMixin.agent_capabilities
      :type: typing.ClassVar[collections.abc.Mapping[str, agentic_fabric.capabilities.AgentCapabilitySpec]]
      :value: None

      .. autodoc2-docstring:: agentic_fabric.capabilities.AgentCapabilityProviderMixin.agent_capabilities
         :parser: myst

   .. py:attribute:: agent_capability_methods
      :canonical: agentic_fabric.capabilities.AgentCapabilityProviderMixin.agent_capability_methods
      :type: typing.ClassVar[collections.abc.Mapping[str, str]]
      :value: None

      .. autodoc2-docstring:: agentic_fabric.capabilities.AgentCapabilityProviderMixin.agent_capability_methods
         :parser: myst

   .. py:method:: list_capabilities(*, kind: str | None = None) -> tuple[agentic_fabric.capabilities.AgentCapabilitySpec, ...]
      :canonical: agentic_fabric.capabilities.AgentCapabilityProviderMixin.list_capabilities
      :classmethod:

      .. autodoc2-docstring:: agentic_fabric.capabilities.AgentCapabilityProviderMixin.list_capabilities
         :parser: myst

   .. py:method:: call_capability(name: str, *args: typing.Any, **kwargs: typing.Any) -> typing.Any
      :canonical: agentic_fabric.capabilities.AgentCapabilityProviderMixin.call_capability

      .. autodoc2-docstring:: agentic_fabric.capabilities.AgentCapabilityProviderMixin.call_capability
         :parser: myst

   .. py:method:: capability_map() -> collections.abc.Mapping[str, agentic_fabric.capabilities.AgentCapabilitySpec]
      :canonical: agentic_fabric.capabilities.AgentCapabilityProviderMixin.capability_map

      .. autodoc2-docstring:: agentic_fabric.capabilities.AgentCapabilityProviderMixin.capability_map
         :parser: myst