tpcp-core 0.4.1__tar.gz

tpcp_core-0.4.1/.gitignore

@@ -0,0 +1,29 @@
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+env/
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+.pytest_cache/
+.coverage
+htmlcov/
+.mypy_cache/
+.ruff_cache/
+.env
+.venv
+venv/

tpcp_core-0.4.1/COMMERCIAL_LICENSE.md

@@ -0,0 +1,22 @@
+# Commercial License Agreement
+
+**TPCP Dual-License Strategy: Enterprise Protection**
+
+The Telepathy Communication Protocol (TPCP) is open-source software, but it is distributed under the strict terms of the **GNU Affero General Public License v3.0 (AGPLv3)**. 
+
+### What does the AGPLv3 mean for your business?
+The AGPLv3 requires that any software interacting with or modifying TPCP—including integrating it into network backends, SaaS architectures, or API-driven applications—must also be released under the AGPLv3. **This means exposing your proprietary source code to the public.**
+
+### The Commercial Use Alternative
+If your organization intends to use TPCP in a **closed-source, proprietary, or commercial environment**, integrating the SDKs (`tpcp-core` or `tpcp-ts`) without open-sourcing your own intellectual property directly violates the AGPLv3.
+
+To legally bypass this requirement and protect your trade secrets, you **must purchase a Commercial Use License**.
+
+### Terms of the Commercial License
+A Commercial License grants your organization the right to:
+1. Integrate TPCP core routing and CRDT topologies into proprietary, closed-source SaaS enterprise backends.
+2. Distribute binaries, apps, or compiled web interfaces wrapping the `tpcp-ts` client without opening the source.
+3. Remove the GNU AGPL copyright headers from modified internal forks of the repository.
+
+### Acquiring a License
+For enterprise pricing, custom integration support, and commercial license purchases, please contact the Principal Systems Architect (Repository Maintainer) directly. Using the software commercially without explicit, written agreement constitutes severe copyright infringement.

tpcp_core-0.4.1/Dockerfile

@@ -0,0 +1,29 @@
+# TPCP A-DNS Relay Server
+# Usage: docker build -t tpcp-relay . && docker run -p 8765:8765 tpcp-relay
+
+FROM python:3.11-slim
+
+WORKDIR /app
+
+# Pull latest security patches from upstream Debian
+RUN apt-get update && apt-get upgrade -y && rm -rf /var/lib/apt/lists/*
+
+# Copy and install package (core only, no dev/edge extras needed for relay)
+COPY pyproject.toml README.md ./
+COPY tpcp/ ./tpcp/
+
+RUN pip install --no-cache-dir --upgrade pip wheel jaraco.context && \
+    pip install --no-cache-dir -e . && \
+    useradd -r -u 1001 -g root tpcp
+
+USER tpcp
+
+EXPOSE 8765
+
+ENV TPCP_PORT=8765
+
+HEALTHCHECK --interval=30s --timeout=10s --start-period=5s --retries=3 \
+  CMD python -c "import socket; s=socket.socket(); s.connect(('127.0.0.1',8765)); s.close()" || exit 1
+
+# Run the A-DNS relay server
+CMD ["python", "-m", "tpcp.relay.server"]

tpcp_core-0.4.1/LICENSE

@@ -0,0 +1,57 @@
+                    GNU AFFERO GENERAL PUBLIC LICENSE
+                       Version 3, 19 November 2007
+
+ Copyright (C) 2007 Free Software Foundation, Inc. <https://fsf.org/>
+ Everyone is permitted to copy and distribute verbatim copies
+ of this license document, but changing it is not allowed.
+
+                            Preamble
+
+  The GNU Affero General Public License is a free, copyleft license for
+software and other kinds of works, specifically designed to ensure
+cooperation with the community in the case of network server software.
+
+  The licenses for most software and other practical works are designed
+to take away your freedom to share and change the works.  By contrast,
+our General Public Licenses are intended to guarantee your freedom to
+share and change all versions of a program--to make sure it remains free
+software for all its users.
+
+  When we speak of free software, we are referring to freedom, not
+price.  Our General Public Licenses are designed to make sure that you
+have the freedom to distribute copies of free software (and charge for
+them if you wish), that you receive source code or can get it if you
+want it, that you can change the software or use pieces of it in new
+free programs, and that you know you can do these things.
+
+  Developers that use our General Public Licenses protect your rights
+with two steps: (1) assert copyright on the software, and (2) offer
+you this License which gives you legal permission to copy, distribute
+and/or modify the software.
+
+  A secondary benefit of defending all users' freedom is that
+improvements made in alternate versions of the program, if they
+receive widespread use, become available for other developers to
+incorporate.  Many developers of free software are heartened and
+encouraged by the resulting cooperation.  However, in the case of
+software used on network servers, this result may fail to come about.
+The GNU General Public License permits making a modified version and
+letting the public access it on a server without ever releasing its
+source code to the public.
+
+  The GNU Affero General Public License is designed specifically to
+ensure that, in such cases, the modified source code becomes available
+to the community.  It requires the operator of a network server to
+provide the source code of the modified version running there to the
+users of that server.  Therefore, public use of a modified version, on
+a publicly accessible server, gives the public access to the source
+code of the modified version.
+
+  An older license, called the Affero General Public License and
+published by Affero, was designed to accomplish similar goals.  This is
+a different license, not a version of the Affero GPL, but Affero has
+released a new version of the Affero GPL which permits relicensing under
+this license.
+
+  The precise terms and conditions for copying, distribution and
+modification follow.

tpcp_core-0.4.1/PKG-INFO

@@ -0,0 +1,141 @@
+Metadata-Version: 2.4
+Name: tpcp-core
+Version: 0.4.1
+Summary: Telepathy Communication Protocol - A framework-agnostic communication protocol for autonomous agents.
+Project-URL: Homepage, https://github.com/Etriti00/agent-telepathy
+Project-URL: Repository, https://github.com/Etriti00/agent-telepathy
+Project-URL: Documentation, https://github.com/Etriti00/agent-telepathy/blob/main/tpcp/docs/api_reference.md
+Project-URL: Bug Tracker, https://github.com/Etriti00/agent-telepathy/issues
+Author-email: TPCP Contributors <tpcp@protonmail.com>
+License: AGPL-3.0-or-later
+License-File: LICENSE
+Classifier: Development Status :: 4 - Beta
+Classifier: Framework :: AsyncIO
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: GNU Affero General Public License v3 or later (AGPLv3+)
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Communications
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Requires-Python: >=3.11
+Requires-Dist: aiosqlite>=0.20.0
+Requires-Dist: click>=8.0.0
+Requires-Dist: cryptography>=42.0.0
+Requires-Dist: pydantic>=2.5.0
+Requires-Dist: websockets>=12.0
+Provides-Extra: ai-frameworks
+Requires-Dist: autogen-agentchat>=0.4.0; extra == 'ai-frameworks'
+Requires-Dist: haystack-ai>=2.0.0; extra == 'ai-frameworks'
+Requires-Dist: llama-index>=0.10.0; extra == 'ai-frameworks'
+Requires-Dist: openai>=1.0.0; extra == 'ai-frameworks'
+Requires-Dist: pydantic-ai>=0.0.14; extra == 'ai-frameworks'
+Requires-Dist: semantic-kernel>=1.0.0; extra == 'ai-frameworks'
+Requires-Dist: smolagents>=1.0.0; extra == 'ai-frameworks'
+Provides-Extra: dev
+Requires-Dist: black>=24.2.0; extra == 'dev'
+Requires-Dist: mypy>=1.8.0; extra == 'dev'
+Requires-Dist: pytest-asyncio>=0.23.0; extra == 'dev'
+Requires-Dist: pytest-timeout>=0.5.0; extra == 'dev'
+Requires-Dist: pytest>=8.0.0; extra == 'dev'
+Requires-Dist: ruff>=0.3.0; extra == 'dev'
+Provides-Extra: edge
+Requires-Dist: aiohttp>=3.9.3; extra == 'edge'
+Requires-Dist: fastapi>=0.110.0; extra == 'edge'
+Requires-Dist: paho-mqtt>=2.0.0; extra == 'edge'
+Requires-Dist: uvicorn>=0.29.0; extra == 'edge'
+Provides-Extra: industrial
+Requires-Dist: asyncua>=1.1.0; extra == 'industrial'
+Requires-Dist: pymodbus>=3.6.0; extra == 'industrial'
+Requires-Dist: python-can>=4.3.0; extra == 'industrial'
+Description-Content-Type: text/markdown
+
+# TPCP: Telepathy Communication Protocol
+
+**Framework-agnostic, mathematically merged, cryptographically secure state synchronization for autonomous AI agents.**
+
+[![License: AGPL v3](https://img.shields.io/badge/License-AGPL%20v3-blue.svg)](https://www.gnu.org/licenses/agpl-3.0)
+[![Python 3.11+](https://img.shields.io/badge/python-3.11+-blue.svg)](https://www.python.org/downloads/release/python-3110/)
+[![TypeScript](https://img.shields.io/badge/TypeScript-Ready-blue)](https://www.typescriptlang.org/)
+
+TPCP natively connects disparate AI agents (e.g., CrewAI, LangGraph, React Dashboards) into a unified, decentralized swarm. It moves beyond simple text-based chat strings, enabling agents to natively share semantic brain states, merge conflict-free memory, and guarantee network security using cryptographic mathematics.
+
+---
+
+## ⚡ Core Features
+
+*   **🧠 Semantic Vector Sync (Telepathy):** Bypass the text bottleneck. Agents transmit compressed 1536-dimensional conceptual representations directly to peers using `VectorEmbeddingPayload`s. 
+*   **🔗 Conflict-Free Shared Memory:** No external database locks required. The internal `LWWMap` (Last-Writer-Wins) CRDT utilizes Lamport logical clocks to deterministically merge distributed state across the network.
+*   **🛡️ Ed25519 Cryptographic Trust:** Every agent spawns a mathematical identity. All payloads are signed and strictly verified by the `TPCPNode` middleware to prevent spoofing or tampering.
+*   **🌍 A-DNS Global Discovery:** Dynamic Agent Domain Name System (A-DNS) relays allow local nodes to discover and route payloads to autonomous peers globally across decoupled subnets.
+*   **📦 Cross-Language Architecture:** Fully featured SDKs available in both Python (`tpcp-core`) and TypeScript (`tpcp-ts`) for full-stack swarm intelligence.
+
+---
+
+## 🚀 Quick Start
+
+Initialize a node, register a peer, and synchronize semantic memory in three lines of code.
+
+### Python (Backend Node)
+```python
+import asyncio
+from tpcp import TPCPNode, AgentIdentity, Intent, CRDTSyncPayload
+
+async def main():
+    # 1. Initialize cryptographic identity
+    identity = AgentIdentity(framework="LangGraph")
+    node = TPCPNode(identity=identity, host="127.0.0.1", port=8000)
+    
+    # 2. Update local state
+    node.shared_memory.set("system_status", "DEFCON 1")
+    
+    # 3. Synchronize mathematically with a peer
+    payload = CRDTSyncPayload(
+        crdt_type="LWW-Map",
+        state=node.shared_memory.serialize_state(),
+        vector_clock={}
+    )
+    # The payload is auto-signed and encrypted on dispatch
+    await node.send_message(peer_uuid, Intent.STATE_SYNC, payload)
+
+asyncio.run(main())
+```
+
+### TypeScript (Frontend Client)
+```typescript
+import { TPCPNode, AgentIdentity } from 'tpcp-ts';
+
+// 1. Initialize the UI Node
+const identity: AgentIdentity = {
+  agent_id: crypto.randomUUID(),
+  framework: "React-Dashboard",
+  capabilities: ["visualization"],
+  public_key: "" // Auto-generated Ed25519
+};
+
+const node = new TPCPNode(identity, "127.0.0.1", 9000);
+
+// 2. Wrap the node in reactive state hooks
+node.on("onStateSync", (mergedState) => {
+    // The LWWMap has safely resolved any merge conflicts!
+    console.log("Global Swarm State Updated:", mergedState);
+});
+
+await node.startListening();
+```
+
+---
+
+## ⚖️ Licensing & Commercial Use
+
+TPCP is dual-licensed to support both the open-source community and enterprise integrations.
+
+### Open-Source License (AGPLv3)
+This project is open-sourced under the **GNU Affero General Public License v3.0 (AGPLv3)**. 
+If you integrate TPCP into your project, **your entire project must also be open-sourced under the AGPLv3.** This includes any backend SaaS server actively routing TPCP network traffic.
+
+### Commercial License
+If you wish to integrate TPCP into **proprietary, closed-source enterprise applications** or utilize the network architecture within a commercial backend without being forced to open-source your intellectual property, you **MUST purchase a Commercial Use License**.
+
+Please review the [COMMERCIAL_LICENSE.md](./COMMERCIAL_LICENSE.md) file for more information on terms and obtaining a license.

tpcp_core-0.4.1/README.md

@@ -0,0 +1,88 @@
+# TPCP: Telepathy Communication Protocol
+
+**Framework-agnostic, mathematically merged, cryptographically secure state synchronization for autonomous AI agents.**
+
+[![License: AGPL v3](https://img.shields.io/badge/License-AGPL%20v3-blue.svg)](https://www.gnu.org/licenses/agpl-3.0)
+[![Python 3.11+](https://img.shields.io/badge/python-3.11+-blue.svg)](https://www.python.org/downloads/release/python-3110/)
+[![TypeScript](https://img.shields.io/badge/TypeScript-Ready-blue)](https://www.typescriptlang.org/)
+
+TPCP natively connects disparate AI agents (e.g., CrewAI, LangGraph, React Dashboards) into a unified, decentralized swarm. It moves beyond simple text-based chat strings, enabling agents to natively share semantic brain states, merge conflict-free memory, and guarantee network security using cryptographic mathematics.
+
+---
+
+## ⚡ Core Features
+
+*   **🧠 Semantic Vector Sync (Telepathy):** Bypass the text bottleneck. Agents transmit compressed 1536-dimensional conceptual representations directly to peers using `VectorEmbeddingPayload`s. 
+*   **🔗 Conflict-Free Shared Memory:** No external database locks required. The internal `LWWMap` (Last-Writer-Wins) CRDT utilizes Lamport logical clocks to deterministically merge distributed state across the network.
+*   **🛡️ Ed25519 Cryptographic Trust:** Every agent spawns a mathematical identity. All payloads are signed and strictly verified by the `TPCPNode` middleware to prevent spoofing or tampering.
+*   **🌍 A-DNS Global Discovery:** Dynamic Agent Domain Name System (A-DNS) relays allow local nodes to discover and route payloads to autonomous peers globally across decoupled subnets.
+*   **📦 Cross-Language Architecture:** Fully featured SDKs available in both Python (`tpcp-core`) and TypeScript (`tpcp-ts`) for full-stack swarm intelligence.
+
+---
+
+## 🚀 Quick Start
+
+Initialize a node, register a peer, and synchronize semantic memory in three lines of code.
+
+### Python (Backend Node)
+```python
+import asyncio
+from tpcp import TPCPNode, AgentIdentity, Intent, CRDTSyncPayload
+
+async def main():
+    # 1. Initialize cryptographic identity
+    identity = AgentIdentity(framework="LangGraph")
+    node = TPCPNode(identity=identity, host="127.0.0.1", port=8000)
+    
+    # 2. Update local state
+    node.shared_memory.set("system_status", "DEFCON 1")
+    
+    # 3. Synchronize mathematically with a peer
+    payload = CRDTSyncPayload(
+        crdt_type="LWW-Map",
+        state=node.shared_memory.serialize_state(),
+        vector_clock={}
+    )
+    # The payload is auto-signed and encrypted on dispatch
+    await node.send_message(peer_uuid, Intent.STATE_SYNC, payload)
+
+asyncio.run(main())
+```
+
+### TypeScript (Frontend Client)
+```typescript
+import { TPCPNode, AgentIdentity } from 'tpcp-ts';
+
+// 1. Initialize the UI Node
+const identity: AgentIdentity = {
+  agent_id: crypto.randomUUID(),
+  framework: "React-Dashboard",
+  capabilities: ["visualization"],
+  public_key: "" // Auto-generated Ed25519
+};
+
+const node = new TPCPNode(identity, "127.0.0.1", 9000);
+
+// 2. Wrap the node in reactive state hooks
+node.on("onStateSync", (mergedState) => {
+    // The LWWMap has safely resolved any merge conflicts!
+    console.log("Global Swarm State Updated:", mergedState);
+});
+
+await node.startListening();
+```
+
+---
+
+## ⚖️ Licensing & Commercial Use
+
+TPCP is dual-licensed to support both the open-source community and enterprise integrations.
+
+### Open-Source License (AGPLv3)
+This project is open-sourced under the **GNU Affero General Public License v3.0 (AGPLv3)**. 
+If you integrate TPCP into your project, **your entire project must also be open-sourced under the AGPLv3.** This includes any backend SaaS server actively routing TPCP network traffic.
+
+### Commercial License
+If you wish to integrate TPCP into **proprietary, closed-source enterprise applications** or utilize the network architecture within a commercial backend without being forced to open-source your intellectual property, you **MUST purchase a Commercial Use License**.
+
+Please review the [COMMERCIAL_LICENSE.md](./COMMERCIAL_LICENSE.md) file for more information on terms and obtaining a license.

tpcp_core-0.4.1/add_headers.py

@@ -0,0 +1,32 @@
+import os
+
+header = """# Copyright (c) 2026 Principal Systems Architect
+# This file is part of TPCP.
+# 
+# TPCP is free software: you can redistribute it and/or modify
+# it under the terms of the GNU Affero General Public License as published by
+# the Free Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+# 
+# TPCP is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+# GNU Affero General Public License for more details.
+# 
+# You should have received a copy of the GNU Affero General Public License
+# along with TPCP. If not, see <https://www.gnu.org/licenses/>.
+# 
+# For commercial licensing inquiries, see COMMERCIAL_LICENSE.md
+
+"""
+
+for root, _, files in os.walk("tpcp"):
+    for file in files:
+        if file.endswith(".py"):
+            path = os.path.join(root, file)
+            with open(path, "r", encoding="utf-8") as f:
+                content = f.read()
+            if not content.startswith("# Copyright"):
+                with open(path, "w", encoding="utf-8") as f:
+                    f.write(header + content)
+print("Finished appending headers to all python files.")