evolution-sdk 0.8.0__py3-none-any.whl

evolution/validator.py

@@ -0,0 +1,55 @@
+"""
+Manifest validator conforming to Intelligence Manifest Specification v1.0.
+"""
+
+from __future__ import annotations
+
+import re
+from typing import TYPE_CHECKING
+
+from evolution.exceptions import ManifestValidationError
+
+if TYPE_CHECKING:
+    from evolution.models.manifest import Manifest
+
+SEMVER_PATTERN = re.compile(r"^\d+\.\d+\.\d+(-[0-9A-Za-z.-]+)?(\+[0-9A-Za-z.-]+)?$")
+VALID_ARTIFACT_TYPES = {"prompt", "memory", "retrieval", "tool", "model_config", "policy"}
+
+
+def validate_manifest(manifest: Manifest) -> None:
+    """Validates that a Manifest instance strictly adheres to Spec v1.0.
+    Raises ManifestValidationError if any violations are found.
+    """
+    errors: list[str] = []
+
+    # 1. Version validation
+    if not manifest.version or not manifest.version.strip():
+        errors.append("manifest 'version' is required and cannot be empty")
+    elif not SEMVER_PATTERN.match(manifest.version):
+        errors.append(f"manifest 'version' '{manifest.version}' is not valid semantic versioning (e.g. 1.0.0)")
+
+    # 2. Name validation
+    if not manifest.name or not manifest.name.strip():
+        errors.append("manifest 'name' is required and cannot be empty")
+
+    # 3. Artifact validations
+    for art in manifest.artifacts.all():
+        if not art.type:
+            errors.append(f"artifact '{art.name}' has missing type")
+        elif art.type not in VALID_ARTIFACT_TYPES:
+            errors.append(f"artifact '{art.name}' has invalid type '{art.type}' (must be one of {sorted(VALID_ARTIFACT_TYPES)})")
+
+        if not art.name or not art.name.strip():
+            errors.append(f"found artifact of type '{art.type}' with empty name")
+
+    # 4. Model Config specific validation
+    if manifest.artifacts.model_config:
+        mc = manifest.artifacts.model_config
+        if not mc.model or not mc.model.strip():
+            errors.append("model_config artifact requires a non-empty 'model' field")
+
+    if errors:
+        raise ManifestValidationError(
+            f"Manifest validation failed with {len(errors)} error(s)",
+            errors=errors,
+        )

evolution_sdk-0.8.0.dist-info/METADATA

@@ -0,0 +1,240 @@
+Metadata-Version: 2.4
+Name: evolution-sdk
+Version: 0.8.0
+Summary: Python SDK for Evolution — AI-Native Version Control Platform
+Author-email: "Urvish.A.Prajapati" <prajapatiurvish712@gmail.com>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/Urvish0/Evolution
+Project-URL: Repository, https://github.com/Urvish0/Evolution
+Project-URL: Specification, https://github.com/Urvish0/Evolution/blob/main/spec/intelligence-manifest-v1.0.md
+Keywords: ai,version-control,llm,manifest,evaluation,langchain,llamaindex
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Classifier: Topic :: Software Development :: Version Control
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0; extra == "dev"
+Dynamic: license-file
+
+# Evolution Python SDK (`evolution-sdk`)
+
+> **"Version Intelligence, Not Code."**
+
+[![PyPI Version](https://img.shields.io/badge/pypi-v0.8.0-blue.svg)](https://pypi.org/project/evolution-sdk/)
+[![Python Versions](https://img.shields.io/badge/python-3.10%20%7C%203.11%20%7C%203.12%20%7C%203.13-blue)](https://pypi.org/project/evolution-sdk/)
+[![License](https://img.shields.io/badge/license-MIT-green.svg)](https://github.com/Urvish0/Evolution/blob/main/LICENSE)
+[![Zero Dependencies](https://img.shields.io/badge/dependencies-0%20runtime-brightgreen.svg)](#features)
+
+The official Python SDK for **[Evolution](https://github.com/Urvish0/Evolution)** — an open-source, AI-native version control platform.
+
+While traditional version control systems (like Git) track line-by-line changes to text files, **Evolution tracks and versions Intelligence**: the complete operational state of an AI system (system prompts, sampling parameters, memory strategies, vector store retrieval configurations, tool schemas, and guardrails).
+
+---
+
+## ⚡ Key Features
+
+- 🪶 **Zero Runtime Dependencies**: Pure Python implementation with zero third-party dependencies. Ultra-fast, lightweight, and won't conflict with your environment.
+- 🎯 **Automatic Intelligence Capture**: Use the `@evolution.track` decorator to automatically extract docstring prompts, model hyperparameters, token consumption, and latency.
+- ⏱️ **Precision Execution Telemetry**: Record execution traces, inputs, outputs, and hardware latency using `@track` or the `evolution.record` context manager.
+- 🔌 **Universal Framework Adapters**: Seamlessly introspect and export standard Intelligence Manifests from **LangChain**, **LlamaIndex**, **CrewAI**, and direct OpenAI / Anthropic client calls.
+- 🔒 **Git-Compatible CAS Blobs**: Content-Addressable Storage with auto-computed SHA-256 Merkle hashes.
+- 📋 **Intelligence Manifest Spec v1.0 Compliant**: Native support for creating, validating, and saving standard `evolution.manifest.json` schemas.
+
+---
+
+## 📦 Installation
+
+Install `evolution-sdk` via `pip` or `uv`:
+
+```bash
+pip install evolution-sdk
+```
+
+Or using `uv`:
+
+```bash
+uv add evolution-sdk
+```
+
+---
+
+## 🚀 Quickstart in 30 Seconds
+
+### 1. Initialize or Open an Evolution Repository
+
+```python
+import evolution as evo
+
+# Initialize a new Evolution repository in the current directory
+repo = evo.Repository.init("./my_ai_agent")
+
+# Or open an existing repository
+# repo = evo.Repository.open("./my_ai_agent")
+```
+
+---
+
+### 2. Automatic Intelligence Tracking with `@evo.track`
+
+Decorate your AI agent functions. Evolution automatically extracts the docstring as the system prompt, registers model configs, measures latency, and logs execution tokens without modifying your business logic:
+
+```python
+from openai import OpenAI
+import evolution as evo
+
+client = OpenAI()
+repo = evo.Repository.init("./my_agent")
+
+@evo.track(
+    repo=repo,
+    name="customer-support-agent",
+    model="gpt-4o",
+    temperature=0.2,
+)
+def handle_customer_inquiry(user_message: str):
+    """Senior Customer Support Specialist. Always maintain professional tone and provide step-by-step guidance."""
+    response = client.chat.completions.create(
+        model="gpt-4o",
+        temperature=0.2,
+        messages=[
+            {"role": "system", "content": "You are a Senior Customer Support Specialist."},
+            {"role": "user", "content": user_message}
+        ]
+    )
+    return response
+
+# Run your agent
+result = handle_customer_inquiry("How do I reset my API key?")
+
+# Commit the captured intelligence snapshot
+repo.commit("feat: initial customer support intelligence snapshot")
+```
+
+---
+
+### 3. Precision Latency & Execution Recording with `record()`
+
+For fine-grained telemetry or manual pipelines, use the `record` context manager:
+
+```python
+import evolution as evo
+
+repo = evo.Repository.open(".")
+
+with evo.record(repo, metadata={"phase": "testing"}) as ctx:
+    # Set inputs
+    ctx.set_inputs("User asked: Explain Merkle trees.")
+    
+    # Execute your LLM call
+    response_text = "A Merkle tree is a cryptographic tree structure..."
+    
+    # Record outputs and token metrics
+    ctx.set_outputs(response_text)
+    ctx.set_tokens(prompt_tokens=42, completion_tokens=128)
+
+print(f"Recorded execution with duration: {ctx.execution.duration_ms} ms")
+```
+
+---
+
+## 🔌 Framework Adapters
+
+Evolution provides plug-and-play adapters to export standard Intelligence Manifests directly from your existing AI framework abstractions:
+
+### LangChain Adapter
+```python
+from langchain_openai import ChatOpenAI
+from langchain_core.prompts import ChatPromptTemplate
+from evolution.adapters import LangChainAdapter
+
+prompt = ChatPromptTemplate.from_template("Summarize the following legal document: {doc}")
+llm = ChatOpenAI(model="gpt-4o", temperature=0.1)
+chain = prompt | llm
+
+manifest = LangChainAdapter.from_langchain(chain, name="legal-summarizer")
+print(manifest.to_dict())
+```
+
+### LlamaIndex Adapter
+```python
+from llama_index.core import VectorStoreIndex
+from evolution.adapters import LlamaIndexAdapter
+
+manifest = LlamaIndexAdapter.from_llamaindex(
+    index=my_vector_index,
+    name="financial-rag-agent",
+    similarity_top_k=5,
+)
+```
+
+### CrewAI Adapter
+```python
+from crewai import Agent, Crew, Task
+from evolution.adapters import CrewAIAdapter
+
+manifest = CrewAIAdapter.from_crewai(my_crew, name="research-crew")
+```
+
+---
+
+## 📋 The Intelligence Manifest Format (`evolution.manifest.json`)
+
+Evolution stores your complete AI system state in a portable, framework-agnostic manifest following the **[Intelligence Manifest Specification v1.0](https://github.com/Urvish0/Evolution/blob/main/spec/intelligence-manifest-v1.0.md)**:
+
+```json
+{
+  "version": "1.0.0",
+  "name": "legal-dispute-resolution-system",
+  "description": "AI system powered by Evolution version control",
+  "artifacts": {
+    "prompts": [
+      {
+        "type": "prompt",
+        "name": "strict-legal-analyst-prompt",
+        "description": "Extracted docstring prompt",
+        "role": "system",
+        "format": "text"
+      }
+    ],
+    "model_config": {
+      "type": "model_config",
+      "name": "analyst-model",
+      "model": "qwen/qwen3.8-27b",
+      "provider": "local",
+      "temperature": 0.1
+    }
+  }
+}
+```
+
+---
+
+## 🧪 Running Tests
+
+To run the SDK test suite:
+
+```bash
+pytest sdk/python/tests/ -v
+```
+
+---
+
+## 📄 License
+
+This project is licensed under the **MIT License** — see the [LICENSE](LICENSE) file for details.
+
+---
+
+## 🌐 Links
+
+- **GitHub Repository:** [https://github.com/Urvish0/Evolution](https://github.com/Urvish0/Evolution)
+- **Specification:** [Intelligence Manifest Spec v1.0](https://github.com/Urvish0/Evolution/blob/main/spec/intelligence-manifest-v1.0.md)
+- **Documentation:** [Technical Manual](https://github.com/Urvish0/Evolution/blob/main/DOCUMENTATION.md)

evolution_sdk-0.8.0.dist-info/RECORD

@@ -0,0 +1,25 @@
+evolution/__init__.py,sha256=NoxLSVCVrVDVafpNzjth7AJpdIn9lzL-neYa4uX94C8,2331
+evolution/evaluators.py,sha256=P7k886MdF1wF5EbAMOmaxHnTR-z3FV6aQySb2BSsBpw,9979
+evolution/exceptions.py,sha256=nuF-P8uviuC-k7p35AfD5AfDB4ZGblp9GqjYyNYmjtQ,1559
+evolution/repository.py,sha256=oVa2nt4s5TXP5N8gBDnKjgFbW0yA777PURpt_VwFBbI,13426
+evolution/validator.py,sha256=HDVrf8MgKhwYgWG862jy_VmOu6qRmGsZJZesgOfdw7A,2083
+evolution/adapters/__init__.py,sha256=d-MYNaa7Bj_nMqQDOPF3rZLTd6dvziibiCA_rAVXltU,685
+evolution/adapters/base.py,sha256=cQ9fwdV66WDJiMZe8PfPbka3pN2wwKey1bgMThmFmpA,592
+evolution/adapters/crewai.py,sha256=8Qrgr0YXc16RBrXKCax31G0Bwu9oW1xMM_rzL3-t93Q,3257
+evolution/adapters/direct.py,sha256=gT-n0_UpMP4g7_IfkjZz-rq4CBd-Flrsid42nKsDkvE,4673
+evolution/adapters/langchain.py,sha256=_UZBd2fFUiTWnzCqkGS4e9sgm_N4asaokJvo7KlURrQ,4296
+evolution/adapters/llamaindex.py,sha256=uRk5FJtOjERMP0aS63CbkWuVw5n-kUhhE6yG7lqeX5Q,3812
+evolution/capture/__init__.py,sha256=mgm5VJ4FSG-47266tnoBhIF4rI8giPE6d4ECgkKhpXU,556
+evolution/capture/introspect.py,sha256=GaWgyH-3xmkV0rKl-rzyhehHP1cgjr_u4wJU395Pmnc,6083
+evolution/capture/recorder.py,sha256=h5mr7XsaGtVERg2xRHfzKxpRdpDAvwyPWGqhaT_OpsM,3666
+evolution/capture/tracker.py,sha256=oo_n5fgiiUpmOgQ1_wHNiQrO9Lubjo1YKVGTjsEjn6k,7349
+evolution/models/__init__.py,sha256=_hrP5Hv3pr77PkKhtGYZhjLsZAnLH7d7QWVWtPIOBkg,913
+evolution/models/artifacts.py,sha256=HJClVHkoSmnLlkw0I-38og7Vq9Rzq_Qp8cxDjlzssVw,8084
+evolution/models/evaluation.py,sha256=Bnex4cqUKzjXPEBhFiUZQYF7itUAT6b7p8ifyJFIdRw,2417
+evolution/models/execution.py,sha256=y7CLEJhYgXyMxUB7IA1tvvZPSZkzpnpq3AO4--5tf1I,2551
+evolution/models/manifest.py,sha256=-laZ8S_0DIOX4cGgUSeunDm4pU9QtXkr3G0rbEi3aUQ,8804
+evolution_sdk-0.8.0.dist-info/licenses/LICENSE,sha256=HD5ahlAJyKJl5UKCaolDIrkypthJLeW2Ubo2_SVAJUA,1107
+evolution_sdk-0.8.0.dist-info/METADATA,sha256=qg0rvU3eyJYDdlM7s_L-0ozklJxb2YInrRp2B25OktY,8275
+evolution_sdk-0.8.0.dist-info/WHEEL,sha256=YVMoNqKzERt-wjUZwJ33xBGAwnFl-4cqbYkTtWa4itE,91
+evolution_sdk-0.8.0.dist-info/top_level.txt,sha256=gW3pWW6BWlvnuBZ0UUaTfFXmsO2ln3T2GXAWfmlzr-s,10
+evolution_sdk-0.8.0.dist-info/RECORD,,

evolution_sdk-0.8.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (84.0.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

evolution_sdk-0.8.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Urvish A. Prajapati (prajapatiurvish712@gmail.com)
+
+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.

evolution_sdk-0.8.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+evolution