Metadata-Version: 2.4
Name: hacs-core
Version: 0.1.0
Summary: Core models and base classes for Healthcare Agent Communication Standard
Project-URL: Homepage, https://github.com/solanovisitor/hacs
Project-URL: Documentation, https://github.com/solanovisitor/hacs/blob/main/docs/modules/hacs-core.md
Project-URL: Repository, https://github.com/solanovisitor/hacs
Project-URL: Bug Tracker, https://github.com/solanovisitor/hacs/issues
Project-URL: Changelog, https://github.com/solanovisitor/hacs/blob/main/docs/reference/changelog.md
Author-email: Solano Todeschini <solano.todeschini@gmail.com>
Maintainer-email: Solano Todeschini <solano.todeschini@gmail.com>
License: Apache-2.0
Keywords: actor,agents,ai,base-classes,core,evidence,healthcare,memory,models
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Healthcare Industry
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Scientific/Engineering :: Medical Science Apps.
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Typing :: Typed
Requires-Python: >=3.10
Requires-Dist: pydantic<3.0.0,>=2.7.0
Provides-Extra: dev
Requires-Dist: pyright>=1.1.0; extra == 'dev'
Requires-Dist: pytest-cov>=4.0.0; extra == 'dev'
Requires-Dist: pytest>=7.0.0; extra == 'dev'
Requires-Dist: ruff>=0.4.0; extra == 'dev'
Description-Content-Type: text/markdown

# HACS Core

Core models and base classes for Healthcare Agent Communication Standard (HACS).

## Overview

`hacs-core` provides the foundational models and base classes that all other HACS packages build upon. It defines the core abstractions for healthcare agent communication, including actors, resources, memory management, and evidence handling.

## Key Components

### BaseResource
The foundational class for all HACS resources, providing:
- Unique resource identification
- Metadata management
- Serialization/deserialization
- Validation framework

### Actor
Represents entities that can perform actions in the healthcare system:
- Actor identification and authentication
- Role-based access control
- Audit trail management
- Permission validation

### MemoryBlock
Manages structured memory for healthcare agents:
- Persistent memory storage
- Memory retrieval and querying
- Memory lifecycle management
- Cross-agent memory sharing

### Evidence
Handles clinical evidence and supporting documentation:
- Evidence classification and scoring
- Source attribution and provenance
- Evidence linking and relationships
- Quality assessment metrics

## Installation

```bash
pip install hacs-core
```

## Quick Start

```python
from hacs_core import BaseResource, Actor, MemoryBlock, Evidence

# Create an actor
actor = Actor(
    actor_id="dr_smith",
    actor_type="clinician",
    display_name="Dr. Sarah Smith"
)

# Create a memory block
memory = MemoryBlock(
    memory_id="patient_history",
    content={"diagnosis": "hypertension"},
    actor_context=actor
)

# Create evidence
evidence = Evidence(
    evidence_id="guideline_001",
    title="Hypertension Management Guidelines",
    confidence_score=0.95,
    source="American Heart Association"
)
```

## Documentation

For complete documentation, see the [HACS Documentation](https://github.com/solanovisitor/hacs/blob/main/docs/modules/hacs-core.md).

## License

Licensed under the Apache License, Version 2.0. See [LICENSE](https://github.com/solanovisitor/hacs/blob/main/LICENSE) for details.

## Contributing

See [Contributing Guidelines](https://github.com/solanovisitor/hacs/blob/main/docs/contributing/guidelines.md) for information on how to contribute to HACS Core.
