connector-agent-oss 0.2.0__tar.gz

connector_agent_oss-0.2.0/PKG-INFO

@@ -0,0 +1,137 @@
+Metadata-Version: 2.4
+Name: connector-agent-oss
+Version: 0.2.0
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: Apache Software License
+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
+Classifier: Programming Language :: Rust
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Classifier: Topic :: Security
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Typing :: Typed
+Requires-Dist: pytest>=7.0 ; extra == 'dev'
+Requires-Dist: maturin>=1.4 ; extra == 'dev'
+Requires-Dist: twine ; extra == 'dev'
+Provides-Extra: dev
+Summary: Tamper-proof memory, chain-of-custody, and OS-grade runtime for AI agents
+Keywords: ai,agents,memory,compliance,hipaa,soc2,gdpr,audit,llm,trust,tamper-proof,chain-of-custody,deepseek,openai,anthropic,policy,firewall,multi-agent,pipeline,knowledge-graph,rag
+Author: Connector OSS Contributors
+License: Apache-2.0
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown; charset=UTF-8; variant=GFM
+Project-URL: Bug Tracker, https://github.com/GlobalSushrut/connector-oss/issues
+Project-URL: Changelog, https://github.com/GlobalSushrut/connector-oss/blob/main/CHANGELOG.md
+Project-URL: Documentation, https://github.com/GlobalSushrut/connector-oss/blob/main/QUICKSTART.md
+Project-URL: Homepage, https://github.com/GlobalSushrut/connector-oss
+Project-URL: Repository, https://github.com/GlobalSushrut/connector-oss
+
+# connector-oss — Python SDK
+
+> Tamper-proof memory, chain-of-custody, and OS-grade runtime for AI agents.
+> Native Rust kernel via PyO3 — ~140 methods, zero Python overhead.
+
+## Install
+
+```bash
+pip install connector-oss
+```
+
+Prebuilt wheels available for:
+- Linux x86_64 / aarch64
+- macOS x86_64 / Apple Silicon (aarch64)
+- Windows x86_64
+
+## Quick Start
+
+```python
+import os
+from connector_oss import Connector
+
+# 3 lines: agent with trusted memory
+c = Connector("deepseek", "deepseek-chat", os.environ["DEEPSEEK_API_KEY"])
+result = c.agent("bot", "You are helpful").run("Hello!", "user:alice")
+
+print(result.text)         # LLM response
+print(result.trust)        # 0-100 kernel-verified trust score
+print(result.trust_grade)  # "A+" | "A" | "B" | "C" | "D" | "F"
+```
+
+### From YAML Config
+
+```python
+c = Connector.from_config("connector.yaml")
+```
+
+## Memory & Knowledge
+
+```python
+# Write tamper-proof memory (CID-addressed)
+c.memory_write("pid:bot", "text", "Patient has fever", "user:nurse", "ns:er")
+
+# Search memory
+packets = c.search_namespace("ns:er", limit=10)
+
+# Knowledge graph + RAG
+c.knowledge_ingest("ns:er")
+ctx = c.rag_retrieve("pid:bot", "ns:er", entities=["fever"], max_facts=10)
+
+# Cognitive cycle
+report = c.cognitive_cycle("pid:bot", "ns:er", "Diagnose patient")
+```
+
+## Multi-Agent Pipeline
+
+```python
+pipe = c.pipeline("support")
+pipe.agent("triage", "Classify tickets")
+pipe.agent("resolver", "Find answers")
+pipe.route("triage -> resolver")
+pipe.hipaa()
+
+result = pipe.run("My account is locked", user="user:bob")
+print(result.to_json())   # machine-parseable with provenance tags
+```
+
+## Custom Folders (OS mkdir model)
+
+```python
+c.create_agent_folder("nurse", "notes", "Patient notes")
+c.folder_put("agent:nurse/notes", "p123", '{"bp": "140/90"}')
+val = c.folder_get("agent:nurse/notes", "p123")
+```
+
+## Observability
+
+```python
+result.to_json()       # every field tagged with source (kernel/llm/derived/user)
+result.to_otel()       # OTLP-compatible trace export
+result.to_llm()        # LLM-friendly summary
+result.provenance()    # {"kernel_verified": 5, "trust_percentage": 100.0}
+result.is_verified()   # True = zero-fake guarantee
+```
+
+## What Makes This Different
+
+| | LangChain | CrewAI | **connector-oss** |
+|-|-----------|--------|-------------------|
+| Tamper-proof memory | ❌ | ❌ | ✅ CID-addressed, kernel-verified |
+| Audit trail | ❌ | ❌ | ✅ Ed25519-signed, append-only |
+| HIPAA/SOC2/GDPR | ❌ | ❌ | ✅ Built-in compliance |
+| Trust scoring | ❌ | ❌ | ✅ Per-response, 0-100 |
+| Policy enforcement | ❌ | ❌ | ✅ Non-bypassable 5-layer guard |
+
+## Links
+
+- [QUICKSTART.md](https://github.com/GlobalSushrut/connector-oss/blob/main/QUICKSTART.md)
+- [ARCHITECTURE.md](https://github.com/GlobalSushrut/connector-oss/blob/main/ARCHITECTURE.md)
+- [GitHub](https://github.com/GlobalSushrut/connector-oss)
+
+## License
+
+Apache-2.0
+

connector_agent_oss-0.2.0/README.md

@@ -0,0 +1,104 @@
+# connector-oss — Python SDK
+
+> Tamper-proof memory, chain-of-custody, and OS-grade runtime for AI agents.
+> Native Rust kernel via PyO3 — ~140 methods, zero Python overhead.
+
+## Install
+
+```bash
+pip install connector-oss
+```
+
+Prebuilt wheels available for:
+- Linux x86_64 / aarch64
+- macOS x86_64 / Apple Silicon (aarch64)
+- Windows x86_64
+
+## Quick Start
+
+```python
+import os
+from connector_oss import Connector
+
+# 3 lines: agent with trusted memory
+c = Connector("deepseek", "deepseek-chat", os.environ["DEEPSEEK_API_KEY"])
+result = c.agent("bot", "You are helpful").run("Hello!", "user:alice")
+
+print(result.text)         # LLM response
+print(result.trust)        # 0-100 kernel-verified trust score
+print(result.trust_grade)  # "A+" | "A" | "B" | "C" | "D" | "F"
+```
+
+### From YAML Config
+
+```python
+c = Connector.from_config("connector.yaml")
+```
+
+## Memory & Knowledge
+
+```python
+# Write tamper-proof memory (CID-addressed)
+c.memory_write("pid:bot", "text", "Patient has fever", "user:nurse", "ns:er")
+
+# Search memory
+packets = c.search_namespace("ns:er", limit=10)
+
+# Knowledge graph + RAG
+c.knowledge_ingest("ns:er")
+ctx = c.rag_retrieve("pid:bot", "ns:er", entities=["fever"], max_facts=10)
+
+# Cognitive cycle
+report = c.cognitive_cycle("pid:bot", "ns:er", "Diagnose patient")
+```
+
+## Multi-Agent Pipeline
+
+```python
+pipe = c.pipeline("support")
+pipe.agent("triage", "Classify tickets")
+pipe.agent("resolver", "Find answers")
+pipe.route("triage -> resolver")
+pipe.hipaa()
+
+result = pipe.run("My account is locked", user="user:bob")
+print(result.to_json())   # machine-parseable with provenance tags
+```
+
+## Custom Folders (OS mkdir model)
+
+```python
+c.create_agent_folder("nurse", "notes", "Patient notes")
+c.folder_put("agent:nurse/notes", "p123", '{"bp": "140/90"}')
+val = c.folder_get("agent:nurse/notes", "p123")
+```
+
+## Observability
+
+```python
+result.to_json()       # every field tagged with source (kernel/llm/derived/user)
+result.to_otel()       # OTLP-compatible trace export
+result.to_llm()        # LLM-friendly summary
+result.provenance()    # {"kernel_verified": 5, "trust_percentage": 100.0}
+result.is_verified()   # True = zero-fake guarantee
+```
+
+## What Makes This Different
+
+| | LangChain | CrewAI | **connector-oss** |
+|-|-----------|--------|-------------------|
+| Tamper-proof memory | ❌ | ❌ | ✅ CID-addressed, kernel-verified |
+| Audit trail | ❌ | ❌ | ✅ Ed25519-signed, append-only |
+| HIPAA/SOC2/GDPR | ❌ | ❌ | ✅ Built-in compliance |
+| Trust scoring | ❌ | ❌ | ✅ Per-response, 0-100 |
+| Policy enforcement | ❌ | ❌ | ✅ Non-bypassable 5-layer guard |
+
+## Links
+
+- [QUICKSTART.md](https://github.com/GlobalSushrut/connector-oss/blob/main/QUICKSTART.md)
+- [ARCHITECTURE.md](https://github.com/GlobalSushrut/connector-oss/blob/main/ARCHITECTURE.md)
+- [GitHub](https://github.com/GlobalSushrut/connector-oss)
+
+## License
+
+Apache-2.0

connector_agent_oss-0.2.0/aapi/Cargo.toml

@@ -0,0 +1,87 @@
+[workspace]
+resolver = "2"
+members = [
+    "crates/aapi-core",
+    "crates/aapi-crypto",
+    "crates/aapi-indexdb",
+    "crates/aapi-gateway",
+    "crates/aapi-adapters",
+    "crates/aapi-metarules",
+    "crates/aapi-sdk",
+    "crates/aapi-cli",
+    "crates/aapi-pipeline",
+    "crates/aapi-federation",
+]
+
+[workspace.package]
+version = "0.1.0"
+edition = "2021"
+authors = ["AAPI Contributors"]
+license = "Apache-2.0"
+repository = "https://github.com/GlobalSushrut/connector-oss"
+rust-version = "1.75"
+
+[workspace.dependencies]
+# Serialization
+serde = { version = "1.0", features = ["derive"] }
+serde_json = "1.0"
+serde_with = "3.0"
+
+# Cryptography
+ed25519-dalek = { version = "2.1", features = ["serde", "rand_core"] }
+sha2 = "0.10"
+rand = "0.8"
+base64 = "0.22"
+hex = "0.4"
+
+# Async runtime
+tokio = { version = "1.35", features = ["full"] }
+async-trait = "0.1"
+futures = "0.3"
+
+# HTTP/API
+axum = { version = "0.7", features = ["macros"] }
+tower = { version = "0.4", features = ["timeout"] }
+tower-http = { version = "0.5", features = ["cors", "trace", "compression-gzip"] }
+hyper = { version = "1.0", features = ["full"] }
+reqwest = { version = "0.11", features = ["json", "rustls-tls"] }
+
+# Database
+sqlx = { version = "0.7", features = ["runtime-tokio", "sqlite", "postgres", "uuid", "chrono", "json"] }
+
+# Validation & Schema
+jsonschema = "0.18"
+uuid = { version = "1.6", features = ["v4", "v7", "serde"] }
+chrono = { version = "0.4", features = ["serde"] }
+
+# Tracing & Observability
+tracing = "0.1"
+tracing-subscriber = { version = "0.3", features = ["env-filter", "json"] }
+opentelemetry = "0.21"
+opentelemetry-otlp = "0.14"
+
+# Error handling
+thiserror = "1.0"
+anyhow = "1.0"
+
+# Configuration
+config = "0.14"
+dotenvy = "0.15"
+
+# CLI
+clap = { version = "4.4", features = ["derive", "env"] }
+
+# Testing
+tokio-test = "0.4"
+wiremock = "0.5"
+tempfile = "3.9"
+assert-json-diff = "2.0"
+
+[profile.release]
+lto = true
+codegen-units = 1
+panic = "abort"
+strip = true
+
+[profile.dev]
+debug = true

connector_agent_oss-0.2.0/aapi/crates/aapi-core/Cargo.toml

@@ -0,0 +1,22 @@
+[package]
+name = "aapi-core"
+description = "AAPI Core - VĀKYA schema, Sandhi canonicalization, and validation"
+version.workspace = true
+edition.workspace = true
+authors.workspace = true
+license.workspace = true
+
+[dependencies]
+serde = { workspace = true }
+serde_json = { workspace = true }
+serde_with = { workspace = true }
+uuid = { workspace = true }
+chrono = { workspace = true }
+thiserror = { workspace = true }
+jsonschema = { workspace = true }
+sha2 = { workspace = true }
+hex = { workspace = true }
+
+[dev-dependencies]
+tokio-test = { workspace = true }
+assert-json-diff = { workspace = true }

connector_agent_oss-0.2.0/aapi/crates/aapi-core/src/error.rs

@@ -0,0 +1,108 @@
+//! Error types for AAPI Core
+
+use thiserror::Error;
+
+/// Core errors that can occur during AAPI operations
+#[derive(Error, Debug)]
+pub enum AapiError {
+    #[error("Validation error: {0}")]
+    Validation(String),
+
+    #[error("Canonicalization error: {0}")]
+    Canonicalization(String),
+
+    #[error("Schema error: {0}")]
+    Schema(String),
+
+    #[error("Missing required field: {0}")]
+    MissingField(String),
+
+    #[error("Invalid field value for '{field}': {reason}")]
+    InvalidField { field: String, reason: String },
+
+    #[error("Capability error: {0}")]
+    Capability(String),
+
+    #[error("Authorization denied: {0}")]
+    AuthorizationDenied(String),
+
+    #[error("Budget exceeded: {resource} used {used}, limit {limit}")]
+    BudgetExceeded {
+        resource: String,
+        used: u64,
+        limit: u64,
+    },
+
+    #[error("TTL expired: expired at {expired_at}")]
+    TtlExpired { expired_at: String },
+
+    #[error("Scope violation: action '{action}' not in allowed scope")]
+    ScopeViolation { action: String },
+
+    #[error("Serialization error: {0}")]
+    Serialization(#[from] serde_json::Error),
+
+    #[error("Internal error: {0}")]
+    Internal(String),
+}
+
+/// Result type alias for AAPI operations
+pub type AapiResult<T> = Result<T, AapiError>;
+
+/// Reason codes for PRAMĀṆA receipts
+#[derive(Debug, Clone, Copy, PartialEq, Eq, serde::Serialize, serde::Deserialize)]
+#[serde(rename_all = "SCREAMING_SNAKE_CASE")]
+pub enum ReasonCode {
+    /// Action completed successfully
+    Success,
+    /// Action completed with partial success
+    PartialSuccess,
+    /// Action failed due to validation error
+    ValidationFailed,
+    /// Action denied due to authorization
+    AuthorizationDenied,
+    /// Action denied due to capability scope
+    ScopeViolation,
+    /// Action denied due to budget exhaustion
+    BudgetExceeded,
+    /// Action denied due to TTL expiration
+    TtlExpired,
+    /// Action denied by MetaRule policy
+    PolicyDenied,
+    /// Action requires human approval
+    ApprovalRequired,
+    /// Action failed due to adapter error
+    AdapterError,
+    /// Action failed due to target system error
+    TargetError,
+    /// Action timed out
+    Timeout,
+    /// Action was cancelled
+    Cancelled,
+    /// Internal system error
+    InternalError,
+}
+
+impl ReasonCode {
+    /// Returns true if this is a success code
+    pub fn is_success(&self) -> bool {
+        matches!(self, ReasonCode::Success | ReasonCode::PartialSuccess)
+    }
+
+    /// Returns true if this is a denial code
+    pub fn is_denial(&self) -> bool {
+        matches!(
+            self,
+            ReasonCode::AuthorizationDenied
+                | ReasonCode::ScopeViolation
+                | ReasonCode::BudgetExceeded
+                | ReasonCode::TtlExpired
+                | ReasonCode::PolicyDenied
+        )
+    }
+
+    /// Returns true if this requires human intervention
+    pub fn requires_human(&self) -> bool {
+        matches!(self, ReasonCode::ApprovalRequired)
+    }
+}

connector_agent_oss-0.2.0/aapi/crates/aapi-core/src/lib.rs

@@ -0,0 +1,16 @@
+//! AAPI Core - VĀKYA Schema, Sandhi Canonicalization, and Validation
+//!
+//! This crate provides the foundational types and algorithms for the
+//! Agentic Action Protocol Interface (AAPI).
+
+pub mod vakya;
+pub mod sandhi;
+pub mod validation;
+pub mod error;
+pub mod types;
+
+pub use vakya::*;
+pub use sandhi::*;
+pub use validation::*;
+pub use error::*;
+pub use types::*;