plasticity-agent 0.2.0__tar.gz

plasticity_agent-0.2.0/.gitignore

@@ -0,0 +1,58 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+
+# Virtual environments
+.venv/
+venv/
+env/
+ENV/
+
+# uv
+.uv/
+
+# Test / coverage
+.pytest_cache/
+.coverage
+.coverage.*
+htmlcov/
+.mypy_cache/
+.ruff_cache/
+
+# Plasticity runtime artifacts (local-first state).
+# NOTE: these are anchored to the repo root with a leading slash so they do NOT
+# match the source package directory plasticity_agent/memory/ (an unanchored
+# "memory/" would make the build backend drop the package from the wheel).
+/memory/
+/agent_runs/
+*.sqlite
+*.sqlite3
+*.db
+
+# Editors / OS
+.vscode/
+.idea/
+.DS_Store
+
+# Docs build
+site/

plasticity_agent-0.2.0/CHANGELOG.md

@@ -0,0 +1,53 @@
+# Changelog
+
+All notable changes to this project are documented here. The format is based on
+[Keep a Changelog](https://keepachangelog.com/), and this project adheres to
+[Semantic Versioning](https://semver.org/).
+
+## [0.2.0] - 2026-06-07
+
+### Added
+
+- **LLM-powered upgrades** behind a single `llm_callback` (provider-agnostic, no SDK
+  dependency): model-authored reflection, semantic contradiction/entailment scoring
+  (`ContradictionChecker`), an `LLMCritic` in the reasoning market, and LLM self-refine. Every
+  path falls back to the deterministic baseline on failure.
+- **Hybrid lexical + vector retrieval**: pluggable `EmbeddingBackend`
+  (`HashingEmbeddingBackend` with zero dependencies, optional `SentenceTransformerBackend`, and
+  `CallableEmbeddingBackend`), embeddings persisted in SQLite, a NumPy-accelerated `VectorIndex`
+  with an optional `FaissVectorIndex`, and `(1-α)·lexical + α·cosine` recall.
+- **Opt-in sandboxed self-healing**: `Sandbox.apply(plan, RepairConsent(...))` can execute narrow,
+  reversible repairs (allowlisted `pip install` of a validated package, no shell, timeout, dry-run
+  default). `agent.apply_repair(...)` and `plasticity apply`.
+- **Cross-run improvement metrics**: `ImprovementTracker`, `agent.checkpoint()` and
+  `agent.improvement()`, persisted to `metrics.sqlite`, plus `plasticity metrics`.
+- **OpenTelemetry export**: `OTelExporter` and `PlasticAgent(otel=True)` stream trace events as
+  spans.
+- **Richer consolidation**: embedding-aware clustering, near-duplicate merge (`duplicates_merged`),
+  and constitutional-memory governance (`constitution_conflicts`).
+- First-class, tested framework adapters (LangGraph / CrewAI / OpenAI-Agents / Pydantic-AI).
+- `otel` optional-dependency extra.
+
+### Changed
+
+- Self-healing is no longer advisory-only: narrow, reversible repairs are now
+  `auto_apply_allowed` but still require explicit consent to execute.
+- SQLite stores are now concurrency-safe (WAL journaling, a guarding lock, retry-on-busy,
+  `check_same_thread=False`) and safe to share across threads.
+- `SleepReport` gained `duplicates_merged` and `constitution_conflicts` fields.
+
+### Fixed
+
+- Full `mypy` clean across all source files.
+
+## [0.1.0] - 2026-06-06
+
+### Added
+
+- Initial release: neuroplastic memory (`MemoryOS`, 5 memory types, plasticity signals),
+  deterministic memory-quality scoring, salience, heuristic contradiction detection, decay /
+  forgetting, sleep-like consolidation (`SleepReport`), Reflexion-style reflection, Self-Refine,
+  advisory self-healing (diagnosis + repair plans), a six-critic reasoning market with an auction,
+  a Voyager-style skill library, thermodynamic-style energy reporting, the `PlasticAgent` runtime,
+  JSONL tracing, a Typer + Rich CLI, a FastAPI server, a Streamlit dashboard, and framework
+  adapters.

plasticity_agent-0.2.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Plasticity Agent Authors
+
+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.