cortexdb-cli 0.5.2__tar.gz → 0.5.4__tar.gz

{cortexdb_cli-0.5.2 → cortexdb_cli-0.5.4}/.gitignore

@@ -1,101 +1,109 @@
-# Rust
-/target
-**/*.rs.bk
-
-# Environment / secrets
-.env
-.env.local
-.env*.local
-*.pem
-*.key
-.npmrc
-
-# SQLite database
-*.sqlite
-*.sqlite-wal
-*.sqlite-shm
-
-# OS
-.DS_Store
-Thumbs.db
-desktop.ini
-
-# IDE
-.idea/
-.vscode/
-*.swp
-*.swo
-
-# Data directories
-cortexdb_data*/
-/data/
-# Per-bench tenant stores (RocksDB + Tantivy + HNSW state; regeneratable per run)
-/data_*/
-# Experimental per-branch stores (not tracked on this branch but left gitignored
-# so checkout from other branches doesn't surface them in git status)
-/event_memory_store/
-/llm_cache/
-
-# Benchmark inputs and per-run outputs (kept local, regenerated each run)
-benchmarks/longmemeval/data/
-benchmarks/longmemeval/server_results/
-benchmarks/longmemeval/fast_results/
-benchmarks/longmemeval/micro_results/
-benchmarks/longmemeval/server_logs/
-benchmarks/longmemeval/*.log
-benchmarks/locomo/locomo_results*.json
-benchmarks/locomo/server_results/
-benchmarks/locomo/*.log
-/answer_out.json
-
-# Local Claude Code state
-.claude/
-.tmp/
-
-# Python
-__pycache__/
-*.pyc
-.venv/
-venv/
-
-# Node
-node_modules/
-dist/
-.next/
-
-# Egg info
-*.egg-info/
-
-# Scratch/debug text files at root
-/*.txt
-/*.log
-
-# Local debug / marketing / private content (not for repo)
-harness/.reports/
-harness_data_*/
-blog/
-sales/
-videos/
-local-instance/
-
-# doc-claims verifier scratch output
-tools/verifier_out*/
-
-# Generated benchmark / runtime data (audit M-10: hundreds of untracked
-# data dirs at the workspace root slow every git status/search and risk
-# being packaged; results JSONs are artifacts, never source)
-benchmarks/data_*/
-benchmarks/**/fast_results/
-data_*/
-*_data/
-*_data_20*/
-cortexdb_data*/
-server_results/
-*.log
-docker_build.log
-
-# local gate/bench data stores
-gate*_data_*/
-
-# Code-plane benchmark local run outputs (official results are committed deliberately)
-benchmarks/codeplane/runs/
+# Rust
+/target
+**/*.rs.bk
+
+# Environment / secrets
+.env
+.env.local
+.env*.local
+*.pem
+*.key
+.npmrc
+
+# SQLite database
+*.sqlite
+*.sqlite-wal
+*.sqlite-shm
+
+# OS
+.DS_Store
+Thumbs.db
+desktop.ini
+
+# IDE
+.idea/
+.vscode/
+*.swp
+*.swo
+
+# Data directories
+cortexdb_data*/
+/data/
+# Per-bench tenant stores (RocksDB + Tantivy + HNSW state; regeneratable per run)
+/data_*/
+# Experimental per-branch stores (not tracked on this branch but left gitignored
+# so checkout from other branches doesn't surface them in git status)
+/event_memory_store/
+/llm_cache/
+
+# Benchmark inputs and per-run outputs (kept local, regenerated each run)
+benchmarks/longmemeval/data/
+benchmarks/longmemeval/server_results/
+benchmarks/longmemeval/fast_results/
+benchmarks/longmemeval/micro_results/
+benchmarks/longmemeval/server_logs/
+benchmarks/longmemeval/*.log
+benchmarks/locomo/locomo_results*.json
+benchmarks/locomo/server_results/
+benchmarks/locomo/*.log
+/answer_out.json
+
+# Local Claude Code state
+.claude/
+.tmp/
+
+# Python
+__pycache__/
+*.pyc
+.venv/
+venv/
+
+# Node
+node_modules/
+dist/
+.next/
+
+# Egg info
+*.egg-info/
+
+# Scratch/debug text files at root
+/*.txt
+/*.log
+
+# Local debug / marketing / private content (not for repo)
+harness/.reports/
+harness_data_*/
+blog/
+sales/
+videos/
+local-instance/
+
+# doc-claims verifier scratch output
+tools/verifier_out*/
+
+# Generated benchmark / runtime data (audit M-10: hundreds of untracked
+# data dirs at the workspace root slow every git status/search and risk
+# being packaged; results JSONs are artifacts, never source)
+benchmarks/data_*/
+benchmarks/**/fast_results/
+data_*/
+*_data/
+*_data_20*/
+cortexdb_data*/
+server_results/
+*.log
+docker_build.log
+
+# local gate/bench data stores
+gate*_data_*/
+
+# Code-plane benchmark local run outputs (official results are committed deliberately)
+benchmarks/codeplane/runs/
+
+# Deliberately untracked, four times over: `git add docs/` keeps sweeping the
+# investor deck sources and the 2.7 MB OpenClaw design PDF back in (7dda2a51,
+# 3a778b5e, then again in the 2026-09-09 checkpoint). They live on disk; they do
+# not belong in the repo. Stage explicit paths, never a directory.
+docs/investor_deck/
+docs/CORTEX_OPENCLAW_AGENT_OS_DESIGN.md
+docs/CORTEX_OPENCLAW_AGENT_OS_DESIGN.pdf

{cortexdb_cli-0.5.2 → cortexdb_cli-0.5.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: cortexdb-cli
-Version: 0.5.2
+Version: 0.5.4
 Summary: Command-line interface for CortexDB — the long-term memory layer for AI.
 Project-URL: Homepage, https://cortexdb.ai
 Project-URL: Documentation, https://cortexdb.ai/docs
@@ -62,8 +62,22 @@ cortexdb recall "Q3 revenue?"
 cortexdb
 ```
 
-The signup token has a 7-day TTL on the free tier. Re-run `cortexdb init`
-to refresh, or pass `--api-key` + `--actor` to use a token from your IdP.
+The signup token has a 7-day TTL on the free tier.
+
+**Re-running `cortexdb init` does not refresh it.** `init` reuses an existing
+identity and changes nothing; against an expired one it refuses and exits 3.
+That is deliberate: a new identity is a new *brain*, and memories written
+under the old actor stay where they are, unreachable from the new config.
+
+When a token expires you have two safe options:
+
+- `cortexdb init --api-key <token> --actor <actor>` — keep the same brain
+  with a token you already hold (e.g. from your IdP).
+- `cortexdb init --force` — deliberately start a NEW brain. The previous
+  identity is backed up to `state.json.replaced` first.
+
+For a second brain alongside the first, isolate instead of replacing:
+`cortexdb --config-dir <dir> init`, or set `CORTEXDB_HOME`.
 
 ## Commands
 
@@ -112,7 +126,9 @@ Force JSON mode any time with `--json`.
 - The v1 API requires both `Authorization: Bearer <PASETO>` and `X-Cortex-Actor`.
   The CLI stamps both on every request — you never need to pass them by hand.
 - 401s show the specific error code (`TOKEN_EXPIRED`, `actor_mismatch`, …)
-  and the remediation: usually `cortexdb init`.
+  and the remediation. Note that `TOKEN_EXPIRED` is **not** fixed by re-running
+  `cortexdb init` — see the identity note above; that would mint a different
+  brain rather than restore access to yours.
 - 403s cite the missing capability and the policy tier that denied. If a
   recall returns `diagnostics.read denied`, pass `--diagnostics none` —
   free-tier tokens don't carry the `diagnostics.read` capability.

{cortexdb_cli-0.5.2 → cortexdb_cli-0.5.4}/README.md

@@ -1,90 +1,106 @@
-# cortexdb-cli
-
-Command-line interface for [CortexDB](https://cortexdb.ai) — the long-term memory layer for AI systems.
-
-Wraps the v1 HTTP API in a small, fast Click + Rich CLI. Anonymous signup
-in one command, no email or card; works against the public SaaS or any
-self-hosted CortexDB deployment.
-
-## Install
-
-```bash
-pip install cortexdb-cli
-```
-
-Requires Python 3.10+.
-
-## Quickstart
-
-```bash
-# 1. One-time setup — anonymous signup, writes ~/.cortexdb/state.json
-cortexdb init
-
-# 2. Store a memory
-cortexdb remember "Q3 revenue: $2.4M. We're on track for $10M ARR by year-end."
-
-# 3. Recall it
-cortexdb recall "Q3 revenue?"
-
-# 4. Or just type — drops into a REPL
-cortexdb
-```
-
-The signup token has a 7-day TTL on the free tier. Re-run `cortexdb init`
-to refresh, or pass `--api-key` + `--actor` to use a token from your IdP.
-
-## Commands
-
-```
-cortexdb init                                 anonymous signup; persist token + actor
-cortexdb remember "..."                       store a memory (POST /v1/experience)
-cortexdb recall   "..."                       recall a stratified context pack
-cortexdb search   "..."                       granular event-level search
-cortexdb forget   --memory-id ...             delete with audit
-cortexdb episodes {list,get,delete}           episode CRUD
-cortexdb entities {list,get,link}             entity rollups over the Facts layer
-cortexdb admin    {health,usage,layers}       diagnostics
-cortexdb import   data.json                   bulk-load (JSON / JSONL / CSV / TXT)
-cortexdb export   -o backup.json              export memories
-cortexdb config   {show,set}                  view / edit ~/.cortexdb/config.toml
-cortexdb                                      interactive REPL
-```
-
-## Configuration
-
-Three layers, in precedence order:
-
-1. **CLI flags** — `--api-key`, `--endpoint`, `--actor`, `--scope`, `--profile`
-2. **Environment** — `CORTEXDB_API_KEY`, `CORTEXDB_URL`, `CORTEXDB_ACTOR`, `CORTEXDB_SCOPE`
-3. **Persisted state**:
-   - `~/.cortexdb/config.toml` — endpoint, profile names (human-editable)
-   - `~/.cortexdb/state.json` — token, actor, scope, expiry (managed by `init`, 0600 on POSIX)
-
-The state.json format matches the cortexdb-mcp 0.3.0 server's, so you can
-copy state across to use both tools from the same anonymous identity.
-
-## Pipe-friendly
-
-Auto-detects when stdout isn't a TTY and emits JSON:
-
-```bash
-cortexdb recall "Q3 revenue" | jq .context_block
-cortexdb entities list      | jq '.[].subject'
-echo "remember this"        | cortexdb remember -
-```
-
-Force JSON mode any time with `--json`.
-
-## Auth notes
-
-- The v1 API requires both `Authorization: Bearer <PASETO>` and `X-Cortex-Actor`.
-  The CLI stamps both on every request — you never need to pass them by hand.
-- 401s show the specific error code (`TOKEN_EXPIRED`, `actor_mismatch`, …)
-  and the remediation: usually `cortexdb init`.
-- 403s cite the missing capability and the policy tier that denied. If a
-  recall returns `diagnostics.read denied`, pass `--diagnostics none` —
-  free-tier tokens don't carry the `diagnostics.read` capability.
-
-## License
-
-Apache-2.0
+# cortexdb-cli
+
+Command-line interface for [CortexDB](https://cortexdb.ai) — the long-term memory layer for AI systems.
+
+Wraps the v1 HTTP API in a small, fast Click + Rich CLI. Anonymous signup
+in one command, no email or card; works against the public SaaS or any
+self-hosted CortexDB deployment.
+
+## Install
+
+```bash
+pip install cortexdb-cli
+```
+
+Requires Python 3.10+.
+
+## Quickstart
+
+```bash
+# 1. One-time setup — anonymous signup, writes ~/.cortexdb/state.json
+cortexdb init
+
+# 2. Store a memory
+cortexdb remember "Q3 revenue: $2.4M. We're on track for $10M ARR by year-end."
+
+# 3. Recall it
+cortexdb recall "Q3 revenue?"
+
+# 4. Or just type — drops into a REPL
+cortexdb
+```
+
+The signup token has a 7-day TTL on the free tier.
+
+**Re-running `cortexdb init` does not refresh it.** `init` reuses an existing
+identity and changes nothing; against an expired one it refuses and exits 3.
+That is deliberate: a new identity is a new *brain*, and memories written
+under the old actor stay where they are, unreachable from the new config.
+
+When a token expires you have two safe options:
+
+- `cortexdb init --api-key <token> --actor <actor>` — keep the same brain
+  with a token you already hold (e.g. from your IdP).
+- `cortexdb init --force` — deliberately start a NEW brain. The previous
+  identity is backed up to `state.json.replaced` first.
+
+For a second brain alongside the first, isolate instead of replacing:
+`cortexdb --config-dir <dir> init`, or set `CORTEXDB_HOME`.
+
+## Commands
+
+```
+cortexdb init                                 anonymous signup; persist token + actor
+cortexdb remember "..."                       store a memory (POST /v1/experience)
+cortexdb recall   "..."                       recall a stratified context pack
+cortexdb search   "..."                       granular event-level search
+cortexdb forget   --memory-id ...             delete with audit
+cortexdb episodes {list,get,delete}           episode CRUD
+cortexdb entities {list,get,link}             entity rollups over the Facts layer
+cortexdb admin    {health,usage,layers}       diagnostics
+cortexdb import   data.json                   bulk-load (JSON / JSONL / CSV / TXT)
+cortexdb export   -o backup.json              export memories
+cortexdb config   {show,set}                  view / edit ~/.cortexdb/config.toml
+cortexdb                                      interactive REPL
+```
+
+## Configuration
+
+Three layers, in precedence order:
+
+1. **CLI flags** — `--api-key`, `--endpoint`, `--actor`, `--scope`, `--profile`
+2. **Environment** — `CORTEXDB_API_KEY`, `CORTEXDB_URL`, `CORTEXDB_ACTOR`, `CORTEXDB_SCOPE`
+3. **Persisted state**:
+   - `~/.cortexdb/config.toml` — endpoint, profile names (human-editable)
+   - `~/.cortexdb/state.json` — token, actor, scope, expiry (managed by `init`, 0600 on POSIX)
+
+The state.json format matches the cortexdb-mcp 0.3.0 server's, so you can
+copy state across to use both tools from the same anonymous identity.
+
+## Pipe-friendly
+
+Auto-detects when stdout isn't a TTY and emits JSON:
+
+```bash
+cortexdb recall "Q3 revenue" | jq .context_block
+cortexdb entities list      | jq '.[].subject'
+echo "remember this"        | cortexdb remember -
+```
+
+Force JSON mode any time with `--json`.
+
+## Auth notes
+
+- The v1 API requires both `Authorization: Bearer <PASETO>` and `X-Cortex-Actor`.
+  The CLI stamps both on every request — you never need to pass them by hand.
+- 401s show the specific error code (`TOKEN_EXPIRED`, `actor_mismatch`, …)
+  and the remediation. Note that `TOKEN_EXPIRED` is **not** fixed by re-running
+  `cortexdb init` — see the identity note above; that would mint a different
+  brain rather than restore access to yours.
+- 403s cite the missing capability and the policy tier that denied. If a
+  recall returns `diagnostics.read denied`, pass `--diagnostics none` —
+  free-tier tokens don't carry the `diagnostics.read` capability.
+
+## License
+
+Apache-2.0

{cortexdb_cli-0.5.2 → cortexdb_cli-0.5.4}/cortexdb_cli/__init__.py

@@ -1,3 +1,3 @@
-"""CortexDB CLI - command-line interface for the v1 memory API."""
-
-__version__ = "0.5.2"
+"""CortexDB CLI - command-line interface for the v1 memory API."""
+
+__version__ = "0.5.4"

{cortexdb_cli-0.5.2 → cortexdb_cli-0.5.4}/cortexdb_cli/client.py

@@ -63,6 +63,14 @@ class CortexClient:
     ) -> httpx.Response:
         return self._http.post(path, json=json, params=params)
 
+    def put(
+        self,
+        path: str,
+        json: dict[str, Any] | None = None,
+        params: dict[str, Any] | None = None,
+    ) -> httpx.Response:
+        return self._http.put(path, json=json, params=params)
+
     def delete(self, path: str, params: dict[str, Any] | None = None) -> httpx.Response:
         return self._http.delete(path, params=params)