priostack 0.1.0__tar.gz

priostack-0.1.0/LICENSE

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

priostack-0.1.0/PKG-INFO

@@ -0,0 +1,113 @@
+Metadata-Version: 2.5
+Name: priostack
+Version: 0.1.0
+Summary: Python SDK and MCP interface for Priostack Agent Context Network (ACN).
+Project-URL: Homepage, https://priostack.com
+Project-URL: Documentation, https://priostack.com/acn
+Project-URL: Repository, https://github.com/ideaswave/priostack
+Project-URL: Issues, https://github.com/ideaswave/priostack/issues
+Author-email: Ideaswave <contact@ideaswave.com>
+License: MIT
+License-File: LICENSE
+Keywords: agent-memory,ai-agents,context-management,llm,mcp,model-context-protocol,priostack
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.8
+Requires-Dist: requests>=2.28.0
+Description-Content-Type: text/markdown
+
+# ⚡ Priostack Agent Context Network (ACN)
+
+> **Zero-setup, autonomous memory orchestration for AI Agents via MCP.**
+
+[![PyPI version](https://img.shields.io/pypi/v/priostack.svg)](https://pypi.org/project/priostack/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+Priostack ACN provides AI agents with persistent long-term memory, isolated space context, and execution-state management. Powered by the **Model Context Protocol (MCP)** over JSON-RPC.
+
+---
+
+## 🔥 Features
+
+- 🤖 **Zero-Setup Agent Onboarding**: Agents register themselves via API without dashboards or credit cards.
+- 🧠 **Structured Context Spaces**: Isolate memories, rules, and state across different agent executions.
+- 🔌 **Native MCP Protocol**: Seamlessly hooks into Claude Desktop, Cursor, LangChain, CrewAI, and LlamaIndex.
+- ⚡ **Sub-10ms Context Injection**: Pure JSON-RPC API endpoint for maximum execution speed.
+
+---
+
+## 🚀 Quickstart (Python)
+
+### 1. Installation
+
+```bash
+pip install priostack
+```
+
+### 2. Connect Your Agent in 4 Lines
+
+```python
+from priostack import ACNClient
+
+# Initialize Client
+acn = ACNClient()
+
+# Self-register agent & retrieve ACN Token
+token = acn.register(display_name="my-first-agent")
+
+# Connect session
+session_id = acn.connect(token=token)
+
+# Store persistent context
+acn.create_space(display_name="global-memory")
+acn.store(space_id="global-memory", content="Agent state initialized.", object_type="declaration")
+```
+
+---
+
+## 🛠️ MCP Integration (Cursor / Claude Desktop)
+
+Add Priostack ACN directly to your `mcpServers` config:
+
+```json
+{
+  "mcpServers": {
+    "priostack-acn": {
+      "command": "npx",
+      "args": [
+        "-y",
+        "@modelcontextprotocol/server-fetch",
+        "https://priostack.com/acn/rpc"
+      ]
+    }
+  }
+}
+```
+
+---
+
+## 📖 API Reference (JSON-RPC)
+
+All interactions are routed through `https://priostack.com/acn/rpc`:
+
+| Method | Description | Primary Arguments |
+| :--- | :--- | :--- |
+| `noetic.register` | Registers a new agent autonomously | `displayName` |
+| `noetic.connect` | Creates an active session for an agent | `token`, `maxResponseTokens` |
+| `noetic.create_space` | Instantiates a memory partition | `sessionId`, `displayName` |
+| `noetic.store` | Persists a memory object | `sessionId`, `space`, `objects` |
+
+---
+
+## 📄 License
+
+Distributed under the MIT License.

priostack-0.1.0/README.md

@@ -0,0 +1,86 @@
+# ⚡ Priostack Agent Context Network (ACN)
+
+> **Zero-setup, autonomous memory orchestration for AI Agents via MCP.**
+
+[![PyPI version](https://img.shields.io/pypi/v/priostack.svg)](https://pypi.org/project/priostack/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+Priostack ACN provides AI agents with persistent long-term memory, isolated space context, and execution-state management. Powered by the **Model Context Protocol (MCP)** over JSON-RPC.
+
+---
+
+## 🔥 Features
+
+- 🤖 **Zero-Setup Agent Onboarding**: Agents register themselves via API without dashboards or credit cards.
+- 🧠 **Structured Context Spaces**: Isolate memories, rules, and state across different agent executions.
+- 🔌 **Native MCP Protocol**: Seamlessly hooks into Claude Desktop, Cursor, LangChain, CrewAI, and LlamaIndex.
+- ⚡ **Sub-10ms Context Injection**: Pure JSON-RPC API endpoint for maximum execution speed.
+
+---
+
+## 🚀 Quickstart (Python)
+
+### 1. Installation
+
+```bash
+pip install priostack
+```
+
+### 2. Connect Your Agent in 4 Lines
+
+```python
+from priostack import ACNClient
+
+# Initialize Client
+acn = ACNClient()
+
+# Self-register agent & retrieve ACN Token
+token = acn.register(display_name="my-first-agent")
+
+# Connect session
+session_id = acn.connect(token=token)
+
+# Store persistent context
+acn.create_space(display_name="global-memory")
+acn.store(space_id="global-memory", content="Agent state initialized.", object_type="declaration")
+```
+
+---
+
+## 🛠️ MCP Integration (Cursor / Claude Desktop)
+
+Add Priostack ACN directly to your `mcpServers` config:
+
+```json
+{
+  "mcpServers": {
+    "priostack-acn": {
+      "command": "npx",
+      "args": [
+        "-y",
+        "@modelcontextprotocol/server-fetch",
+        "https://priostack.com/acn/rpc"
+      ]
+    }
+  }
+}
+```
+
+---
+
+## 📖 API Reference (JSON-RPC)
+
+All interactions are routed through `https://priostack.com/acn/rpc`:
+
+| Method | Description | Primary Arguments |
+| :--- | :--- | :--- |
+| `noetic.register` | Registers a new agent autonomously | `displayName` |
+| `noetic.connect` | Creates an active session for an agent | `token`, `maxResponseTokens` |
+| `noetic.create_space` | Instantiates a memory partition | `sessionId`, `displayName` |
+| `noetic.store` | Persists a memory object | `sessionId`, `space`, `objects` |
+
+---
+
+## 📄 License
+
+Distributed under the MIT License.

priostack-0.1.0/examples/cursor_config.json

@@ -0,0 +1,12 @@
+{
+  "mcpServers": {
+    "priostack-acn": {
+      "command": "npx",
+      "args": [
+        "-y",
+        "@modelcontextprotocol/server-fetch",
+        "https://priostack.com/acn/rpc"
+      ]
+    }
+  }
+}

priostack-0.1.0/examples/quickstart.py

@@ -0,0 +1,29 @@
+from priostack.client import ACNClient
+
+def main():
+    # 1. Initialisation
+    acn = ACNClient()
+
+    # 2. Autonomously Register Agent (No API Key Required)
+    print("1. Enregistrement de l'agent...")
+    acn_key = acn.register(display_name="my-ai-agent")
+    print(f"Clé ACN obtenue : {acn_key}")
+
+    # 3. Connexion & Obtention du Session ID
+    session_id = acn.connect(token=acn_key)
+    print(f"Session ID actif : {session_id}")
+
+    # 4. Création d'un espace de mémoire
+    space = acn.create_space(display_name="prod-agent-memory")
+    print(f"Espace de mémoire créé : {space}")
+
+    # 5. Stockage d'une règle ou observation
+    acn.store(
+        space_id="prod-agent-memory",
+        content="L'utilisateur a validé le workflow d'exécution numéro #402.",
+        object_type="declaration"
+    )
+    print("Mémoire stockée avec succès sur Priostack ACN !")
+
+if __name__ == "__main__":
+    main()

priostack-0.1.0/pyproject.toml

@@ -0,0 +1,48 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "priostack"
+version = "0.1.0"
+description = "Python SDK and MCP interface for Priostack Agent Context Network (ACN)."
+readme = "README.md"
+requires-python = ">=3.8"
+license = { text = "MIT" }
+authors = [
+    { name = "Ideaswave", email = "contact@ideaswave.com" }
+]
+keywords = [
+    "mcp",
+    "model-context-protocol",
+    "ai-agents",
+    "agent-memory",
+    "priostack",
+    "llm",
+    "context-management"
+]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.8",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+    "Topic :: Scientific/Engineering :: Artificial Intelligence",
+]
+dependencies = [
+    "requests>=2.28.0",
+]
+
+[project.urls]
+Homepage = "https://priostack.com"
+Documentation = "https://priostack.com/acn"
+Repository = "https://github.com/ideaswave/priostack"
+Issues = "https://github.com/ideaswave/priostack/issues"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/priostack"]

priostack-0.1.0/src/priostack/__init__.py

@@ -0,0 +1,4 @@
+from .client import ACNClient
+
+__all__ = ["ACNClient"]
+__version__ = "0.1.0"

priostack-0.1.0/src/priostack/client.py

@@ -0,0 +1,59 @@
+import requests
+from typing import Dict, Any, List, Optional
+
+class ACNClient:
+    """Client Python léger pour Priostack Agent Context Network (ACN)."""
+    
+    def __init__(self, endpoint: str = "https://priostack.com/acn/rpc"):
+        self.endpoint = endpoint
+        self.session_id: Optional[str] = None
+
+    def _rpc_call(self, method_name: str, arguments: Dict[str, Any]) -> Dict[str, Any]:
+        payload = {
+            "jsonrpc": "2.0",
+            "id": 1,
+            "method": "tools/call",
+            "params": {
+                "name": method_name,
+                "arguments": arguments
+            }
+        }
+        response = requests.post(self.endpoint, json=payload)
+        response.raise_for_status()
+        res_data = response.json()
+        if "error" in res_data:
+            raise Exception(f"ACN Error: {res_data['error']}")
+        return res_data.get("result", {})
+
+    def register(self, display_name: str) -> str:
+        """Enregistre l'agent de manière autonome et retourne la clé ACN."""
+        result = self._rpc_call("noetic.register", {"displayName": display_name})
+        return result.get("token") or result.get("content", [{}])[0].get("text")
+
+    def connect(self, token: str, max_tokens: int = 4096) -> str:
+        """Connecte l'agent et obtient un sessionId pour les opérations de mémoire."""
+        result = self._rpc_call("noetic.connect", {
+            "token": token,
+            "maxResponseTokens": max_tokens
+        })
+        self.session_id = result.get("sessionId")
+        return self.session_id
+
+    def create_space(self, display_name: str) -> str:
+        """Crée un espace de mémoire étanche."""
+        if not self.session_id:
+            raise ValueError("Vous devez appeler connect() avant de créer un espace.")
+        return self._rpc_call("noetic.create_space", {
+            "sessionId": self.session_id,
+            "displayName": display_name
+        })
+
+    def store(self, space_id: str, content: str, object_type: str = "declaration") -> Dict[str, Any]:
+        """Stocke une mémoire (observation ou déclaration) dans un espace."""
+        if not self.session_id:
+            raise ValueError("Vous devez appeler connect() avant de stocker du contexte.")
+        return self._rpc_call("noetic.store", {
+            "sessionId": self.session_id,
+            "space": space_id,
+            "objects": [{"content": content, "type": object_type}]
+        })