agent-foundry-local 0.1.8__tar.gz

agent_foundry_local-0.1.8/CHANGELOG.md

@@ -0,0 +1,116 @@
+# Changelog
+
+All notable changes to Local Agent Foundry.
+
+## [0.1.8] — 2026-05-04
+
+
+
+## [0.1.7] — 2026-05-04
+
+- 🐛 fix: invalid PyPI classifier + sync pyproject.toml version in release script
+
+
+## [0.1.6] — 2026-05-04
+
+
+
+## [0.1.5] — 2026-05-04
+
+
+
+## [0.1.4] — 2026-05-04
+
+- ✨ feat: dashboard demo GIF with live randomness — values jitter ±5%, agent states flip, timestamps tick
+- ✨ feat: working dashboard navigation — 7 tab panels with real content switching
+- 🐛 fix: dashboard demo stays light theme throughout (no dark toggle)
+
+
+## [0.1.3] — 2026-05-04
+
+
+
+## [0.1.2] — 2026-05-04
+
+- 🐛 fix: dashboard demo starts light-first (user preference)
+- ✨ feat: dynamic dashboard demo GIF — nav clicks, gate check, theme toggle
+- ✨ feat: dashboard UI demo GIF + Playwright capture script
+- 🐛 fix: resolve 86 lint errors + slow demo GIF to human speed
+
+
+## [0.1.1] — 2026-05-04
+
+- 🐛 fix: animated demo GIF, updated changelog, roadmap sync
+- ✨ feat: animated CLI demo, light mode screenshot, pyproject fixes, demo script
+- ✨ feat: light/dark theme + screenshots for README
+- ✨ feat: dashboard mockup + comms kit + README badges
+- ✨ feat: CI/CD release pipeline — GitHub Actions, PyPI publishing
+- ✨ feat: Desktop UI scaffold — Tauri + React
+- ✨ feat: Multi-machine orchestration — peer discovery + cross-machine handoffs
+- ✨ feat: Cloud model fallback — opt-in cloud backend
+- ✨ feat: M365 Bridge — SharePoint, Teams, Graph API, Power Platform
+- ✨ feat: compliance pack + docs — project complete
+- v0.2: Real tool execution + skill registry + live model support
+- Initial commit: Local Agent Foundry MVP
+- 📝 docs: architecture for Local Agent Foundry
+
+
+## [0.1.1] — 2026-05-04
+
+### ✨ Features
+
+- **M365 Bridge**: 4 modules (auth, Graph, SharePoint, Teams, Power Platform) with 14 CLI commands
+- **Multi-machine Orchestration**: P2P node registry, mDNS discovery, HTTPS handoff transport
+- **Cloud Fallback**: Opt-in OpenAI-compatible backend with `FOUNDRY_CLOUD_CONSENT` gate
+- **Desktop UI Scaffold**: Tauri + React 19 with 6-panel dashboard, light/dark theme
+- **Release Pipeline**: GitHub Actions CI + PyPI publish on tag push, `scripts/release.py`
+
+### 📝 Documentation
+
+- Animated CLI demo GIF showing 9-step workflow
+- Comms kit (LinkedIn, Twitter, blog, pitch deck) in `docs/comms-kit.md`
+- Dashboard mockups with realistic NHS M365 data (light + dark)
+- Screenshots captured via Playwright/Chromium
+
+### 🧪 Testing
+
+- 163 tests, all passing (up from 103)
+
+---
+
+## [0.1.0] — 2026-05-04
+
+### ✨ Features
+
+- **MVP CLI**: Full agent lifecycle management — start, stop, list, run agents
+- **Handoff Protocol**: Formal agent-to-agent work transfer with state preservation, definition of done, and verification
+- **Quality Gates**: 5 gate types — syntax, safety, behaviour, security, performance
+- **Observability**: Audit trail with SQLite backend, export to JSON, statistics dashboard
+- **Skill System**: Hermes SKILL.md format — discover, load, and execute agent skills
+- **Tool Registry**: Extensible tool registration system with built-in terminal/file tools
+- **Model Runtime**: Abstract backend interface with oMLX, llama.cpp, Ollama, and Dummy implementations
+- **Dummy Backend**: Predictable responses for testing without a real model
+
+### 📝 Documentation
+
+- Full architecture documentation with competitive landscape
+- Getting Started guide with 10-minute multi-agent workflow tutorial
+- Compliance pack: DPIA template, GDPR checklist, NHS DTAC alignment, ISO 27001 mapping
+- Model card template for documenting AI models used in regulated contexts
+- Deployment architecture guide with 3 deployment models (standalone, air-gapped, VDI)
+
+### 🧪 Testing
+
+- 163 tests covering all 6 layers
+- test_engine, test_handoff, test_gates, test_observability, test_registry, test_runtime
+- Integration tests for end-to-end agent workflows
+
+---
+
+## Upcoming
+
+Planned for future releases:
+- Desktop UI (Tauri + React) — full dashboard, logs, model management
+- OAuth2 device flow for M365 Bridge
+- Agent skill marketplace / discovery
+

agent_foundry_local-0.1.8/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Vilius Vystartas
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

agent_foundry_local-0.1.8/MANIFEST.in

@@ -0,0 +1,12 @@
+include src/foundry/py.typed
+include src/foundry/**/*.py
+include LICENSE
+include README.md
+include CHANGELOG.md
+recursive-include skills *.md
+recursive-include docs *.md
+
+exclude .foundry
+exclude desktop
+prune tests
+prune .github

agent_foundry_local-0.1.8/PKG-INFO

@@ -0,0 +1,177 @@
+Metadata-Version: 2.4
+Name: agent-foundry-local
+Version: 0.1.8
+Summary: Local-first AI agent platform with formal handoff protocol for regulated industries
+Author-email: Vilius Vystartas <vilius@agenticflow.dev>
+License-Expression: MIT
+Project-URL: Homepage, https://agenticflow.dev
+Project-URL: Documentation, https://github.com/vystartasv/agent-foundry#readme
+Project-URL: Repository, https://github.com/vystartasv/agent-foundry
+Project-URL: Issues, https://github.com/vystartasv/agent-foundry/issues
+Project-URL: Changelog, https://github.com/vystartasv/agent-foundry/blob/main/CHANGELOG.md
+Keywords: ai-agents,agent-orchestration,local-ai,offline-first,regulated-industries,nhs,gdpr,microsoft-365,sharepoint,microsoft-teams,compliance,audit-trail,agent-handoff
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Healthcare Industry
+Classifier: Intended Audience :: Financial and Insurance Industry
+Classifier: Intended Audience :: Information Technology
+Classifier: Operating System :: MacOS
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Classifier: Topic :: Software Development :: Build Tools
+Classifier: Topic :: Software Development :: Quality Assurance
+Classifier: Topic :: Office/Business :: Groupware
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: click>=8.1
+Requires-Dist: httpx>=0.27
+Requires-Dist: msal>=1.28
+Requires-Dist: pydantic>=2.0
+Provides-Extra: dev
+Requires-Dist: pytest>=8.0; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.24; extra == "dev"
+Requires-Dist: pytest-cov>=5.0; extra == "dev"
+Requires-Dist: ruff>=0.5; extra == "dev"
+Dynamic: license-file
+
+# Local Agent Foundry
+
+[![CI](https://github.com/vystartasv/agent-foundry/actions/workflows/ci.yml/badge.svg)](https://github.com/vystartasv/agent-foundry/actions/workflows/ci.yml)
+[![Python 3.11+](https://img.shields.io/badge/python-3.11%2B-blue)](https://www.python.org/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
+[![Tests](https://img.shields.io/badge/tests-163%20passed-brightgreen)]()
+[![NHS DTAC](https://img.shields.io/badge/NHS-DTAC%20Aligned-005EB8)]()
+[![ISO 27001](https://img.shields.io/badge/ISO%2027001-Mapped-0072C6)]()
+
+> **Agents building agents. Offline. Auditable. Regulated-industry ready.**
+
+A desktop platform for running, managing, and orchestrating AI agents entirely offline. Agents build, test, and deploy other agents — with full audit trails and compliance documentation for NHS, finance, and government.
+
+![Dashboard Screenshot](desktop/mockups/dashboard-light.png)
+
+![CLI Demo](desktop/mockups/demo-animated.gif)
+
+![Dashboard Demo](desktop/mockups/dashboard-demo.gif)
+
+## Why
+
+No existing platform combines:
+- **Local-only operation** (air-gapped, GDPR-compliant)
+- **Agent orchestration** (multi-agent with formal handoffs)
+- **Observability** (audit trail, cost tracking, health)
+- **Quality gates** (behavioural tests for agents)
+- **Regulated industry readiness** (compliance docs, model cards)
+
+## Quick Start
+
+```bash
+# Install
+pip install agent-foundry
+
+# Or from source
+git clone <repo-url>
+cd agent-foundry
+pip install -e ".[dev]"
+
+# Start an agent
+foundry agent start builder --model qwen-8b --tools terminal,file
+
+# Run a task
+foundry agent run builder "Create a test file"
+
+# Hand off to a reviewer
+foundry agent start reviewer --model qwen-8b --tools terminal,file
+foundry handoff create --from builder --to reviewer --task "Review the work"
+
+# Check quality gates
+foundry gate run --agent builder --file output.txt
+
+# Export audit log
+foundry audit export --output compliance-report.json
+```
+
+## Architecture
+
+Six layers, running entirely on your machine:
+
+```
+Desktop UI (Tauri) ·················· [Phase 2]
+CLI (`foundry`) ····················· [MVP ✓]
+Agent Engine · Handoff Protocol ★ · Quality Gates · Observability
+Model Runtime (oMLX · llama.cpp · Ollama)
+Tool Registry (MCP · Hermes skills)
+Storage (SQLite)
+```
+
+**The handoff protocol** is the core differentiator — a formal standard for agents to pass work between each other with full state preservation and verification. Every handoff is auditable.
+
+## For Regulated Industries
+
+Pre-built compliance documentation included in `docs/compliance/`:
+- **DPIA Template** — Data Protection Impact Assessment
+- **Model Cards** — Per-model capability and limitation documentation
+- **GDPR Checklist** — Article-by-article compliance verification
+- **NHS DTAC Alignment** — Digital Technology Assessment Criteria mapping
+- **ISO 27001 Control Mapping** — All 71 Annex A controls mapped
+- **Deployment Architecture** — On-prem deployment patterns, data flows
+
+Zero cloud dependency. Air-gap capable. No data leaves your device.
+
+## Requirements
+
+- Python 3.11+
+- macOS (Apple Silicon), Linux, or Windows
+- 16GB+ RAM (32GB recommended for 8B+ models)
+- No network required (offline operation after model download)
+
+## Model Backends
+
+| Backend | Status | Notes |
+|---------|--------|-------|
+| oMLX | ✅ Supported | Apple Silicon, local inference |
+| llama.cpp | ✅ Supported | Cross-platform GGUF models |
+| Ollama | ✅ Supported | Easy model management |
+| Dummy | ✅ Testing | Simulated backend for tests |
+
+## Commands
+
+```
+foundry agent start|stop|list|stats|run    Manage agents
+foundry handoff create|accept|complete|list|show    Formal work transfer
+foundry gate run                          Quality checks
+foundry skill discover|list|show          Agent skills
+foundry audit show|export|stats           Audit trail
+foundry backend health|models|test        Backend management
+```
+
+## Development
+
+```bash
+pip install -e ".[dev]"
+pytest                    # 163 tests
+foundry --help            # CLI reference
+```
+
+## Documentation
+
+- [Architecture](docs/architecture.md) — Full system design
+- [Compliance Pack](docs/compliance/) — Regulated industry procurement docs
+- [Getting Started](docs/getting-started.md) — Setup and first agent workflow
+
+## Roadmap
+
+- [x] CLI MVP — agent engine, handoff, gates, audit
+- [x] Compliance pack — NHS, GDPR, ISO 27001
+- [x] M365 Bridge — SharePoint, Teams, Graph API integration
+- [x] Multi-machine orchestration
+- [x] Cloud model fallback (opt-in)
+- [ ] Desktop UI (Tauri) — dashboard, logs, model management
+
+## License
+
+MIT — see [LICENSE](LICENSE)

agent_foundry_local-0.1.8/README.md

@@ -0,0 +1,136 @@
+# Local Agent Foundry
+
+[![CI](https://github.com/vystartasv/agent-foundry/actions/workflows/ci.yml/badge.svg)](https://github.com/vystartasv/agent-foundry/actions/workflows/ci.yml)
+[![Python 3.11+](https://img.shields.io/badge/python-3.11%2B-blue)](https://www.python.org/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
+[![Tests](https://img.shields.io/badge/tests-163%20passed-brightgreen)]()
+[![NHS DTAC](https://img.shields.io/badge/NHS-DTAC%20Aligned-005EB8)]()
+[![ISO 27001](https://img.shields.io/badge/ISO%2027001-Mapped-0072C6)]()
+
+> **Agents building agents. Offline. Auditable. Regulated-industry ready.**
+
+A desktop platform for running, managing, and orchestrating AI agents entirely offline. Agents build, test, and deploy other agents — with full audit trails and compliance documentation for NHS, finance, and government.
+
+![Dashboard Screenshot](desktop/mockups/dashboard-light.png)
+
+![CLI Demo](desktop/mockups/demo-animated.gif)
+
+![Dashboard Demo](desktop/mockups/dashboard-demo.gif)
+
+## Why
+
+No existing platform combines:
+- **Local-only operation** (air-gapped, GDPR-compliant)
+- **Agent orchestration** (multi-agent with formal handoffs)
+- **Observability** (audit trail, cost tracking, health)
+- **Quality gates** (behavioural tests for agents)
+- **Regulated industry readiness** (compliance docs, model cards)
+
+## Quick Start
+
+```bash
+# Install
+pip install agent-foundry
+
+# Or from source
+git clone <repo-url>
+cd agent-foundry
+pip install -e ".[dev]"
+
+# Start an agent
+foundry agent start builder --model qwen-8b --tools terminal,file
+
+# Run a task
+foundry agent run builder "Create a test file"
+
+# Hand off to a reviewer
+foundry agent start reviewer --model qwen-8b --tools terminal,file
+foundry handoff create --from builder --to reviewer --task "Review the work"
+
+# Check quality gates
+foundry gate run --agent builder --file output.txt
+
+# Export audit log
+foundry audit export --output compliance-report.json
+```
+
+## Architecture
+
+Six layers, running entirely on your machine:
+
+```
+Desktop UI (Tauri) ·················· [Phase 2]
+CLI (`foundry`) ····················· [MVP ✓]
+Agent Engine · Handoff Protocol ★ · Quality Gates · Observability
+Model Runtime (oMLX · llama.cpp · Ollama)
+Tool Registry (MCP · Hermes skills)
+Storage (SQLite)
+```
+
+**The handoff protocol** is the core differentiator — a formal standard for agents to pass work between each other with full state preservation and verification. Every handoff is auditable.
+
+## For Regulated Industries
+
+Pre-built compliance documentation included in `docs/compliance/`:
+- **DPIA Template** — Data Protection Impact Assessment
+- **Model Cards** — Per-model capability and limitation documentation
+- **GDPR Checklist** — Article-by-article compliance verification
+- **NHS DTAC Alignment** — Digital Technology Assessment Criteria mapping
+- **ISO 27001 Control Mapping** — All 71 Annex A controls mapped
+- **Deployment Architecture** — On-prem deployment patterns, data flows
+
+Zero cloud dependency. Air-gap capable. No data leaves your device.
+
+## Requirements
+
+- Python 3.11+
+- macOS (Apple Silicon), Linux, or Windows
+- 16GB+ RAM (32GB recommended for 8B+ models)
+- No network required (offline operation after model download)
+
+## Model Backends
+
+| Backend | Status | Notes |
+|---------|--------|-------|
+| oMLX | ✅ Supported | Apple Silicon, local inference |
+| llama.cpp | ✅ Supported | Cross-platform GGUF models |
+| Ollama | ✅ Supported | Easy model management |
+| Dummy | ✅ Testing | Simulated backend for tests |
+
+## Commands
+
+```
+foundry agent start|stop|list|stats|run    Manage agents
+foundry handoff create|accept|complete|list|show    Formal work transfer
+foundry gate run                          Quality checks
+foundry skill discover|list|show          Agent skills
+foundry audit show|export|stats           Audit trail
+foundry backend health|models|test        Backend management
+```
+
+## Development
+
+```bash
+pip install -e ".[dev]"
+pytest                    # 163 tests
+foundry --help            # CLI reference
+```
+
+## Documentation
+
+- [Architecture](docs/architecture.md) — Full system design
+- [Compliance Pack](docs/compliance/) — Regulated industry procurement docs
+- [Getting Started](docs/getting-started.md) — Setup and first agent workflow
+
+## Roadmap
+
+- [x] CLI MVP — agent engine, handoff, gates, audit
+- [x] Compliance pack — NHS, GDPR, ISO 27001
+- [x] M365 Bridge — SharePoint, Teams, Graph API integration
+- [x] Multi-machine orchestration
+- [x] Cloud model fallback (opt-in)
+- [ ] Desktop UI (Tauri) — dashboard, logs, model management
+
+## License
+
+MIT — see [LICENSE](LICENSE)

agent_foundry_local-0.1.8/docs/README.md

@@ -0,0 +1,11 @@
+# Documentation — Local Agent Foundry
+
+- **[Getting Started](getting-started.md)** — Set up and run your first multi-agent workflow
+- **[Architecture](architecture.md)** — Full system design, layers, and competitive landscape
+- **[Compliance Pack](compliance/)** — Regulated industry procurement documentation
+  - [DPIA Template](compliance/dpia-template.md)
+  - [Model Card Template](compliance/model-card-template.md)
+  - [GDPR Checklist](compliance/gdpr-checklist.md)
+  - [NHS DTAC Alignment](compliance/nhs-dtac-alignment.md)
+  - [ISO 27001 Control Mapping](compliance/iso27001-control-mapping.md)
+  - [Deployment Architecture](compliance/deployment-architecture.md)