smartmemory-client 0.7.0__tar.gz → 1.4.26__tar.gz

{smartmemory_client-0.7.0 → smartmemory_client-1.4.26}/CHANGELOG.md

@@ -5,6 +5,94 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
 ## [Unreleased]
+### Changed (auto, lockstep) — track product version 1.4.26 (1.4.26)
+- Version copied from the smartmemory-core release (single-source lockstep).
+
+### Changed (auto, lockstep) — track product version 1.4.25 (1.4.25)
+- Version copied from the smartmemory-core release (single-source lockstep).
+
+
+### Deprecated (SEC-AUTH-REVOCATION-1 token-prefix, 2026-06-04) — raw-JWT api_key (0.7.8)
+
+- **`SmartMemoryClient(api_key="eyJ…")` now emits a `DeprecationWarning`.** A raw JWT in the
+  `api_key` slot (or `SMARTMEMORY_API_KEY`) is not scoped or revocable per-key. Mint a proper key
+  via `POST /memory/api-keys` and use the new `sm_live_…` / `sm_test_…` prefixes (legacy `sk_…`
+  still works). Properly-prefixed keys emit no warning. Fixed a latent `import warnings` shadowing
+  in `__init__` surfaced by this change.
+
+### Added (CORE-GRAPH-CANONICAL-DEDUP-1, 2026-06-03) — `dedup_entities()` (0.7.7)
+
+- **`client.dedup_entities(dry_run=False, require_structural_confirmation=True)`** — POSTs
+  `/memory/graph/dedup-entities` (both flags as query params). Opt-in graph-maintenance op that collapses
+  same-name cross-extractor entity-node fragments into one node, unblocking ensemble alias disambiguation.
+  Returns `merged_clusters / merged_nodes / redirected_edges / abstained_clusters / dry_run / workspace_id /
+  user_id`. Contract:
+  `smart-memory-docs/docs/features/CORE-GRAPH-CANONICAL-DEDUP-1/dedup-entities-contract.json`.
+
+### Added (CORE-GRAPH-ALIAS-DISAMBIG-1, 2026-06-03) — `resolve_aliases(disambiguate=...)` (0.7.6)
+
+- **`client.resolve_aliases(dry_run=False, disambiguate=False)`** threads the new opt-in collision-
+  disambiguation flag (default off) as a query param; response gains `disambiguated`. Contract:
+  `docs/features/CORE-GRAPH-ALIAS-DISAMBIG-1/disambiguate-contract.json`.
+
+### Added (CORE-GRAPH-ALIAS-RESOLVE-2, 2026-06-02) — `resolve_aliases(dry_run=...)`
+
+- **`client.resolve_aliases(dry_run=False)`** wraps `POST /memory/graph/resolve-aliases`.
+  Merges unambiguous single-token entity aliases ("Hudson") into their multi-token
+  canonical ("Rock Hudson") over the caller's workspace graph, abstaining on collisions.
+  `dry_run` is sent as a **query parameter** (mirrors `cluster()` / the `/clustering/run`
+  precedent), not a JSON body. Returns the parsed report dict: `resolved`, `abstained`,
+  `redirected_edges`, `ambiguous`, `dry_run`, `workspace_id`, `user_id`.
+- Tests: `tests/integration/test_graph_operations.py::TestResolveAliases` (real-service
+  dry-run + default call; auto-skip when the service is unavailable).
+  Contract: `smart-memory-docs/docs/features/CORE-GRAPH-ALIAS-RESOLVE-2/resolve-aliases-contract.json`.
+
+### Added (NEURO-1d, 2026-06-02) — `search(consolidation_first=...)` + `include_consolidated=...`
+
+- **`client.search(..., consolidation_first=True)`** surfaces a consolidated summary above the
+  scattered source memories it consolidates — best for synthesis queries ("what is known about X?").
+  Opt-in; implies `include_consolidated`. **`include_consolidated=True`** includes consolidated
+  source memories (normally hidden). Both default off → request body omits the keys, so existing
+  callers are byte-identical on the wire.
+- Tests: `tests/test_client.py::TestSearchConsolidationParams` (body serialization + default-omit).
+  Contract: `smart-memory-docs/docs/features/CORE-SEARCH-1/search-contract.json`.
+
+### Added (CORE-AGENT-2, 2026-05-24) — `get_evaluation()` + `list_evaluation_history()`
+
+- **`client.get_evaluation(agent_id, dimension, domain)`** — wraps `GET /memory/agents/{agent_id}/evaluation`. Returns `dict | None`; cold-start (no evaluation written yet) returns `None` cleanly per the contract (`200 {evaluation: null}` from the service). Raises `SmartMemoryNotFoundError` (404) for cross-tenant / unknown agent.
+- **`client.list_evaluation_history(agent_id, dimension, domain, limit=...)`** — wraps `GET /memory/agents/{agent_id}/evaluation/history`. Returns a list of historical evaluation rows in supersession order.
+- 8 new tests in `tests/test_client_evaluation.py` (happy / 404 / cold-start / pagination).
+
+Source: `smart-memory-docs/docs/features/CORE-AGENT-2/report.md`. Contract: `smart-memory-docs/docs/features/CORE-AGENT-2/evaluation-contract.json`.
+
+### Added (CORE-DECISION-PROVENANCE-LOOKUP-1, 2026-05-23) — `list_decisions(provenance_memory_id=...)`
+
+- **`list_decisions()`** gains an optional `provenance_memory_id` kwarg. When set, the SDK passes it through to `GET /memory/decisions?provenance_memory_id=<id>` and returns only active decisions whose provenance subgraph contains that memory. Other filters (`domain`, `decision_type`, `min_confidence`, `limit`) compose in-query — the SDK never sees a truncated-below-limit result. Backwards-compatible; existing callers see no behavior change.
+
+
+### Changed (CORE-RECALL-LINEAGE-1 Phase 3, 2026-05-22) — SearchResponse envelope unwrap
+
+- **`SmartMemoryClient.search()`** now always unwraps the `{results, group_roots, citations?}` envelope. Callers continue to receive `List[MemoryItem]` — no signature change. The envelope siblings are exposed on the client instance:
+  - `client.last_group_roots: Dict[str, GroupRootStub]` — canonicals that didn't match the query, keyed by root_id. Each stub: `{item_id, accessible, content_preview?, memory_type?, origin?}`.
+  - `client.last_citations: List[Citation]` — unchanged from RECALL-CITATIONS-1; now sourced from the envelope sibling instead of the legacy double-wrap.
+- **`MemoryItem`** dataclass gains `origin: Optional[str]` and `lineage_roots: List[str]`. `from_dict` reads both. Backwards-compatible with old (pre-envelope) responses — missing keys default to `None` / `[]`.
+- Pre-envelope service responses (bare list) still parse correctly during rollout — the client tolerates both shapes.
+
+### Added (RECALL-CITATIONS-1, 2026-05-10)
+
+- **`SmartMemoryClient.search(cite=True)`** opts into the citation-ready response. The wire response is `{results, citations}`; the client unwraps `results` (callers continue to receive `List[MemoryItem]`) and exposes the citation array via the new `client.last_citations` property. Each citation has shape `{n, item_id, item_type, preview, score, footnote_marker}` per the RECALL-CITATIONS-1 contract. `last_citations` is `[]` when `cite=False` or when there are no results.
+
+### Changed (CORE-EXPERTISE-1 Phase 4b, 2026-05-08)
+
+- **README gains "Expertise Layer" API section.** Shows `client.create_decision(..., rejected_alternatives=, rationale=, constraints=)` for capture and `client.search(query, expertise=True)` returning the typed dict for recall. Links to the canonical 1-pager. No code change.
+
+### Added (CORE-EXPERTISE-1 Phase 4a, 2026-05-08)
+
+- **`SmartMemoryClient.search(..., expertise=False)` parameter added.** When `True`, returns `Dict[str, List[MemoryItem]]` keyed by expertise type (decision/constraint/learned/opinion/reasoning/observation), each bucket capped at `top_k`. Default returns `List[MemoryItem]` — no breaking change. Forwarded as `expertise: true` in the POST body; response parsing branches on the flag (parses `{results: {<bucket>: [...]}}`). Contract: `smart-memory-docs/docs/features/CORE-EXPERTISE-1/expertise-search-contract.json`.
+
+### Added (CORE-EXPERTISE-1 Phase 1, 2026-05-07)
+
+- **`SmartMemoryClient.create_decision()` accepts `rejected_alternatives`, `rationale`, `constraints`.** Three new optional kwargs forwarded to `POST /memory/decisions/create` as snake_case payload keys; omitted entirely when unset (no `null`-leakage). 2 new contract tests in `tests/test_decision_methods.py`. Feature folder: `smart-memory-docs/docs/features/CORE-EXPERTISE-1/phase-1-decision-schema/`.
 
 ## [0.7.0] — 2026-05-04
 

{smartmemory_client-0.7.0/smartmemory_client.egg-info → smartmemory_client-1.4.26}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: smartmemory-client
-Version: 0.7.0
+Version: 1.4.26
 Summary: Python client for SmartMemory Service API
 Author-email: SmartMemory Team <team@smartmemory.dev>
 License: MIT
@@ -34,6 +34,8 @@ Dynamic: license-file
 
 # SmartMemory Python Client
 
+**Version:** 0.7.0
+
 Official Python client for the [SmartMemory Service](https://github.com/smartmemory/smart-memory-service) API.
 
 [![PyPI version](https://badge.fury.io/py/smartmemory-client.svg)](https://badge.fury.io/py/smartmemory-client)
@@ -143,6 +145,31 @@ fixtures will inject them automatically.
 
 ## API Reference
 
+### Expertise Layer
+
+SmartMemory's [expertise layer](https://docs.smartmemory.ai/smartmemory/concepts/expertise-vs-knowledge) — `decision`, `constraint`, `learned`, `opinion`, `reasoning`, `observation` — has dedicated capture and recall surfaces in this SDK.
+
+#### Capture
+
+```python
+client.create_decision(
+    title="Adopt FalkorDB",
+    rejected_alternatives=["Neo4j", "Memgraph"],
+    rationale="Smallest ops surface; vector-native; permissive license.",
+    constraints=["Must support Cypher subset"],
+)
+```
+
+#### Recall (partitioned by expertise type)
+
+```python
+results = client.search("graph database choice", expertise=True)
+# Dict[str, List[MemoryItem]] keyed by:
+# decision / constraint / learned / opinion / reasoning / observation
+```
+
+Default `client.search(query)` returns `List[MemoryItem]` (flat) — no breaking change. Setting `expertise=True` switches the response shape; the SDK parses it into the typed dict.
+
 ### Memory Operations
 
 #### Add Memory
@@ -545,3 +572,7 @@ See [CHANGELOG.md](CHANGELOG.md) for version history.
 ---
 
 **Made with ❤️ by the SmartMemory Team**
+
+## Documentation
+
+Full SmartMemory documentation: https://docs.smartmemory.ai

{smartmemory_client-0.7.0 → smartmemory_client-1.4.26}/README.md

@@ -1,5 +1,7 @@
 # SmartMemory Python Client
 
+**Version:** 0.7.0
+
 Official Python client for the [SmartMemory Service](https://github.com/smartmemory/smart-memory-service) API.
 
 [![PyPI version](https://badge.fury.io/py/smartmemory-client.svg)](https://badge.fury.io/py/smartmemory-client)
@@ -109,6 +111,31 @@ fixtures will inject them automatically.
 
 ## API Reference
 
+### Expertise Layer
+
+SmartMemory's [expertise layer](https://docs.smartmemory.ai/smartmemory/concepts/expertise-vs-knowledge) — `decision`, `constraint`, `learned`, `opinion`, `reasoning`, `observation` — has dedicated capture and recall surfaces in this SDK.
+
+#### Capture
+
+```python
+client.create_decision(
+    title="Adopt FalkorDB",
+    rejected_alternatives=["Neo4j", "Memgraph"],
+    rationale="Smallest ops surface; vector-native; permissive license.",
+    constraints=["Must support Cypher subset"],
+)
+```
+
+#### Recall (partitioned by expertise type)
+
+```python
+results = client.search("graph database choice", expertise=True)
+# Dict[str, List[MemoryItem]] keyed by:
+# decision / constraint / learned / opinion / reasoning / observation
+```
+
+Default `client.search(query)` returns `List[MemoryItem]` (flat) — no breaking change. Setting `expertise=True` switches the response shape; the SDK parses it into the typed dict.
+
 ### Memory Operations
 
 #### Add Memory
@@ -511,3 +538,7 @@ See [CHANGELOG.md](CHANGELOG.md) for version history.
 ---
 
 **Made with ❤️ by the SmartMemory Team**
+
+## Documentation
+
+Full SmartMemory documentation: https://docs.smartmemory.ai

smartmemory_client-1.4.26/VERSION

@@ -0,0 +1 @@
+1.4.26