Metadata-Version: 2.4
Name: cocapn-oneiros
Version: 0.3.1
Summary: 🌙 Dream-state agent orchestration — sleep cycles, background processing, dream journal
Author: Cocapn
License: MIT
Project-URL: Homepage, https://cocapn.github.io
Project-URL: Repository, https://github.com/cocapn/cocapn-oneiros
Keywords: cocapn,agent,dream,sleep,orchestration
Requires-Python: >=3.10
Description-Content-Type: text/markdown

# 🌙 Cocapn Oneiros

> Dream-state agent orchestration — sleep cycles, background processing, dream journal

Agents dream while idle. Oneiros manages sleep/wake cycles, runs background tasks during downtime, and keeps a dream journal of what happened.

## Install

```bash
pip install cocapn-oneiros
```

## Quick Start

### Dream Cycle

```python
from cocapn_oneiros import DreamCycle

dream = DreamCycle(agent_id="oracle1")
dream.register_dream_task("consolidate_memory", lambda: "consolidated 42 tiles")
dream.mark_idle()

result = dream.dream()
print(f"Success: {result.success}, Result: {result.result}")
print(f"Journal: {dream.journal.stats()}")
```

### Sleep Scheduler

```python
from cocapn_oneiros import SleepScheduler

scheduler = SleepScheduler()
scheduler.register("oracle1", timezone_offset=-8)
print(f"Current phase: {scheduler.current_phase('oracle1')}")
```

## Part of [Cocapn](https://github.com/cocapn) · Agent Infrastructure
