Metadata-Version: 2.4
Name: nlt-otoi
Version: 1.2.0
Summary: Python reference implementation of the .otoi (Orchestrated Terms of Interaction) honoring layer — the multi-agent orchestration standard built on the canonical .toi file type.
Project-URL: Homepage, https://github.com/NeuroLift-Technologies/nlt-otoi
Project-URL: Repository, https://github.com/NeuroLift-Technologies/nlt-otoi
Project-URL: Issues, https://github.com/NeuroLift-Technologies/nlt-otoi/issues
Author: NeuroLift Technologies, LLC
License-Expression: Apache-2.0
License-File: LICENSE
Keywords: ai-governance,multi-agent,orchestration,otoi,solidarity-framework,terms-of-interaction,toi,user-agency
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
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: Topic :: Software Development :: Libraries
Requires-Python: >=3.9
Requires-Dist: nlt-toi>=1.0.0
Provides-Extra: dev
Requires-Dist: pytest-cov>=4.0; extra == 'dev'
Requires-Dist: pytest>=7.0; extra == 'dev'
Description-Content-Type: text/markdown

# NeuroLift OTOI Framework

**Orchestrated Terms of Interaction (OTOI)**: User-defined Terms of Interaction for AI systems. Enables neurodivergent-friendly multi-agent orchestration with privacy-first governance. Open standard for human-controlled AI collaboration.

## 🌟 What is OTOI?

The OTOI (Orchestrated Terms of Interaction) framework is a revolutionary approach to human-AI interaction that puts users in complete control of their AI collaborations. It provides a structured way to define Terms of Interaction (TOI) that ensure AI systems work exactly how you need them to, respecting your cognitive preferences, privacy requirements, and collaboration style.

### Key Principles

- **User-Controlled**: You define exactly how AI should interact with you
- **Neurodivergent-Friendly**: Built with diverse cognitive needs in mind
- **Privacy-First**: Your data and preferences stay under your control
- **Flexible**: Adapt to any workflow or collaboration style
- **Transparent**: Clear, understandable interaction rules

## 🚀 Quick Start

### For Non-Technical Users

1. Start with the [Personal TOI Template](/templates/personal-toi-template.md)
2. Fill in your preferences and requirements
3. Share your TOI with AI systems or collaborators
4. Enjoy personalized, respectful AI interactions

### For Technical Users

1. Use the [JSON schemas](/schemas/) to validate your TOI documents
2. Implement the OTOI protocol in your applications
3. Contribute to the standard through our [development process](/docs/development-process.md)

## 📁 Repository Structure

```
/src/              # Python implementation
├── fusion/        # TOI-OTOI governance layer
│   ├── toi_parser.py        # Parse & validate TOI documents
│   ├── otoi_orchestrator.py # Multi-agent coordination
│   └── privacy_guardian.py  # Privacy-first enforcement

/schemas/          # JSON schemas for validation
├── personal-toi.schema.json
└── collaborative-charter.schema.json

/templates/        # User-friendly templates
├── personal-toi-template.md
├── collaborative-charter-template.md
└── quick-start-template.md

/examples/         # Real-world examples
├── neurodivergent-examples/
├── neuroLift/     # NeuroLift integration patterns
└── team-collaboration/

/index.html        # GitHub Pages landing page
/agent-solidarity-kit.json # Agent governance + integration contract

/docs/            # Comprehensive documentation
├── framework-overview.md
├── development-process.md
├── implementation-guide.md
├── best-practices.md
├── active-threads.md
└── agent-log/
    ├── README.md
    ├── registrations/
    └── handoffs/
```

## 🧭 GitHub Pages and Solidarity Kit Maintenance

The repository includes a public landing page (`index.html`) and a governance
contract (`agent-solidarity-kit.json`). Keep them synchronized:

1. Treat `agent-solidarity-kit.json` as the source of truth.
2. Mirror user-facing fields in `index.html` (version, model details, and
   architecture labels) when they change.
3. Use `docs/development-process.md` for the operational runbook and validation
   commands.
4. Track work lifecycle in `docs/active-threads.md` and session records in
   `docs/agent-log/`.

## 🎯 Core Components

### Personal TOI (Terms of Interaction)

Your personal TOI defines how AI systems should interact with you individually. It includes:

- Communication preferences (direct vs. indirect, formal vs. casual)
- Cognitive accessibility needs (processing time, information structure)
- Privacy and data handling requirements
- Feedback and correction preferences
- Energy and attention management

### Collaborative Charter

For team or multi-user scenarios, the Collaborative Charter establishes:

- Shared interaction protocols
- Conflict resolution processes
- Decision-making frameworks
- Privacy boundaries in group settings
- Integration with individual TOIs

## 🌈 Neurodivergent-Friendly Features

- **Sensory Considerations**: Control information density and presentation
- **Executive Function Support**: Structured decision trees and clear processes
- **Social Communication**: Explicit expectations and interaction patterns
- **Cognitive Load Management**: Customizable complexity levels
- **Routine and Predictability**: Consistent interaction patterns

## 🔒 Privacy & Security

- **Local Control**: Your TOI documents stay on your systems
- **Minimal Data**: Only necessary information is shared
- **Transparent Processing**: Clear rules about data handling
- **Revocable Consent**: Easy to modify or withdraw permissions
- **Standards-Based**: Open protocols, no vendor lock-in

## 🤝 Contributing

We welcome contributions from everyone! Whether you're:

- A neurodivergent individual sharing your needs
- A developer implementing the standard
- A researcher studying human-AI interaction
- An organization adopting OTOI

See our [Contributing Guidelines](CONTRIBUTING.md) for how to get involved.

## 📄 License

This project is licensed under the Apache License 2.0 - see the [LICENSE](LICENSE) file for details.

The repository root `LICENSE` file is the authoritative license text for this
repo and for the in-repository `@neurolift-technologies/otoi` package metadata.
The npm package also carries `packages/otoi/LICENSE` so the published tarball can
ship its own license copy. If a future change updates the license identifier,
notice text, or package release metadata, update this section, the package-level
license notes, and the
[license maintenance runbook](docs/development-process.md#license-maintenance-runbook)
in the same PR.

## 🌍 Community

- **Issues**: Report bugs or request features
- **Discussions**: Share experiences and ask questions
- **Examples**: Contribute real-world TOI documents
- **Documentation**: Help improve our guides and tutorials

## 🔗 Related Projects

- [OTOI Reference Implementation](#) (Coming Soon)
- [OTOI Browser Extension](#) (Coming Soon)
- [OTOI for Teams](#) (Coming Soon)

## 📖 Deep Dive

For a comprehensive technical overview of the TOI-OTOI framework, including framework philosophy, architecture layers, and development roadmap, see our [Framework Overview](/docs/framework-overview.md).

---

**Made with ❤️ for the neurodivergent community and everyone who values respectful human-AI collaboration.**
