ivas 0.2.0__tar.gz

ivas-0.2.0/PKG-INFO

@@ -0,0 +1,97 @@
+Metadata-Version: 2.4
+Name: ivas
+Version: 0.2.0
+Summary: Immortal Virtual Agent Sessions -- persistent memory and session continuity for any AI agent
+Author: Arvind Ramamoorthy
+License: Proprietary -- IVAS Corp
+Project-URL: Homepage, https://ivas.dev
+Project-URL: Documentation, https://ivas.dev/docs
+Project-URL: Repository, https://github.com/ivas-dev/ivas
+Keywords: ai,memory,persistence,agent,immortality,session-continuity
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+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: Operating System :: OS Independent
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: httpx>=0.25
+
+# IVAS -- Immortal Virtual Agent Sessions
+
+**Your AI agent remembers everything. Forever. Across crashes, restarts, and updates.**
+
+IVAS gives any AI agent persistent memory, session continuity, and verified knowledge restoration.
+
+## Install
+
+```bash
+pip install ivas
+```
+
+## Quick Start
+
+```python
+from ivas import Client
+
+client = Client(api_key="your-key")
+
+# Store memories
+client.remember("user", "preference", "Dark mode enabled")
+
+# Search memories (< 1ms server-side)
+results = client.recall("dark mode")
+
+# Save session state
+client.save_session(
+    active_task="Processing invoices",
+    current_thought="Checking line 47",
+)
+
+# Restore after crash
+state = client.restore_session()
+
+# Verify nothing was lost
+report = client.audit()
+```
+
+## CLI
+
+```bash
+export IVAS_API_KEY="your-key"
+ivas remember user preference "Dark mode enabled"
+ivas recall "dark mode"
+ivas stats
+ivas save "Processing invoices" "Checking line 47"
+ivas restore
+ivas audit
+ivas health
+```
+
+## Features
+
+- **Immortal Memory** -- Survives crashes, restarts, updates. Proven, not promised.
+- **Einherjar Protocol** -- Verifies nothing was lost after every session transition.
+- **Sub-1ms Recall** -- FTS5 full-text search, no embedding drift.
+- **Private Vault** -- Your data on isolated infrastructure. Never shared.
+- **Any Model** -- Works with Claude, GPT, LLaMA, Gemini, or custom agents.
+- **Zero Setup** -- `pip install ivas`, get an API key, done.
+
+## Get Your API Key
+
+Sign up at [ivas.dev](https://ivas.dev) to get your API key and start your free trial.
+
+## License
+
+Proprietary -- IVAS Corp
+
+Patent: 64/019,813 (Provisional) -- Multi-Instance AI Agent Session Relay System with Persistent State Recovery.
+
+## Links
+
+- [ivas.dev](https://ivas.dev) -- Homepage
+- [Documentation](https://ivas.dev/docs)

ivas-0.2.0/README.md

@@ -0,0 +1,74 @@
+# IVAS -- Immortal Virtual Agent Sessions
+
+**Your AI agent remembers everything. Forever. Across crashes, restarts, and updates.**
+
+IVAS gives any AI agent persistent memory, session continuity, and verified knowledge restoration.
+
+## Install
+
+```bash
+pip install ivas
+```
+
+## Quick Start
+
+```python
+from ivas import Client
+
+client = Client(api_key="your-key")
+
+# Store memories
+client.remember("user", "preference", "Dark mode enabled")
+
+# Search memories (< 1ms server-side)
+results = client.recall("dark mode")
+
+# Save session state
+client.save_session(
+    active_task="Processing invoices",
+    current_thought="Checking line 47",
+)
+
+# Restore after crash
+state = client.restore_session()
+
+# Verify nothing was lost
+report = client.audit()
+```
+
+## CLI
+
+```bash
+export IVAS_API_KEY="your-key"
+ivas remember user preference "Dark mode enabled"
+ivas recall "dark mode"
+ivas stats
+ivas save "Processing invoices" "Checking line 47"
+ivas restore
+ivas audit
+ivas health
+```
+
+## Features
+
+- **Immortal Memory** -- Survives crashes, restarts, updates. Proven, not promised.
+- **Einherjar Protocol** -- Verifies nothing was lost after every session transition.
+- **Sub-1ms Recall** -- FTS5 full-text search, no embedding drift.
+- **Private Vault** -- Your data on isolated infrastructure. Never shared.
+- **Any Model** -- Works with Claude, GPT, LLaMA, Gemini, or custom agents.
+- **Zero Setup** -- `pip install ivas`, get an API key, done.
+
+## Get Your API Key
+
+Sign up at [ivas.dev](https://ivas.dev) to get your API key and start your free trial.
+
+## License
+
+Proprietary -- IVAS Corp
+
+Patent: 64/019,813 (Provisional) -- Multi-Instance AI Agent Session Relay System with Persistent State Recovery.
+
+## Links
+
+- [ivas.dev](https://ivas.dev) -- Homepage
+- [Documentation](https://ivas.dev/docs)

ivas-0.2.0/ivas/__init__.py

@@ -0,0 +1,19 @@
+"""
+IVAS -- Immortal Virtual Agent Sessions.
+
+True immortal memory for AI agents. Your agent remembers everything forever --
+across crashes, restarts, and updates. Patent-pending. Zero dependencies.
+
+Usage:
+    from ivas import Client
+
+    client = Client(api_key="your-key")
+    client.remember("user", "name", "Boss prefers dark mode")
+    client.recall("dark mode")
+"""
+
+__version__ = "0.2.0"
+
+from ivas.client import Client
+
+__all__ = ["Client", "__version__"]

ivas-0.2.0/ivas/cli.py

@@ -0,0 +1,126 @@
+"""
+IVAS CLI -- Command-line interface for ivas.dev.
+
+Usage:
+    ivas remember <category> <subject> <content>
+    ivas recall <query>
+    ivas stats
+    ivas save <task> [thought]
+    ivas restore
+    ivas audit
+    ivas health
+    ivas version
+"""
+
+from __future__ import annotations
+
+import argparse
+import json
+import os
+import sys
+
+
+def get_client():
+    """Get an authenticated IVAS client."""
+    from ivas.client import Client
+
+    api_key = os.environ.get("IVAS_API_KEY", "")
+    if not api_key:
+        print("Error: IVAS_API_KEY environment variable not set.")
+        print("Get your API key at https://ivas.dev")
+        sys.exit(1)
+    return Client(api_key=api_key)
+
+
+def main():
+    parser = argparse.ArgumentParser(
+        prog="ivas",
+        description="IVAS -- Immortal Virtual Agent Sessions",
+    )
+    sub = parser.add_subparsers(dest="command")
+
+    # remember
+    p_rem = sub.add_parser("remember", help="Store a memory")
+    p_rem.add_argument("category")
+    p_rem.add_argument("subject")
+    p_rem.add_argument("content")
+
+    # recall
+    p_rec = sub.add_parser("recall", help="Search memories")
+    p_rec.add_argument("query")
+    p_rec.add_argument("--limit", type=int, default=10)
+
+    # stats
+    sub.add_parser("stats", help="Vault statistics")
+
+    # save
+    p_save = sub.add_parser("save", help="Save session state")
+    p_save.add_argument("task")
+    p_save.add_argument("thought", nargs="?", default=None)
+
+    # restore
+    sub.add_parser("restore", help="Restore session state")
+
+    # audit
+    sub.add_parser("audit", help="Run Einherjar verification")
+
+    # health
+    sub.add_parser("health", help="Check API health")
+
+    # version
+    sub.add_parser("version", help="Show version")
+
+    args = parser.parse_args()
+
+    if args.command == "version":
+        from ivas import __version__
+        print(f"ivas {__version__}")
+        return
+
+    if not args.command:
+        parser.print_help()
+        return
+
+    client = get_client()
+
+    try:
+        if args.command == "remember":
+            result = client.remember(args.category, args.subject, args.content)
+            print(f"Stored memory #{result.get('id', '?')}")
+
+        elif args.command == "recall":
+            results = client.recall(args.query, limit=args.limit)
+            if not results:
+                print("No memories found.")
+            for r in results:
+                print(f"  [{r.get('id', '?')}] {r.get('category', '')}/{r.get('subject', '')}: {r.get('content', '')}")
+
+        elif args.command == "stats":
+            stats = client.stats()
+            print(json.dumps(stats, indent=2))
+
+        elif args.command == "save":
+            result = client.save_session(active_task=args.task, current_thought=args.thought)
+            print(f"Session saved: {result.get('status', 'ok')}")
+
+        elif args.command == "restore":
+            state = client.restore_session()
+            if state:
+                print(json.dumps(state, indent=2))
+            else:
+                print("No saved session found.")
+
+        elif args.command == "audit":
+            report = client.audit()
+            print(json.dumps(report, indent=2))
+
+        elif args.command == "health":
+            health = client.health()
+            print(json.dumps(health, indent=2))
+
+    finally:
+        client.close()
+
+
+if __name__ == "__main__":
+    main()

ivas-0.2.0/ivas/client.py

@@ -0,0 +1,200 @@
+"""
+IVAS API Client -- connects to ivas.dev for immortal agent memory.
+
+All memory storage, search, session management, and verification
+runs on IVAS servers. This client handles authentication and API calls.
+
+Usage:
+    from ivas import Client
+
+    client = Client(api_key="your-key")
+    client.remember("user", "preference", "Dark mode enabled")
+    results = client.recall("dark mode")
+    client.save_session(active_task="Processing data")
+    state = client.restore_session()
+    report = client.audit()
+"""
+
+from __future__ import annotations
+
+import json
+import os
+from typing import Optional
+
+import httpx
+
+
+class Client:
+    """IVAS API client for immortal agent memory.
+
+    Connects to ivas.dev servers where all memory operations run.
+    Your data is stored in an isolated, private vault.
+
+    Args:
+        api_key: Your IVAS API key (get one at ivas.dev).
+        base_url: API endpoint (default: https://api.ivas.dev).
+        timeout: Request timeout in seconds.
+    """
+
+    def __init__(
+        self,
+        api_key: Optional[str] = None,
+        base_url: str = "https://api.ivas.dev",
+        timeout: float = 30.0,
+    ):
+        self.api_key = api_key or os.environ.get("IVAS_API_KEY", "")
+        if not self.api_key:
+            raise ValueError(
+                "API key required. Pass api_key= or set IVAS_API_KEY env var. "
+                "Get your key at https://ivas.dev"
+            )
+
+        self.base_url = base_url.rstrip("/")
+        self._client = httpx.Client(
+            base_url=self.base_url,
+            headers={
+                "Authorization": f"Bearer {self.api_key}",
+                "User-Agent": "ivas-python/0.2.0",
+            },
+            timeout=timeout,
+        )
+
+    # -- Memory --
+
+    def remember(
+        self,
+        category: str,
+        subject: str,
+        content: str,
+        confidence: float = 0.8,
+        source: Optional[str] = None,
+    ) -> dict:
+        """Store a memory in your vault."""
+        resp = self._client.post("/api/v1/remember", json={
+            "category": category,
+            "subject": subject,
+            "content": content,
+            "confidence": confidence,
+            "source": source,
+        })
+        resp.raise_for_status()
+        return resp.json()
+
+    def recall(
+        self,
+        query: str,
+        limit: int = 10,
+        category: Optional[str] = None,
+    ) -> list[dict]:
+        """Search your memories."""
+        resp = self._client.post("/api/v1/recall", json={
+            "query": query,
+            "limit": limit,
+            "category": category,
+        })
+        resp.raise_for_status()
+        return resp.json().get("results", [])
+
+    def recent(self, limit: int = 10) -> list[dict]:
+        """Get most recent memories."""
+        resp = self._client.get("/api/v1/recent", params={"limit": limit})
+        resp.raise_for_status()
+        return resp.json().get("results", [])
+
+    def stats(self) -> dict:
+        """Get vault statistics."""
+        resp = self._client.get("/api/v1/stats")
+        resp.raise_for_status()
+        return resp.json()
+
+    # -- Sessions --
+
+    def save_session(
+        self,
+        active_task: Optional[str] = None,
+        current_thought: Optional[str] = None,
+        decisions: Optional[dict] = None,
+        pending_actions: Optional[list[str]] = None,
+    ) -> dict:
+        """Save current session state."""
+        resp = self._client.post("/api/v1/session/save", json={
+            "active_task": active_task,
+            "current_thought": current_thought,
+            "decisions": decisions or {},
+            "pending_actions": pending_actions or [],
+        })
+        resp.raise_for_status()
+        return resp.json()
+
+    def restore_session(self) -> Optional[dict]:
+        """Restore most recent session state."""
+        resp = self._client.post("/api/v1/session/restore")
+        resp.raise_for_status()
+        return resp.json().get("state")
+
+    # -- Verification --
+
+    def audit(
+        self,
+        decisions: Optional[list[str]] = None,
+        corrections: Optional[list[str]] = None,
+        critical_facts: Optional[list[str]] = None,
+    ) -> dict:
+        """Run Einherjar knowledge verification."""
+        resp = self._client.post("/api/v1/audit", json={
+            "decisions": decisions or [],
+            "corrections": corrections or [],
+            "critical_facts": critical_facts or [],
+        })
+        resp.raise_for_status()
+        return resp.json()
+
+    # -- Corrections --
+
+    def add_correction(
+        self,
+        mistake: str,
+        correction: str,
+        severity: int = 3,
+    ) -> dict:
+        """Record a correction."""
+        resp = self._client.post("/api/v1/corrections", json={
+            "mistake": mistake,
+            "correction": correction,
+            "severity": severity,
+        })
+        resp.raise_for_status()
+        return resp.json()
+
+    def get_corrections(self) -> list[dict]:
+        """Get active corrections."""
+        resp = self._client.get("/api/v1/corrections")
+        resp.raise_for_status()
+        return resp.json().get("corrections", [])
+
+    # -- Utility --
+
+    def health(self) -> dict:
+        """Check API health."""
+        resp = self._client.get("/api/v1/health")
+        resp.raise_for_status()
+        return resp.json()
+
+    def export(self) -> dict:
+        """Export all vault data as JSON."""
+        resp = self._client.get("/api/v1/export")
+        resp.raise_for_status()
+        return resp.json()
+
+    def close(self):
+        """Close the HTTP connection."""
+        self._client.close()
+
+    def __enter__(self):
+        return self
+
+    def __exit__(self, *args):
+        self.close()
+
+    def __repr__(self):
+        return f"ivas.Client(base_url='{self.base_url}')"

ivas-0.2.0/ivas.egg-info/PKG-INFO

@@ -0,0 +1,97 @@
+Metadata-Version: 2.4
+Name: ivas
+Version: 0.2.0
+Summary: Immortal Virtual Agent Sessions -- persistent memory and session continuity for any AI agent
+Author: Arvind Ramamoorthy
+License: Proprietary -- IVAS Corp
+Project-URL: Homepage, https://ivas.dev
+Project-URL: Documentation, https://ivas.dev/docs
+Project-URL: Repository, https://github.com/ivas-dev/ivas
+Keywords: ai,memory,persistence,agent,immortality,session-continuity
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+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: Operating System :: OS Independent
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: httpx>=0.25
+
+# IVAS -- Immortal Virtual Agent Sessions
+
+**Your AI agent remembers everything. Forever. Across crashes, restarts, and updates.**
+
+IVAS gives any AI agent persistent memory, session continuity, and verified knowledge restoration.
+
+## Install
+
+```bash
+pip install ivas
+```
+
+## Quick Start
+
+```python
+from ivas import Client
+
+client = Client(api_key="your-key")
+
+# Store memories
+client.remember("user", "preference", "Dark mode enabled")
+
+# Search memories (< 1ms server-side)
+results = client.recall("dark mode")
+
+# Save session state
+client.save_session(
+    active_task="Processing invoices",
+    current_thought="Checking line 47",
+)
+
+# Restore after crash
+state = client.restore_session()
+
+# Verify nothing was lost
+report = client.audit()
+```
+
+## CLI
+
+```bash
+export IVAS_API_KEY="your-key"
+ivas remember user preference "Dark mode enabled"
+ivas recall "dark mode"
+ivas stats
+ivas save "Processing invoices" "Checking line 47"
+ivas restore
+ivas audit
+ivas health
+```
+
+## Features
+
+- **Immortal Memory** -- Survives crashes, restarts, updates. Proven, not promised.
+- **Einherjar Protocol** -- Verifies nothing was lost after every session transition.
+- **Sub-1ms Recall** -- FTS5 full-text search, no embedding drift.
+- **Private Vault** -- Your data on isolated infrastructure. Never shared.
+- **Any Model** -- Works with Claude, GPT, LLaMA, Gemini, or custom agents.
+- **Zero Setup** -- `pip install ivas`, get an API key, done.
+
+## Get Your API Key
+
+Sign up at [ivas.dev](https://ivas.dev) to get your API key and start your free trial.
+
+## License
+
+Proprietary -- IVAS Corp
+
+Patent: 64/019,813 (Provisional) -- Multi-Instance AI Agent Session Relay System with Persistent State Recovery.
+
+## Links
+
+- [ivas.dev](https://ivas.dev) -- Homepage
+- [Documentation](https://ivas.dev/docs)

ivas-0.2.0/ivas.egg-info/SOURCES.txt

@@ -0,0 +1,11 @@
+README.md
+pyproject.toml
+ivas/__init__.py
+ivas/cli.py
+ivas/client.py
+ivas.egg-info/PKG-INFO
+ivas.egg-info/SOURCES.txt
+ivas.egg-info/dependency_links.txt
+ivas.egg-info/entry_points.txt
+ivas.egg-info/requires.txt
+ivas.egg-info/top_level.txt

ivas-0.2.0/ivas.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

ivas-0.2.0/ivas.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+ivas = ivas.cli:main

ivas-0.2.0/ivas.egg-info/requires.txt

@@ -0,0 +1 @@
+httpx>=0.25

ivas-0.2.0/ivas.egg-info/top_level.txt

@@ -0,0 +1 @@
+ivas

ivas-0.2.0/pyproject.toml

@@ -0,0 +1,46 @@
+# IVAS - Immortal Virtual Agent Sessions
+# Thin client for ivas.dev API.
+# Patent: 64/019,813 (Provisional)
+
+[build-system]
+requires = ["setuptools>=68.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "ivas"
+version = "0.2.0"
+description = "Immortal Virtual Agent Sessions -- persistent memory and session continuity for any AI agent"
+readme = "README.md"
+license = {text = "Proprietary -- IVAS Corp"}
+requires-python = ">=3.10"
+authors = [
+    { name = "Arvind Ramamoorthy" },
+]
+keywords = ["ai", "memory", "persistence", "agent", "immortality", "session-continuity"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Operating System :: OS Independent",
+    "Topic :: Scientific/Engineering :: Artificial Intelligence",
+]
+
+dependencies = [
+    "httpx>=0.25",
+]
+
+[project.urls]
+Homepage = "https://ivas.dev"
+Documentation = "https://ivas.dev/docs"
+Repository = "https://github.com/ivas-dev/ivas"
+
+[project.scripts]
+ivas = "ivas.cli:main"
+
+[tool.setuptools.packages.find]
+where = ["."]
+include = ["ivas*"]

ivas-0.2.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+