Metadata-Version: 2.4
Name: vergefy_client
Version: 0.12.0
Summary: Vergefy API
Home-page: 
Author: IntegraHub Support
Author-email: IntegraHub Support <support@integrahub.co>
License: Apache-2.0
Project-URL: Homepage, https://integrahub.co
Keywords: OpenAPI,OpenAPI-Generator,Vergefy API
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Typing :: Typed
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
License-File: NOTICE
Requires-Dist: python-dateutil>=2.8.2
Requires-Dist: httpx>=0.28.1
Requires-Dist: pydantic>=2.11
Requires-Dist: typing-extensions>=4.7.1
Dynamic: author
Dynamic: license-file

# vergefy-client
<h1>AI Agent Management</h1><p>Create, configure, and orchestrate AI agents with multi-provider support.</p><h2>Modules</h2><ul><li><b>Agent (IAG):</b> Agent creation, configuration, lifecycle, insight and analytics (IAG001-057, IAG500-505, IAG700-701)</li><li><b>Template (IAT):</b> Agent template management — /ai/agents-templates</li><li><b>Template Advanced (IATEMP):</b> Versions, analytics, recommendations, diffs — /ai/agents-templates (IATEMP001-008)</li><li><b>Agent Upgrade (IAGENT):</b> Upgrade, rollback, version management — /ai/agents/{id}/upgrade|rollback (IAGENT001-005)</li><li><b>Hierarchy (IAH):</b> Supervisor-worker relationships, delegation — /ai/agents/hierarchies</li><li><b>Goal (IAGG):</b> Autonomous goals, success criteria — /ai/agents/goals</li><li><b>Pool (IAGP):</b> Agent pool management, allocation, coordination (queries IAGP001-023, commands IAGP101-109) — /ai/agents/pools</li><li><b>Execution (IAGE):</b> Execution tracking, history — /ai/agents/executions</li><li><b>Health (IAGH):</b> Health checks, recovery — /ai/agents/health</li><li><b>Communication (IAGC):</b> Channels (IAGC001-019) and inter-agent messages (IAGC020-052) — /ai/agents/channels, /ai/agents/messages</li><li><b>Handoff (IAGD):</b> Agent handoff and transfer — /ai/agents/handoffs</li><li><b>Orchestration (IAGO):</b> Orchestration sessions — /ai/agents/orchestration/sessions</li><li><b>Workflow (IAGW):</b> Workflow assignment and execution — /ai/agents-workflows</li><li><b>Capability (IACAP):</b> Capability definitions, permissions (queries IACAP001-011, commands IACAP101-105) — /ai/capabilities</li><li><b>Capability Mapping (IACF):</b> Capability to feature mapping — /ai/agents/capability-feature-mappings</li></ul><p><b>Providers:</b> OpenAI GPT-4, Anthropic Claude, Google Gemini</p>

This Python package is automatically generated by the [OpenAPI Generator](https://openapi-generator.tech) project:

- API version: 2026-05-30
- Package version: 0.12.0
- Generator version: 7.22.0
- Build package: org.openapitools.codegen.languages.PythonClientCodegen
For more information, please visit [https://integrahub.co](https://integrahub.co)

## Requirements.

Python 3.10+

## Installation & Usage
### pip install

```sh
pip install vergefy_client
```

Then import the package:
```python
import vergefy_client
```

### Setuptools

Install via [Setuptools](http://pypi.python.org/pypi/setuptools).

```sh
python setup.py install --user
```
(or `sudo python setup.py install` to install the package for all users)

Then import the package:
```python
import vergefy_client
```

### Tests

Execute `pytest` to run the tests.

## Getting Started

Please follow the [installation procedure](#installation--usage) and then run the following:

```python

import vergefy_client
from vergefy_client.rest import ApiException
from pprint import pprint

# Defining the host is optional and defaults to https://your-vergefy-host.invalid
# See configuration.py for a list of all supported configuration parameters.
configuration = vergefy_client.Configuration(
    host = "https://your-vergefy-host.invalid"
)

# The client must configure the authentication and authorization parameters
# in accordance with the API server security policy.
# Examples for each auth method are provided below, use the example that
# satisfies your auth use case.

# Configure Bearer authorization (JWT): BearerAuth
configuration = vergefy_client.Configuration(
    access_token = os.environ["BEARER_TOKEN"]
)


# Enter a context with an instance of the API client
async with vergefy_client.ApiClient(configuration) as api_client:
    # Create an instance of the API class
    api_instance = vergefy_client.AIAICHChatApi(api_client)
    x_app_account_id = UUID('550e8400-e29b-41d4-a716-446655440000') # UUID | Required Account Id for transaction context
    conversation_create_dto = vergefy_client.ConversationCreateDTO() # ConversationCreateDTO | 
    accept_language = 'en' # str | Language for translatable content. Default: en (optional) (default to 'en')
    vergefy_version = '2026-05-30' # str | Date-based API version (YYYY-MM-DD). Omit to receive the latest version; an unknown value is rejected with 400 application/problem+json. See ADR-2026-05-30. (optional) (default to '2026-05-30')
    accept_timezone = 'UTC' # str | Timezone for date/time resolution (optional) (default to 'UTC')

    try:
        # AICH001 - Create Conversation
        api_response = await api_instance.a_ich001(x_app_account_id, conversation_create_dto, accept_language=accept_language, vergefy_version=vergefy_version, accept_timezone=accept_timezone)
        print("The response of AIAICHChatApi->a_ich001:\n")
        pprint(api_response)
    except ApiException as e:
        print("Exception when calling AIAICHChatApi->a_ich001: %s\n" % e)

```

## API Reference

The full endpoint and model reference is generated from the Vergefy OpenAPI contract. Contact support@integrahub.co to obtain it.

## Documentation For Authorization


Authentication schemes defined for the API:
<a id="BearerAuth"></a>
### BearerAuth

- **Type**: Bearer authentication (JWT)


## Author

support@integrahub.co


