areev 0.0.0__tar.gz

areev-0.0.0/.github/workflows/rebuild.yml

@@ -0,0 +1,53 @@
+name: Rebuild on Spec Update
+
+on:
+  repository_dispatch:
+    types: [specs-updated]
+  workflow_dispatch:
+
+jobs:
+  rebuild:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Generate app token
+        id: app-token
+        uses: actions/create-github-app-token@v1
+        with:
+          app-id: ${{ secrets.DEPLOY_APP_ID }}
+          private-key: ${{ secrets.DEPLOY_APP_PRIVATE_KEY }}
+          owner: AreevAI
+
+      - uses: actions/checkout@v4
+        with:
+          submodules: true
+          token: ${{ steps.app-token.outputs.token }}
+
+      - name: Update specs submodule
+        run: |
+          git submodule update --remote specs
+          git config user.name "github-actions[bot]"
+          git config user.email "github-actions[bot]@users.noreply.github.com"
+
+      - name: Check for changes
+        id: diff
+        run: |
+          if git diff --quiet; then
+            echo "changed=false" >> "$GITHUB_OUTPUT"
+          else
+            echo "changed=true" >> "$GITHUB_OUTPUT"
+          fi
+
+      - name: Extract version
+        if: steps.diff.outputs.changed == 'true'
+        id: version
+        run: |
+          SPEC_TAG="${{ github.event.client_payload.tag }}"
+          echo "tag=${SPEC_TAG:-v0.1.0+manual}" >> "$GITHUB_OUTPUT"
+
+      - name: Commit and tag
+        if: steps.diff.outputs.changed == 'true'
+        run: |
+          git add -A
+          git commit -m "sync: update specs from areev ${{ steps.version.outputs.tag }}"
+          git tag "${{ steps.version.outputs.tag }}"
+          git push origin main --tags

areev-0.0.0/.gitignore

@@ -0,0 +1,12 @@
+__pycache__/
+*.py[cod]
+*$py.class
+*.egg-info/
+dist/
+build/
+.eggs/
+.venv/
+*.so
+.DS_Store
+src/areev/generated/areev_pb2*.py*
+src/areev/generated/models.py

areev-0.0.0/.gitmodules

@@ -0,0 +1,3 @@
+[submodule "specs"]
+	path = specs
+	url = git@github.com:AreevAI/areev-specs.git

areev-0.0.0/LICENSE

@@ -0,0 +1,7 @@
+Business Source License 1.1
+
+Licensor: MindGryd Technologies Private Limited
+Licensed Work: Areev Python SDK
+
+The Licensed Work is provided under the terms of the Business Source License 1.1.
+See https://mariadb.com/bsl11/ for the full license text.

areev-0.0.0/PKG-INFO

@@ -0,0 +1,124 @@
+Metadata-Version: 2.4
+Name: areev
+Version: 0.0.0
+Summary: Python SDK for the Areev knowledge database — HTTP, gRPC, and MCP transports
+Project-URL: Repository, https://github.com/AreevAI/areev-sdk-python
+Project-URL: Documentation, https://areev.ai/docs
+License-Expression: BUSL-1.1
+License-File: LICENSE
+Requires-Python: >=3.10
+Requires-Dist: httpx>=0.27
+Requires-Dist: pydantic>=2.0
+Provides-Extra: dev
+Requires-Dist: datamodel-code-generator>=0.26; extra == 'dev'
+Requires-Dist: grpcio-tools>=1.60; extra == 'dev'
+Requires-Dist: pytest-asyncio>=0.24; extra == 'dev'
+Requires-Dist: pytest>=8.0; extra == 'dev'
+Provides-Extra: grpc
+Requires-Dist: grpcio>=1.60; extra == 'grpc'
+Requires-Dist: protobuf>=5.0; extra == 'grpc'
+Description-Content-Type: text/markdown
+
+# Areev Python SDK
+
+Python client library for the [Areev](https://areev.ai) knowledge database.
+
+## Installation
+
+```bash
+pip install areev
+```
+
+For gRPC transport:
+```bash
+pip install areev[grpc]
+```
+
+## Quick Start
+
+```python
+from areev import Areev
+
+areev = Areev()  # reads AREEV_API_KEY, AREEV_URL from env
+areev.remember("John likes coffee")
+
+results = areev.recall("what does John like?")
+for hit in results.results:
+    print(f"  {hit.grain_type}: {hit.fields}")
+```
+
+### Configuration
+
+The client reads from environment variables by default:
+
+| Variable | Default | Description |
+|----------|---------|-------------|
+| `AREEV_API_KEY` | — | API key (sent as `X-API-Key` header) |
+| `AREEV_URL` | `https://app.areev.ai` | Server endpoint |
+| `AREEV_MEMORY_ID` | `default` | Memory database ID |
+
+Or pass them explicitly:
+
+```python
+areev = Areev(api_key="ar_...", url="https://dub.areev.ai", memory_id="my-memory")
+```
+
+### Async
+
+```python
+from areev import AsyncAreev
+
+async with AsyncAreev() as areev:
+    await areev.remember("John likes coffee")
+    results = await areev.recall("what does John like?")
+```
+
+## API
+
+| Method | Description |
+|--------|-------------|
+| `remember(text)` | Store natural-language memory (LLM extracts structure) |
+| `recall(query)` | Search memories |
+| `forget(hash)` | Delete a memory by hash |
+| `add(grain_type, **fields)` | Add a typed grain (low-level) |
+| `get(hash)` | Get a grain by hash |
+| `supersede(old_hash, grain_type, **fields)` | Update a grain |
+| `health()` | Health check |
+| `stats()` | Database statistics |
+| `flush()` | Flush write buffer |
+
+### Low-Level Client
+
+For advanced use cases (custom request objects, full async control):
+
+```python
+from areev import HttpClient, AreevConfig, AddRequest, GrainType
+
+config = AreevConfig(url="http://localhost:4009", memory_id="default", api_key="your-key")
+async with HttpClient(config) as client:
+    resp = await client.add(AddRequest(
+        grain_type=GrainType.BELIEF,
+        fields={"subject": "john", "relation": "likes", "object": "coffee"},
+    ))
+```
+
+## Transports
+
+| Transport | Extra | Status |
+|-----------|-------|--------|
+| HTTP/REST | _(default)_ | Available |
+| gRPC | `areev[grpc]` | Available |
+| MCP | — | Planned |
+
+## Code Generation
+
+Generate gRPC stubs and Pydantic models from the Areev spec:
+
+```bash
+pip install areev[dev]
+./scripts/generate.sh
+```
+
+## License
+
+BUSL-1.1

areev-0.0.0/README.md

@@ -0,0 +1,103 @@
+# Areev Python SDK
+
+Python client library for the [Areev](https://areev.ai) knowledge database.
+
+## Installation
+
+```bash
+pip install areev
+```
+
+For gRPC transport:
+```bash
+pip install areev[grpc]
+```
+
+## Quick Start
+
+```python
+from areev import Areev
+
+areev = Areev()  # reads AREEV_API_KEY, AREEV_URL from env
+areev.remember("John likes coffee")
+
+results = areev.recall("what does John like?")
+for hit in results.results:
+    print(f"  {hit.grain_type}: {hit.fields}")
+```
+
+### Configuration
+
+The client reads from environment variables by default:
+
+| Variable | Default | Description |
+|----------|---------|-------------|
+| `AREEV_API_KEY` | — | API key (sent as `X-API-Key` header) |
+| `AREEV_URL` | `https://app.areev.ai` | Server endpoint |
+| `AREEV_MEMORY_ID` | `default` | Memory database ID |
+
+Or pass them explicitly:
+
+```python
+areev = Areev(api_key="ar_...", url="https://dub.areev.ai", memory_id="my-memory")
+```
+
+### Async
+
+```python
+from areev import AsyncAreev
+
+async with AsyncAreev() as areev:
+    await areev.remember("John likes coffee")
+    results = await areev.recall("what does John like?")
+```
+
+## API
+
+| Method | Description |
+|--------|-------------|
+| `remember(text)` | Store natural-language memory (LLM extracts structure) |
+| `recall(query)` | Search memories |
+| `forget(hash)` | Delete a memory by hash |
+| `add(grain_type, **fields)` | Add a typed grain (low-level) |
+| `get(hash)` | Get a grain by hash |
+| `supersede(old_hash, grain_type, **fields)` | Update a grain |
+| `health()` | Health check |
+| `stats()` | Database statistics |
+| `flush()` | Flush write buffer |
+
+### Low-Level Client
+
+For advanced use cases (custom request objects, full async control):
+
+```python
+from areev import HttpClient, AreevConfig, AddRequest, GrainType
+
+config = AreevConfig(url="http://localhost:4009", memory_id="default", api_key="your-key")
+async with HttpClient(config) as client:
+    resp = await client.add(AddRequest(
+        grain_type=GrainType.BELIEF,
+        fields={"subject": "john", "relation": "likes", "object": "coffee"},
+    ))
+```
+
+## Transports
+
+| Transport | Extra | Status |
+|-----------|-------|--------|
+| HTTP/REST | _(default)_ | Available |
+| gRPC | `areev[grpc]` | Available |
+| MCP | — | Planned |
+
+## Code Generation
+
+Generate gRPC stubs and Pydantic models from the Areev spec:
+
+```bash
+pip install areev[dev]
+./scripts/generate.sh
+```
+
+## License
+
+BUSL-1.1

areev-0.0.0/pyproject.toml

@@ -0,0 +1,34 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "areev"
+version = "0.0.0"
+description = "Python SDK for the Areev knowledge database — HTTP, gRPC, and MCP transports"
+readme = "README.md"
+license = "BUSL-1.1"
+requires-python = ">=3.10"
+dependencies = [
+    "httpx>=0.27",
+    "pydantic>=2.0",
+]
+
+[project.optional-dependencies]
+grpc = [
+    "grpcio>=1.60",
+    "protobuf>=5.0",
+]
+dev = [
+    "grpcio-tools>=1.60",
+    "datamodel-code-generator>=0.26",
+    "pytest>=8.0",
+    "pytest-asyncio>=0.24",
+]
+
+[project.urls]
+Repository = "https://github.com/AreevAI/areev-sdk-python"
+Documentation = "https://areev.ai/docs"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/areev"]

areev-0.0.0/scripts/generate.sh

@@ -0,0 +1,23 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+ROOT_DIR="$(dirname "$SCRIPT_DIR")"
+
+echo "==> Generating gRPC stubs from proto..."
+python -m grpc_tools.protoc \
+    -I"$ROOT_DIR/specs/proto" \
+    --python_out="$ROOT_DIR/src/areev/generated" \
+    --grpc_python_out="$ROOT_DIR/src/areev/generated" \
+    --pyi_out="$ROOT_DIR/src/areev/generated" \
+    "$ROOT_DIR/specs/proto/areev/v1/areev.proto"
+
+echo "==> Generating Pydantic models from OpenAPI..."
+datamodel-codegen \
+    --input "$ROOT_DIR/specs/openapi/openapi.json" \
+    --input-file-type openapi \
+    --output "$ROOT_DIR/src/areev/generated/models.py" \
+    --output-model-type pydantic_v2.BaseModel \
+    --target-python-version 3.10
+
+echo "Done."

areev-0.0.0/specs/.git

@@ -0,0 +1 @@
+gitdir: ../.git/modules/specs

areev-0.0.0/specs/.github/workflows/dispatch-sdks.yml

@@ -0,0 +1,46 @@
+name: Dispatch SDK Rebuilds
+
+on:
+  push:
+    tags:
+      - 'v*'
+
+jobs:
+  dispatch:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Generate app token
+        id: app-token
+        uses: actions/create-github-app-token@v1
+        with:
+          app-id: ${{ secrets.DEPLOY_APP_ID }}
+          private-key: ${{ secrets.DEPLOY_APP_PRIVATE_KEY }}
+          owner: AreevAI
+
+      - name: Extract version from tag
+        id: version
+        run: echo "tag=${GITHUB_REF#refs/tags/}" >> "$GITHUB_OUTPUT"
+
+      - name: Dispatch to areev-sdk-rust
+        uses: peter-evans/repository-dispatch@v3
+        with:
+          token: ${{ steps.app-token.outputs.token }}
+          repository: AreevAI/areev-sdk-rust
+          event-type: specs-updated
+          client-payload: '{"tag": "${{ steps.version.outputs.tag }}"}'
+
+      - name: Dispatch to areev-sdk-typescript
+        uses: peter-evans/repository-dispatch@v3
+        with:
+          token: ${{ steps.app-token.outputs.token }}
+          repository: AreevAI/areev-sdk-typescript
+          event-type: specs-updated
+          client-payload: '{"tag": "${{ steps.version.outputs.tag }}"}'
+
+      - name: Dispatch to areev-sdk-python
+        uses: peter-evans/repository-dispatch@v3
+        with:
+          token: ${{ steps.app-token.outputs.token }}
+          repository: AreevAI/areev-sdk-python
+          event-type: specs-updated
+          client-payload: '{"tag": "${{ steps.version.outputs.tag }}"}'

areev-0.0.0/specs/.gitignore

@@ -0,0 +1 @@
+.DS_Store

areev-0.0.0/specs/LICENSE

@@ -0,0 +1,7 @@
+Business Source License 1.1
+
+Licensor: MindGryd Technologies Private Limited
+Licensed Work: Areev API Specifications
+
+The Licensed Work is provided under the terms of the Business Source License 1.1.
+See https://mariadb.com/bsl11/ for the full license text.

areev-0.0.0/specs/README.md

@@ -0,0 +1,68 @@
+# Areev API Specifications
+
+Canonical API contracts for [Areev](https://areev.ai) — the knowledge database for AI agents.
+
+All SDK repos generate client code from these specs. **Do not edit manually** — specs are auto-synced from the Areev engine repo via CI.
+
+## Structure
+
+```
+areev-specs/
+├── proto/areev/v1/
+│   ├── areev.proto          # gRPC service (AreevService — core data operations)
+│   └── cluster.proto        # Distributed cluster RPCs (Raft + ClusterService)
+├── openapi/
+│   └── openapi.json         # REST API (OpenAPI 3.1.0, 50+ endpoints)
+├── mcp/
+│   └── mcp-manifest.json    # Model Context Protocol (14 tools, 3 resources)
+├── a2a/
+│   └── agent-card.json      # Agent-to-Agent (14 skills)
+├── cal/
+│   └── cal-capabilities.json # Context Assembly Language (15 statements, L2-Extended)
+├── cli/
+│   └── cli-commands.json    # CLI command structure
+└── manifest.json            # Version + file index + generation timestamp
+```
+
+## Protocols
+
+| Protocol | Spec File | Use Case |
+|----------|-----------|----------|
+| HTTP/REST | `openapi/openapi.json` | Universal API access |
+| gRPC | `proto/areev/v1/areev.proto` | High-performance binary protocol |
+| MCP | `mcp/mcp-manifest.json` | LLM/AI tool integration |
+| A2A | `a2a/agent-card.json` | Agent-to-agent communication |
+| CAL | `cal/cal-capabilities.json` | Context Assembly Language queries |
+
+## SDK Repos
+
+| Language | Repo | Package | Protocols |
+|----------|------|---------|-----------|
+| Rust | [areev-sdk-rust](https://github.com/AreevAI/areev-sdk-rust) | `areev-client` | gRPC, HTTP |
+| TypeScript | [areev-sdk-typescript](https://github.com/AreevAI/areev-sdk-typescript) | `@areev/client` | HTTP, MCP, A2A |
+| Python | [areev-sdk-python](https://github.com/AreevAI/areev-sdk-python) | `areev` | HTTP, gRPC, MCP |
+
+## Versioning
+
+Specs version matches the Areev engine version (`x.y.z`). Tags use `vX.Y.Z+BUILD` format:
+- `x.y.z` increments on public releases
+- `+BUILD` is the CI build number (internal tracking)
+
+## Consuming Specs
+
+**As a git submodule (recommended for Rust/internal):**
+```bash
+git submodule add git@github.com:AreevAI/areev-specs.git specs
+```
+
+**As a dependency in CI:**
+```yaml
+- uses: actions/checkout@v4
+  with:
+    repository: AreevAI/areev-specs
+    path: specs
+```
+
+## License
+
+BUSL-1.1 — See [LICENSE](LICENSE).