axonio 0.2.0__tar.gz

axonio-0.2.0/.gitignore

@@ -0,0 +1,9 @@
+node_modules
+.pnpm-store
+.turbo
+dist
+coverage
+*.log
+.DS_Store
+__pycache__/
+target/

axonio-0.2.0/Makefile

@@ -0,0 +1,16 @@
+.PHONY: test type-check format lint clean
+
+test:
+	pytest tests/ -v --tb=short
+
+type-check:
+	mypy axonio/ --ignore-missing-imports --strict
+
+format:
+	ruff format axonio/ tests/
+
+lint:
+	ruff check axonio/ tests/ --fix
+
+clean:
+	rm -rf dist/ build/ *.egg-info

axonio-0.2.0/PKG-INFO

@@ -0,0 +1,102 @@
+Metadata-Version: 2.5
+Name: axonio
+Version: 0.2.0
+Summary: Persistent memory for AI agents: hybrid recall, branch and merge. Python client for Axonio.
+License: MIT
+Keywords: agents,ai,axonio,knowledge-graph,langchain,mcp,memory,openai
+Classifier: Development Status :: 3 - Alpha
+Classifier: License :: OSI Approved :: MIT 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: Topic :: Database
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Requires-Python: >=3.10
+Requires-Dist: httpx>=0.27.0
+Requires-Dist: pydantic-settings>=2.3
+Requires-Dist: pydantic>=2.7
+Requires-Dist: structlog>=24.2
+Provides-Extra: langchain
+Requires-Dist: langchain-core>=0.2; extra == 'langchain'
+Provides-Extra: openai
+Requires-Dist: openai>=1.30; extra == 'openai'
+Description-Content-Type: text/markdown
+
+# axonio
+
+Official Python client for [Axonio](https://axonio.xyz): persistent memory for AI agents, with sync and async APIs.
+
+> Formerly `clawdb`. `pip install axonio` now installs this package, and `import clawdb` still works; `AXONIO_*` environment variables take precedence over `CLAWDB_*`. Pure Python over HTTPS: no gRPC toolchain or generated code to install.
+
+## Install
+
+```bash
+pip install axonio
+```
+
+## Quick Start
+
+### Hosted (Axonio cloud)
+
+Create an API key in the dashboard. With only `AXONIO_API_KEY` set, the client
+connects to the hosted gateway (`https://api.axonio.xyz/api/v1/gateway`).
+
+```python
+from axonio import Axonio
+
+with Axonio(api_key="ck_live_...", endpoint="https://api.axonio.xyz/api/v1/gateway") as db:
+    memory_id = db.memory.remember("Customer prefers weekly updates", tags=["customer"])
+    hits = db.memory.search("how often should we update the customer?", top_k=5)
+    branch = db.branches.fork("customer-experiment")
+    print(memory_id, [h.content for h in hits], branch.branch_id)
+```
+
+### Self-hosted
+
+Point `endpoint` at your clawdb-server. A bare address on the gRPC port
+(`http://localhost:50050`, the default) is mapped to the server's HTTP port
+(8080); any other URL is used as the HTTP API.
+
+```python
+db = Axonio(endpoint="http://localhost:8080", agent_id="py-agent")
+```
+
+### Async
+
+```python
+from axonio import AsyncAxonio
+
+async with AsyncAxonio(api_key="ck_live_...", endpoint="https://api.axonio.xyz/api/v1/gateway") as db:
+    await db.memory.remember("Ship the changelog on Friday", memory_type="task")
+    hits = await db.memory.search("release plan")
+```
+
+## Behaviour
+
+- Sessions are opened on connect, last an hour, are renewed before they
+  expire, and are renewed automatically if the server rejects one.
+- Network errors and 502/503/504 are retried with backoff; 429 honours
+  `Retry-After`.
+- Errors are typed: `ClawDBAuthError`, `ClawDBAccessDeniedError`,
+  `ClawDBNotFoundError`, `ClawDBValidationError`, `ClawDBRateLimitError`,
+  `ClawDBUnavailableError`, `ClawDBTimeoutError`.
+- Agent ids that aren't UUIDs map to a stable UUID, the same one the
+  TypeScript SDK derives, so an agent name means one agent in both SDKs.
+
+## Client Variants
+
+- `Axonio` for synchronous code (also exported as `ClawDB`)
+- `AsyncAxonio` for asyncio applications (also `AsyncClawDB`)
+- `axonio()` helper for environment-aware client creation
+
+## API Surface
+
+- `db.health()`, `db.session` (validate, refresh, revoke, active count)
+- `db.memory`: remember, remember_typed, search, recall, update, delete, forget, list
+- `db.branches`: fork, list, get, get_by_name, get_trunk, diff, merge, discard, archive
+  (`target` accepts a branch id, a name, or trunk)
+- `db.sync`: sync, push, pull, reconcile, status
+- `db.reflect`: trigger, get_job, list_jobs, get_facts, get_preferences,
+  get_contradictions, resolve_contradiction
+- `db.tx`: begin, remember, remember_typed, commit, rollback

axonio-0.2.0/README.md

@@ -0,0 +1,77 @@
+# axonio
+
+Official Python client for [Axonio](https://axonio.xyz): persistent memory for AI agents, with sync and async APIs.
+
+> Formerly `clawdb`. `pip install axonio` now installs this package, and `import clawdb` still works; `AXONIO_*` environment variables take precedence over `CLAWDB_*`. Pure Python over HTTPS: no gRPC toolchain or generated code to install.
+
+## Install
+
+```bash
+pip install axonio
+```
+
+## Quick Start
+
+### Hosted (Axonio cloud)
+
+Create an API key in the dashboard. With only `AXONIO_API_KEY` set, the client
+connects to the hosted gateway (`https://api.axonio.xyz/api/v1/gateway`).
+
+```python
+from axonio import Axonio
+
+with Axonio(api_key="ck_live_...", endpoint="https://api.axonio.xyz/api/v1/gateway") as db:
+    memory_id = db.memory.remember("Customer prefers weekly updates", tags=["customer"])
+    hits = db.memory.search("how often should we update the customer?", top_k=5)
+    branch = db.branches.fork("customer-experiment")
+    print(memory_id, [h.content for h in hits], branch.branch_id)
+```
+
+### Self-hosted
+
+Point `endpoint` at your clawdb-server. A bare address on the gRPC port
+(`http://localhost:50050`, the default) is mapped to the server's HTTP port
+(8080); any other URL is used as the HTTP API.
+
+```python
+db = Axonio(endpoint="http://localhost:8080", agent_id="py-agent")
+```
+
+### Async
+
+```python
+from axonio import AsyncAxonio
+
+async with AsyncAxonio(api_key="ck_live_...", endpoint="https://api.axonio.xyz/api/v1/gateway") as db:
+    await db.memory.remember("Ship the changelog on Friday", memory_type="task")
+    hits = await db.memory.search("release plan")
+```
+
+## Behaviour
+
+- Sessions are opened on connect, last an hour, are renewed before they
+  expire, and are renewed automatically if the server rejects one.
+- Network errors and 502/503/504 are retried with backoff; 429 honours
+  `Retry-After`.
+- Errors are typed: `ClawDBAuthError`, `ClawDBAccessDeniedError`,
+  `ClawDBNotFoundError`, `ClawDBValidationError`, `ClawDBRateLimitError`,
+  `ClawDBUnavailableError`, `ClawDBTimeoutError`.
+- Agent ids that aren't UUIDs map to a stable UUID, the same one the
+  TypeScript SDK derives, so an agent name means one agent in both SDKs.
+
+## Client Variants
+
+- `Axonio` for synchronous code (also exported as `ClawDB`)
+- `AsyncAxonio` for asyncio applications (also `AsyncClawDB`)
+- `axonio()` helper for environment-aware client creation
+
+## API Surface
+
+- `db.health()`, `db.session` (validate, refresh, revoke, active count)
+- `db.memory`: remember, remember_typed, search, recall, update, delete, forget, list
+- `db.branches`: fork, list, get, get_by_name, get_trunk, diff, merge, discard, archive
+  (`target` accepts a branch id, a name, or trunk)
+- `db.sync`: sync, push, pull, reconcile, status
+- `db.reflect`: trigger, get_job, list_jobs, get_facts, get_preferences,
+  get_contradictions, resolve_contradiction
+- `db.tx`: begin, remember, remember_typed, commit, rollback

axonio-0.2.0/axonio/__init__.py

@@ -0,0 +1,62 @@
+"""Axonio Python SDK: persistent memory for AI agents."""
+
+from __future__ import annotations
+
+import asyncio
+from typing import Awaitable
+
+from axonio.async_client import AsyncClawDB
+from axonio.client import ClawDB
+from axonio.errors import (
+    ClawDBAccessDeniedError,
+    ClawDBAuthError,
+    ClawDBError,
+    ClawDBInternalError,
+    ClawDBNotFoundError,
+    ClawDBRateLimitError,
+    ClawDBProvisionError,
+    ClawDBTimeoutError,
+    ClawDBUnavailableError,
+    ClawDBValidationError,
+)
+from axonio.models import BranchInfo, DiffResult, MemoryRecord, MergeResult, ReflectJob, SearchResult, SyncActionResult, SyncResult, SyncStatusResult, TxInfo
+from axonio.transactions import TxClient
+
+
+def axonio() -> ClawDB | Awaitable[AsyncClawDB]:
+    """Return sync client in sync code, or awaitable async client inside an event loop."""
+    try:
+        asyncio.get_running_loop()
+        return AsyncClawDB.auto_provision()
+    except RuntimeError:
+        return ClawDB.auto_provision()
+
+# `Axonio` / `AsyncAxonio` are the same classes as `ClawDB` / `AsyncClawDB`;
+# `clawdb()` remains as an alias of `axonio()`.
+Axonio = ClawDB
+AsyncAxonio = AsyncClawDB
+clawdb = axonio
+
+__all__ = [
+    "axonio",
+    "Axonio",
+    "AsyncAxonio",
+    "clawdb",
+    "ClawDB",
+    "AsyncClawDB",
+    "MemoryRecord",
+    "SearchResult",
+    "BranchInfo",
+    "SyncResult",
+    "ReflectJob",
+    "ClawDBError",
+    "ClawDBAuthError",
+    "ClawDBAccessDeniedError",
+    "ClawDBNotFoundError",
+    "ClawDBRateLimitError",
+    "ClawDBProvisionError",
+    "ClawDBUnavailableError",
+    "ClawDBTimeoutError",
+    "ClawDBValidationError",
+    "ClawDBInternalError",
+]