cognimemo-client 0.9.2__tar.gz

cognimemo_client-0.9.2/.gitignore

@@ -0,0 +1,42 @@
+# Python
+__pycache__/
+*.py[oc]
+build/
+dist/
+wheels/
+*.egg-info
+
+# Virtual environments
+.venv/
+
+# Node
+node_modules/
+**/.next
+
+# Environment
+.env
+.env.bak*
+.env.*.bak
+.env.local
+
+# IDE
+.idea/
+.vscode/
+*.swp
+*.swo
+
+# OS
+.DS_Store
+
+# Test
+.pytest_cache/
+.mypy_cache/
+test-results/
+
+# MCP / Claude
+.mcp.json
+.claude/*
+
+# Docker
+docker-compose.yml
+docker-compose.override.yml

cognimemo_client-0.9.2/.openapi-generator/FILES

@@ -0,0 +1,194 @@
+.openapi-generator-ignore
+cognimemo_client_api/__init__.py
+cognimemo_client_api/api/__init__.py
+cognimemo_client_api/api/audit_api.py
+cognimemo_client_api/api/bank_templates_api.py
+cognimemo_client_api/api/banks_api.py
+cognimemo_client_api/api/directives_api.py
+cognimemo_client_api/api/document_transfer_api.py
+cognimemo_client_api/api/documents_api.py
+cognimemo_client_api/api/entities_api.py
+cognimemo_client_api/api/files_api.py
+cognimemo_client_api/api/knowledge_base_api.py
+cognimemo_client_api/api/llm_traces_api.py
+cognimemo_client_api/api/memory_api.py
+cognimemo_client_api/api/mental_models_api.py
+cognimemo_client_api/api/monitoring_api.py
+cognimemo_client_api/api/operations_api.py
+cognimemo_client_api/api/spaces_api.py
+cognimemo_client_api/api/webhooks_api.py
+cognimemo_client_api/api_client.py
+cognimemo_client_api/api_response.py
+cognimemo_client_api/configuration.py
+cognimemo_client_api/exceptions.py
+cognimemo_client_api/models/__init__.py
+cognimemo_client_api/models/add_background_request.py
+cognimemo_client_api/models/async_operation_submit_response.py
+cognimemo_client_api/models/audit_log_entry.py
+cognimemo_client_api/models/audit_log_list_response.py
+cognimemo_client_api/models/audit_log_stats_bucket.py
+cognimemo_client_api/models/audit_log_stats_response.py
+cognimemo_client_api/models/background_response.py
+cognimemo_client_api/models/bank_config_response.py
+cognimemo_client_api/models/bank_config_update.py
+cognimemo_client_api/models/bank_list_item.py
+cognimemo_client_api/models/bank_list_response.py
+cognimemo_client_api/models/bank_llm_health_response.py
+cognimemo_client_api/models/bank_profile_response.py
+cognimemo_client_api/models/bank_space_response.py
+cognimemo_client_api/models/bank_stats_response.py
+cognimemo_client_api/models/bank_template_config.py
+cognimemo_client_api/models/bank_template_directive.py
+cognimemo_client_api/models/bank_template_import_response.py
+cognimemo_client_api/models/bank_template_manifest.py
+cognimemo_client_api/models/bank_template_mental_model.py
+cognimemo_client_api/models/budget.py
+cognimemo_client_api/models/cancel_operation_response.py
+cognimemo_client_api/models/child_operation_status.py
+cognimemo_client_api/models/chunk_data.py
+cognimemo_client_api/models/chunk_include_options.py
+cognimemo_client_api/models/chunk_response.py
+cognimemo_client_api/models/clear_memory_observations_response.py
+cognimemo_client_api/models/consolidation_request.py
+cognimemo_client_api/models/consolidation_response.py
+cognimemo_client_api/models/create_bank_request.py
+cognimemo_client_api/models/create_directive_request.py
+cognimemo_client_api/models/create_folder_request.py
+cognimemo_client_api/models/create_knowledge_page_response.py
+cognimemo_client_api/models/create_mental_model_request.py
+cognimemo_client_api/models/create_mental_model_response.py
+cognimemo_client_api/models/create_page_request.py
+cognimemo_client_api/models/create_webhook_request.py
+cognimemo_client_api/models/delete_document_response.py
+cognimemo_client_api/models/delete_operation_response.py
+cognimemo_client_api/models/delete_response.py
+cognimemo_client_api/models/directive_list_response.py
+cognimemo_client_api/models/directive_response.py
+cognimemo_client_api/models/disposition_traits.py
+cognimemo_client_api/models/document_export_submit_response.py
+cognimemo_client_api/models/document_import_submit_response.py
+cognimemo_client_api/models/document_response.py
+cognimemo_client_api/models/dry_run_extract_request.py
+cognimemo_client_api/models/dry_run_extraction_result.py
+cognimemo_client_api/models/entity_detail_response.py
+cognimemo_client_api/models/entity_graph_response.py
+cognimemo_client_api/models/entity_include_options.py
+cognimemo_client_api/models/entity_input.py
+cognimemo_client_api/models/entity_list_item.py
+cognimemo_client_api/models/entity_list_response.py
+cognimemo_client_api/models/entity_observation_response.py
+cognimemo_client_api/models/entity_state_response.py
+cognimemo_client_api/models/extracted_fact.py
+cognimemo_client_api/models/features_info.py
+cognimemo_client_api/models/file_retain_response.py
+cognimemo_client_api/models/graph_data_response.py
+cognimemo_client_api/models/http_validation_error.py
+cognimemo_client_api/models/include_options.py
+cognimemo_client_api/models/knowledge_node.py
+cognimemo_client_api/models/knowledge_page_bundle_file.py
+cognimemo_client_api/models/knowledge_page_bundle_response.py
+cognimemo_client_api/models/knowledge_page_response.py
+cognimemo_client_api/models/knowledge_page_search_response.py
+cognimemo_client_api/models/knowledge_page_search_result.py
+cognimemo_client_api/models/knowledge_tree_response.py
+cognimemo_client_api/models/label_group_input.py
+cognimemo_client_api/models/label_group_output.py
+cognimemo_client_api/models/label_value.py
+cognimemo_client_api/models/list_chunks_response.py
+cognimemo_client_api/models/list_documents_response.py
+cognimemo_client_api/models/list_memory_units_response.py
+cognimemo_client_api/models/list_tags_response.py
+cognimemo_client_api/models/liveness_response.py
+cognimemo_client_api/models/llm_call_trace.py
+cognimemo_client_api/models/llm_operation_health.py
+cognimemo_client_api/models/llm_request_entry.py
+cognimemo_client_api/models/llm_request_list_response.py
+cognimemo_client_api/models/llm_request_stats_bucket.py
+cognimemo_client_api/models/llm_request_stats_response.py
+cognimemo_client_api/models/llm_request_token_sums.py
+cognimemo_client_api/models/map_field_input.py
+cognimemo_client_api/models/map_field_output.py
+cognimemo_client_api/models/memories_timeseries_response.py
+cognimemo_client_api/models/memory_item.py
+cognimemo_client_api/models/memory_timeseries_bucket.py
+cognimemo_client_api/models/mental_model_delta_operations.py
+cognimemo_client_api/models/mental_model_dry_run_refresh_result.py
+cognimemo_client_api/models/mental_model_fact_counts.py
+cognimemo_client_api/models/mental_model_list_response.py
+cognimemo_client_api/models/mental_model_refresh_scope.py
+cognimemo_client_api/models/mental_model_refresh_scope_tag_groups_inner.py
+cognimemo_client_api/models/mental_model_refresh_trace.py
+cognimemo_client_api/models/mental_model_refresh_window.py
+cognimemo_client_api/models/mental_model_response.py
+cognimemo_client_api/models/mental_model_retraction.py
+cognimemo_client_api/models/mental_model_trace_tool_call.py
+cognimemo_client_api/models/mental_model_trigger_input.py
+cognimemo_client_api/models/mental_model_trigger_input_tag_groups_inner.py
+cognimemo_client_api/models/mental_model_trigger_output.py
+cognimemo_client_api/models/min_scores.py
+cognimemo_client_api/models/model_not.py
+cognimemo_client_api/models/not1.py
+cognimemo_client_api/models/observation_scope.py
+cognimemo_client_api/models/observation_scopes.py
+cognimemo_client_api/models/observation_scopes_response.py
+cognimemo_client_api/models/operation_progress.py
+cognimemo_client_api/models/operation_response.py
+cognimemo_client_api/models/operation_status_response.py
+cognimemo_client_api/models/operations_list_response.py
+cognimemo_client_api/models/recall_request.py
+cognimemo_client_api/models/recall_response.py
+cognimemo_client_api/models/recall_result.py
+cognimemo_client_api/models/recall_scores.py
+cognimemo_client_api/models/recall_usage.py
+cognimemo_client_api/models/recover_consolidation_response.py
+cognimemo_client_api/models/reflect_based_on.py
+cognimemo_client_api/models/reflect_directive.py
+cognimemo_client_api/models/reflect_fact.py
+cognimemo_client_api/models/reflect_include_options.py
+cognimemo_client_api/models/reflect_llm_call.py
+cognimemo_client_api/models/reflect_mental_model.py
+cognimemo_client_api/models/reflect_request.py
+cognimemo_client_api/models/reflect_response.py
+cognimemo_client_api/models/reflect_tool_call.py
+cognimemo_client_api/models/reflect_trace.py
+cognimemo_client_api/models/refresh_mental_model_operation_details.py
+cognimemo_client_api/models/reprocess_document_response.py
+cognimemo_client_api/models/retain_request.py
+cognimemo_client_api/models/retain_response.py
+cognimemo_client_api/models/retry_operation_response.py
+cognimemo_client_api/models/source_facts_include_options.py
+cognimemo_client_api/models/space_bank_item.py
+cognimemo_client_api/models/space_bank_list_response.py
+cognimemo_client_api/models/space_item.py
+cognimemo_client_api/models/space_list_response.py
+cognimemo_client_api/models/tag_group_and_input.py
+cognimemo_client_api/models/tag_group_and_output.py
+cognimemo_client_api/models/tag_group_leaf.py
+cognimemo_client_api/models/tag_group_not_input.py
+cognimemo_client_api/models/tag_group_not_output.py
+cognimemo_client_api/models/tag_group_or_input.py
+cognimemo_client_api/models/tag_group_or_output.py
+cognimemo_client_api/models/tag_item.py
+cognimemo_client_api/models/temporal_window.py
+cognimemo_client_api/models/timestamp.py
+cognimemo_client_api/models/token_usage.py
+cognimemo_client_api/models/tool_calls_include_options.py
+cognimemo_client_api/models/update_directive_request.py
+cognimemo_client_api/models/update_disposition_request.py
+cognimemo_client_api/models/update_document_request.py
+cognimemo_client_api/models/update_document_response.py
+cognimemo_client_api/models/update_memory_request.py
+cognimemo_client_api/models/update_mental_model_request.py
+cognimemo_client_api/models/update_node_request.py
+cognimemo_client_api/models/update_webhook_request.py
+cognimemo_client_api/models/upsert_space_request.py
+cognimemo_client_api/models/validation_error.py
+cognimemo_client_api/models/validation_error_loc_inner.py
+cognimemo_client_api/models/version_response.py
+cognimemo_client_api/models/webhook_delivery_list_response.py
+cognimemo_client_api/models/webhook_delivery_response.py
+cognimemo_client_api/models/webhook_http_config.py
+cognimemo_client_api/models/webhook_list_response.py
+cognimemo_client_api/models/webhook_response.py
+cognimemo_client_api/rest.py
+cognimemo_client_api_README.md

cognimemo_client-0.9.2/.openapi-generator/VERSION

@@ -0,0 +1 @@
+7.10.0

cognimemo_client-0.9.2/.openapi-generator-ignore

@@ -0,0 +1,23 @@
+# OpenAPI Generator Ignore
+# Generated by openapi-generator https://github.com/openapitools/openapi-generator
+
+# Use this file to prevent files from being overwritten by the generator.
+# The patterns follow closely to .gitignore or .dockerignore.
+
+# As an example, the C# client generator defines ApiClient.cs.
+# You can make changes and tell OpenAPI Generator to ignore just this file by uncommenting the following line:
+#ApiClient.cs
+
+# You can match any string of characters against a directory, file or extension with a single asterisk (*):
+#foo/*/qux
+# The above matches foo/bar/qux and foo/baz/qux, but not foo/bar/baz/qux
+
+# You can recursively match patterns against a directory, file or extension with a double asterisk (**):
+#foo/**/qux
+# This matches foo/bar/qux, foo/baz/qux, and foo/bar/baz/qux
+
+# You can also negate patterns with an exclamation (!).
+# For example, you can ignore all files in a docs folder with the file extension .md:
+#docs/*.md
+# Then explicitly reverse the ignore rule for a single file:
+#!docs/README.md

cognimemo_client-0.9.2/PKG-INFO

@@ -0,0 +1,136 @@
+Metadata-Version: 2.5
+Name: cognimemo-client
+Version: 0.9.2
+Summary: Python client for Cognimemo - Semantic memory system with personality-driven thinking
+Author: Cognimemo Team
+License-Expression: MIT
+Requires-Python: >=3.10
+Requires-Dist: aiohttp-retry>=2.8.3
+Requires-Dist: aiohttp>=3.8.4
+Requires-Dist: pydantic>=2
+Requires-Dist: python-dateutil>=2.8.2
+Requires-Dist: typing-extensions>=4.7.1
+Requires-Dist: urllib3<3.0.0,>=2.1.0
+Provides-Extra: test
+Requires-Dist: pytest-asyncio>=0.21.0; extra == 'test'
+Requires-Dist: pytest>=7.0.0; extra == 'test'
+Requires-Dist: requests>=2.33.0; extra == 'test'
+Description-Content-Type: text/markdown
+
+# Cognimemo Python Client
+
+`@cognimemo/client` — the official Python SDK for the Cognimemo memory layer.
+Talks to the Cognimemo gateway with a per-project API key (Bearer auth).
+
+> **Verified working (2026-08-30):** installs clean; every typed helper below and
+> type-filtered / layered recall were smoke-tested against a live gateway. Recall
+> round-trips through the full stack in ~70 ms.
+
+## Install
+
+```bash
+pip install cognimemo-client        # published as @cognimemo/client
+```
+
+## Quickstart
+
+```python
+from cognimemo_client.cognimemo_client import Cognimemo
+
+cm = Cognimemo(base_url="https://api.cognimemo.com", api_key="cmk_live_…")
+
+cm.retain(bank_id="jane@acme.com", content="Jane ships on Fridays.")
+res = cm.recall(bank_id="jane@acme.com", query="when does jane ship?")
+for r in res.results:
+    print(r.type, r.text, r.occurred_start, r.scores)
+```
+
+Prefer `await cm.aretain(...)` / `await cm.arecall(...)` in async code; the
+non-`a` methods are sync wrappers.
+
+## Data model — space (org) → bank (person) → memories
+
+Pass `space=` to `retain` / `recall` / `reflect` to scope a bank into its
+organization (the bank is attached on first use), or manage spaces explicitly:
+
+```python
+cm.create_space("acme", name="Acme Corp")
+cm.retain(bank_id="jane@acme.com", content="Jane prefers dark mode", space="acme")
+cm.recall(bank_id="jane@acme.com", query="what does jane prefer?", space="acme")
+
+cm.list_spaces()                    # orgs with per-org person counts
+cm.list_space_banks("acme")         # people inside an org
+cm.add_bank_to_space("acme", "raj@acme.com")
+cm.remove_bank_from_space("acme", "raj@acme.com")   # person + memories kept
+cm.delete_space("acme")             # people become unassigned, never deleted
+```
+
+## Typed memory blocks
+
+Beyond auto-extracted facts/observations, store first-class blocks directly
+(verbatim, no LLM rewrite) — recallable and filterable by type. The eight types
+are `world`, `experience`, `observation`, `procedure`, `reasoning`,
+`preference`, `correction`, `profile`.
+
+```python
+cm.retain_preference("jane@acme.com", "For day-planning, use personal Gmail, never work mail.")
+cm.retain_procedure("jane@acme.com", ["tag main", "sync Argo", "run sims", "promote"], rationale="never on Friday")
+cm.retain_reasoning("jane@acme.com", "Chose gRPC over REST: p99 latency mattered more than tooling.")
+cm.retain_correction("jane@acme.com", "No — use Xero, not QuickBooks.")
+cm.update_profile("jane@acme.com", "Uses Xero + Slack; admin on the orion cluster.")
+
+# any type directly:
+cm.retain(bank_id="jane@acme.com", content="Acme HQ is in Berlin.", fact_type="world")
+
+cm.recall(bank_id="jane@acme.com", query="how to deploy", types=["procedure"])   # type-filtered
+cm.recall_layered("jane@acme.com", "policy", space="acme")  # blend person + org (__org__:acme)
+```
+
+Typed helpers put the bank in verbatim (`chunks`) mode on first use so the block
+is stored exactly as written.
+
+## Layered / org memory
+
+Each space has an implicit org bank at `__org__:{space}`. Retain shared knowledge
+there, then blend it into a person's recall (person wins on conflict):
+
+```python
+cm.retain(bank_id="__org__:acme", content="Deploy freeze every December.")
+cm.recall(bank_id="jane@acme.com", query="deploy policy",
+          space="acme", include_org=True)          # or cm.recall_layered(...)
+```
+
+## Entities
+
+Supply entities explicitly (the note-taker model — the agent knows them):
+
+```python
+cm.retain(bank_id="jane@acme.com",
+          content="Jane joined the DeepMind team on Gemini.",
+          entities=[{"text": "Jane", "type": "PERSON"},
+                    {"text": "DeepMind", "type": "ORG"},
+                    {"text": "Gemini", "type": "PROJECT"}])
+
+cm.entities.list_entities("jane@acme.com")     # canonicalized, deduped, with mention_count
+```
+
+For verbatim ingest without supplied entities, enable no-LLM auto-extraction on
+the bank (off by default): set config `retain_auto_entities: true` and it derives
+proper-noun/acronym entities from the text.
+
+## Recall response shape
+
+`recall(...)` returns `RecallResponse` with `.results` (a list of `MemoryFact`)
+and `.usage`. Each `MemoryFact` carries:
+
+| field | meaning |
+|---|---|
+| `type` | the fact type (world … profile) |
+| `text`, `context` | the memory body (decrypted transparently if encryption is on) |
+| `occurred_start` / `occurred_end` / `mentioned_at` | temporal anchors |
+| `entities` | linked entity names |
+| `scores` | `{final, semantic, keyword}` |
+| `metadata`, `tags`, `document_id`, `chunk_id` | provenance |
+
+`.usage` reports `{tokens_used, max_tokens, truncated}` (and `org_blended` for
+layered recall).

cognimemo_client-0.9.2/README.md

@@ -0,0 +1,117 @@
+# Cognimemo Python Client
+
+`@cognimemo/client` — the official Python SDK for the Cognimemo memory layer.
+Talks to the Cognimemo gateway with a per-project API key (Bearer auth).
+
+> **Verified working (2026-08-30):** installs clean; every typed helper below and
+> type-filtered / layered recall were smoke-tested against a live gateway. Recall
+> round-trips through the full stack in ~70 ms.
+
+## Install
+
+```bash
+pip install cognimemo-client        # published as @cognimemo/client
+```
+
+## Quickstart
+
+```python
+from cognimemo_client.cognimemo_client import Cognimemo
+
+cm = Cognimemo(base_url="https://api.cognimemo.com", api_key="cmk_live_…")
+
+cm.retain(bank_id="jane@acme.com", content="Jane ships on Fridays.")
+res = cm.recall(bank_id="jane@acme.com", query="when does jane ship?")
+for r in res.results:
+    print(r.type, r.text, r.occurred_start, r.scores)
+```
+
+Prefer `await cm.aretain(...)` / `await cm.arecall(...)` in async code; the
+non-`a` methods are sync wrappers.
+
+## Data model — space (org) → bank (person) → memories
+
+Pass `space=` to `retain` / `recall` / `reflect` to scope a bank into its
+organization (the bank is attached on first use), or manage spaces explicitly:
+
+```python
+cm.create_space("acme", name="Acme Corp")
+cm.retain(bank_id="jane@acme.com", content="Jane prefers dark mode", space="acme")
+cm.recall(bank_id="jane@acme.com", query="what does jane prefer?", space="acme")
+
+cm.list_spaces()                    # orgs with per-org person counts
+cm.list_space_banks("acme")         # people inside an org
+cm.add_bank_to_space("acme", "raj@acme.com")
+cm.remove_bank_from_space("acme", "raj@acme.com")   # person + memories kept
+cm.delete_space("acme")             # people become unassigned, never deleted
+```
+
+## Typed memory blocks
+
+Beyond auto-extracted facts/observations, store first-class blocks directly
+(verbatim, no LLM rewrite) — recallable and filterable by type. The eight types
+are `world`, `experience`, `observation`, `procedure`, `reasoning`,
+`preference`, `correction`, `profile`.
+
+```python
+cm.retain_preference("jane@acme.com", "For day-planning, use personal Gmail, never work mail.")
+cm.retain_procedure("jane@acme.com", ["tag main", "sync Argo", "run sims", "promote"], rationale="never on Friday")
+cm.retain_reasoning("jane@acme.com", "Chose gRPC over REST: p99 latency mattered more than tooling.")
+cm.retain_correction("jane@acme.com", "No — use Xero, not QuickBooks.")
+cm.update_profile("jane@acme.com", "Uses Xero + Slack; admin on the orion cluster.")
+
+# any type directly:
+cm.retain(bank_id="jane@acme.com", content="Acme HQ is in Berlin.", fact_type="world")
+
+cm.recall(bank_id="jane@acme.com", query="how to deploy", types=["procedure"])   # type-filtered
+cm.recall_layered("jane@acme.com", "policy", space="acme")  # blend person + org (__org__:acme)
+```
+
+Typed helpers put the bank in verbatim (`chunks`) mode on first use so the block
+is stored exactly as written.
+
+## Layered / org memory
+
+Each space has an implicit org bank at `__org__:{space}`. Retain shared knowledge
+there, then blend it into a person's recall (person wins on conflict):
+
+```python
+cm.retain(bank_id="__org__:acme", content="Deploy freeze every December.")
+cm.recall(bank_id="jane@acme.com", query="deploy policy",
+          space="acme", include_org=True)          # or cm.recall_layered(...)
+```
+
+## Entities
+
+Supply entities explicitly (the note-taker model — the agent knows them):
+
+```python
+cm.retain(bank_id="jane@acme.com",
+          content="Jane joined the DeepMind team on Gemini.",
+          entities=[{"text": "Jane", "type": "PERSON"},
+                    {"text": "DeepMind", "type": "ORG"},
+                    {"text": "Gemini", "type": "PROJECT"}])
+
+cm.entities.list_entities("jane@acme.com")     # canonicalized, deduped, with mention_count
+```
+
+For verbatim ingest without supplied entities, enable no-LLM auto-extraction on
+the bank (off by default): set config `retain_auto_entities: true` and it derives
+proper-noun/acronym entities from the text.
+
+## Recall response shape
+
+`recall(...)` returns `RecallResponse` with `.results` (a list of `MemoryFact`)
+and `.usage`. Each `MemoryFact` carries:
+
+| field | meaning |
+|---|---|
+| `type` | the fact type (world … profile) |
+| `text`, `context` | the memory body (decrypted transparently if encryption is on) |
+| `occurred_start` / `occurred_end` / `mentioned_at` | temporal anchors |
+| `entities` | linked entity names |
+| `scores` | `{final, semantic, keyword}` |
+| `metadata`, `tags`, `document_id`, `chunk_id` | provenance |
+
+`.usage` reports `{tokens_used, max_tokens, truncated}` (and `org_blended` for
+layered recall).

cognimemo_client-0.9.2/cognimemo_client/__init__.py

@@ -0,0 +1,164 @@
+"""
+Cognimemo Client - Clean, pythonic wrapper for the Cognimemo API.
+
+This package provides a high-level ``Cognimemo`` class with simplified methods
+for the most common operations (retain, recall, reflect, banks, mental models,
+directives).
+
+For operations not available as convenience methods — such as documents,
+entities, async operations, webhooks, and monitoring — use the low-level API
+clients exposed as properties on the ``Cognimemo`` instance (e.g.
+``client.documents``, ``client.entities``, ``client.operations``).
+All low-level methods are async.
+
+Quick start::
+
+    from cognimemo_client import Cognimemo
+
+    client = Cognimemo(base_url="http://localhost:8888")
+
+    # Store a memory
+    client.retain(bank_id="alice", content="Alice loves AI")
+
+    # Search memories
+    response = client.recall(bank_id="alice", query="What does Alice like?")
+    for r in response.results:
+        print(r.text)
+
+    # Generate contextual answer
+    answer = client.reflect(bank_id="alice", query="What are my interests?")
+    print(answer.text)
+
+Low-level API access::
+
+    import asyncio
+
+    # List documents
+    docs = asyncio.run(client.documents.list_documents("alice"))
+
+    # Check operation status
+    status = asyncio.run(client.operations.get_operation_status("alice", "op-id"))
+
+    # List entities
+    entities = asyncio.run(client.entities.list_entities("alice"))
+"""
+
+from cognimemo_client_api.models.bank_profile_response import BankProfileResponse
+from cognimemo_client_api.models.disposition_traits import DispositionTraits
+from cognimemo_client_api.models.list_memory_units_response import ListMemoryUnitsResponse
+from cognimemo_client_api.models.recall_response import RecallResponse as _RecallResponse
+from cognimemo_client_api.models.recall_result import RecallResult as _RecallResult
+from cognimemo_client_api.models.reflect_fact import ReflectFact
+from cognimemo_client_api.models.reflect_response import ReflectResponse
+
+# Re-export response types for convenient access
+from cognimemo_client_api.models.retain_response import RetainResponse
+from cognimemo_client_api.models.version_response import VersionResponse
+
+from .cognimemo_client import Cognimemo
+
+
+# Add cleaner __repr__ and __iter__ for REPL usability
+def _recall_result_repr(self):
+    text_preview = self.text[:80] + "..." if len(self.text) > 80 else self.text
+    return f"RecallResult(id='{self.id[:8]}...', type='{self.type}', text='{text_preview}')"
+
+
+def _recall_response_repr(self):
+    count = len(self.results) if self.results else 0
+    extras = []
+    if self.trace:
+        extras.append("trace=True")
+    if self.entities:
+        extras.append(f"entities={len(self.entities)}")
+    if self.chunks:
+        extras.append(f"chunks={len(self.chunks)}")
+    extras_str = ", " + ", ".join(extras) if extras else ""
+    return f"RecallResponse({count} results{extras_str})"
+
+
+def _recall_response_iter(self):
+    """Iterate directly over results for convenience."""
+    return iter(self.results or [])
+
+
+def _recall_response_len(self):
+    """Return number of results."""
+    return len(self.results) if self.results else 0
+
+
+def _recall_response_getitem(self, index):
+    """Access results by index."""
+    return self.results[index]
+
+
+def _recall_response_to_prompt_string(self) -> str:
+    """Serialize the recall response to a string suitable for LLM prompts.
+
+    Builds a prompt containing:
+    - Facts: each result as a JSON object with ``text``, ``context``, and
+      temporal fields (``occurred_start``, ``occurred_end``, ``mentioned_at``).
+      If the result has a ``chunk_id`` matching a chunk in the response, the
+      chunk text is included as ``source_chunk``.
+    - Entities: entity summaries from observations, formatted as sections.
+
+    This mirrors the format used internally by Cognimemo's reflect operation.
+    """
+    import json
+
+    chunks_map = self.chunks or {}
+    sections: list[str] = []
+
+    # Facts
+    formatted_facts: list[dict] = []
+    for result in self.results or []:
+        fact_obj: dict = {"text": result.text}
+        if result.context:
+            fact_obj["context"] = result.context
+        for field in ("occurred_start", "occurred_end", "mentioned_at"):
+            value = getattr(result, field, None)
+            if value:
+                fact_obj[field] = value
+        if result.chunk_id and result.chunk_id in chunks_map:
+            fact_obj["source_chunk"] = chunks_map[result.chunk_id].text
+        formatted_facts.append(fact_obj)
+    sections.append("FACTS:\n" + json.dumps(formatted_facts, indent=2))
+
+    # Entities
+    if self.entities:
+        entity_parts: list[str] = []
+        for name, state in self.entities.items():
+            if state.observations:
+                obs_text = state.observations[0].text
+                entity_parts.append(f"## {name}\n{obs_text}")
+        if entity_parts:
+            sections.append("ENTITIES:\n" + "\n\n".join(entity_parts))
+
+    return "\n\n".join(sections)
+
+
+_RecallResponse.to_prompt_string = _recall_response_to_prompt_string
+
+_RecallResult.__repr__ = _recall_result_repr
+_RecallResponse.__repr__ = _recall_response_repr
+_RecallResponse.__iter__ = _recall_response_iter
+_RecallResponse.__len__ = _recall_response_len
+_RecallResponse.__getitem__ = _recall_response_getitem
+
+# Re-export with patched repr
+RecallResult = _RecallResult
+RecallResponse = _RecallResponse
+
+__all__ = [
+    "Cognimemo",
+    # Response types
+    "RetainResponse",
+    "RecallResponse",
+    "RecallResult",
+    "ReflectResponse",
+    "ReflectFact",
+    "ListMemoryUnitsResponse",
+    "BankProfileResponse",
+    "DispositionTraits",
+    "VersionResponse",
+]