memanto 0.2.2__tar.gz → 0.2.4__tar.gz

memanto-0.2.4/.github/workflows/sdk-typescript.yml

@@ -0,0 +1,80 @@
+name: TypeScript SDK
+
+on:
+  push:
+    branches: main
+    paths:
+      - "memanto/app/**"
+      - "sdks/typescript/**"
+      - ".github/workflows/sdk-typescript.yml"
+  pull_request:
+    paths:
+      - "memanto/app/**"
+      - "sdks/typescript/**"
+      - ".github/workflows/sdk-typescript.yml"
+
+permissions:
+  contents: read
+
+jobs:
+  openapi-drift:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v4
+
+      - name: Install dependencies
+        run: uv sync --all-extras --dev
+
+      - name: Create version fallback
+        run: echo '__version__ = "0.0.0.dev0"' > memanto/app/_version.py
+
+      - name: Generate fresh OpenAPI spec
+        run: |
+          uv run python -c "
+          import json
+          from memanto.app.main import app
+          print(json.dumps(app.openapi(), indent=2))
+          " > /tmp/openapi.fresh.json
+
+      - name: Diff against committed spec
+        run: |
+          diff -u sdks/typescript/openapi.json /tmp/openapi.fresh.json \
+            || (echo "::error::OpenAPI drift detected. Run \`npm run openapi:regenerate\` in sdks/typescript and commit." && exit 1)
+
+  build:
+    runs-on: ubuntu-latest
+    defaults:
+      run:
+        working-directory: sdks/typescript
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Node
+        uses: actions/setup-node@v4
+        with:
+          node-version: "20"
+          cache: "npm"
+          cache-dependency-path: sdks/typescript/package-lock.json
+
+      - name: Install dependencies
+        run: npm ci || npm install
+
+      - name: Generate client from committed spec
+        run: npm run openapi:generate
+
+      - name: Typecheck
+        run: npm run typecheck
+
+      - name: Build
+        run: npm run build
+
+      - name: Test
+        run: npm test

{memanto-0.2.2 → memanto-0.2.4}/.gitignore

@@ -104,3 +104,6 @@ temp/
 
 # Generated version file
 **/_version.py
+
+# npm pack output
+*.tgz

{memanto-0.2.2 → memanto-0.2.4}/CONTRIBUTING.md

@@ -265,7 +265,7 @@ Rules:
 
 ## Community
 
-- **Discord**: [Join our server](https://discord.gg/CyxRFQSQ3p) — the best place for quick questions and discussions
+- **Discord**: [Join our server](https://memanto.ai/discord) — the best place for quick questions and discussions
 - **GitHub Issues**: https://github.com/moorcheh-ai/memanto/issues — bugs and feature requests
 - **Email**: support@moorcheh.ai — for anything that doesn't fit the above
 - **Docs**: https://docs.memanto.ai

{memanto-0.2.2 → memanto-0.2.4}/PKG-INFO

@@ -1,7 +1,7 @@
 Metadata-Version: 2.4
 Name: memanto
-Version: 0.2.2
-Summary: A companion memory agent with its own intelligence that keeps your agents focused on their tasks.
+Version: 0.2.4
+Summary: A companion memory agent that lets your agents focus and improve while you keep ownership of everything they learn.
 Project-URL: Homepage, https://www.moorcheh.ai
 Project-URL: Documentation, https://docs.moorcheh.ai
 Project-URL: Repository, https://github.com/moorcheh-ai/memanto
@@ -55,11 +55,11 @@ Description-Content-Type: text/markdown
 </p>
 
 <div align="center">
-  <h1>Your agents focus. Memanto remembers.</h1>
+  <h1>Memory that AI Agents Love!</h1>
 </div>
 
 <h2 align="center">
-  <em>A companion memory agent with its own intelligence that keeps your agents focused on their tasks.</em>
+  <em>A companion memory agent that lets your agents focus and improve while you keep ownership of everything they learn.</em>
 </h2>
 
 <p align="center">
@@ -67,7 +67,7 @@ Description-Content-Type: text/markdown
 </p>
 
 <p align="center">
-  <a href="https://discord.gg/CyxRFQSQ3p">
+  <a href="https://memanto.ai/discord">
     <img src="https://img.shields.io/badge/Join-Discord-5865F2?style=for-the-badge&logo=discord&logoColor=white" alt="Join Discord">
   </a>
   <a href="https://www.youtube.com/watch?v=vEtOaoweIG4">
@@ -233,8 +233,8 @@ This means Memanto doesn't need a separate vector DB, embedding pipeline, or rer
 | System status dashboard | `memanto status` | View environment, configuration, server health, active session, and registered agents. |
 | Local REST API + Web UI | `memanto serve`, `memanto ui` | Run the MEMANTO REST API locally and open an interactive browser UI. (Optional for CLI usage). |
 | Agent lifecycle management | `memanto agent ...` | Create/list/delete agents, activate/deactivate sessions, and run `agent bootstrap` for an intelligence snapshot. |
-| Memory capture at scale | `memanto remember` | Store single memories with metadata or batch-ingest up to 100 records from JSON. |
-| Single-memory deletion | `memanto forget` | Delete one bad or outdated memory from the active agent after confirmation, or without the prompt with `--force`. |
+| Memory capture at scale | `memanto remember` | Store single memories, batch-ingest from JSON, or `--from-conversation` to automatically extract facts from chat logs. |
+| Single-memory editing & deletion | `memanto edit`, `memanto forget` | Update fields on an existing memory, or permanently delete a bad/outdated memory. |
 | File upload to memory | `memanto upload` | Upload documents (.pdf, .docx, .xlsx, .json, .txt, .csv, .md) directly into an agent's memory namespace — content becomes instantly searchable via `recall`. |
 | Advanced retrieval modes | `memanto recall` | Run standard search plus temporal queries (`--as-of`, `--changed-since`) with filters. |
 | Grounded QA over memory | `memanto answer` | Generate RAG answers using retrieved memory context. |
@@ -256,6 +256,12 @@ Use memory types to categorize what you store so retrieval is cleaner and more c
 
 ---
 
+## 📦 SDKs
+
+- **TypeScript / Node.js** — [`@moorcheh-ai/memanto`](sdks/typescript) — boots a local Memanto server via `uvx` and exposes an ergonomic `Memanto` client (`remember` / `recall` / `answer`).
+
+---
+
 ## REST API
 
 Memanto exposes a session-based REST API for programmatic access. Start the server locally:
@@ -290,7 +296,7 @@ Full endpoint reference is available at [docs.memanto.ai/api](https://docs.meman
 
 Have questions or feedback? We're here to help:
 - **Docs**: [https://docs.memanto.ai](https://docs.memanto.ai)
-- **Discord**: [Join our Discord server](https://discord.gg/CyxRFQSQ3p)
+- **Discord**: [Join our Discord server](https://memanto.ai/discord)
 - **Email**: support@moorcheh.ai
 - **X / Twitter**: [@moorcheh_ai](https://x.com/moorcheh_ai)
 

{memanto-0.2.2 → memanto-0.2.4}/README.md

@@ -5,11 +5,11 @@
 </p>
 
 <div align="center">
-  <h1>Your agents focus. Memanto remembers.</h1>
+  <h1>Memory that AI Agents Love!</h1>
 </div>
 
 <h2 align="center">
-  <em>A companion memory agent with its own intelligence that keeps your agents focused on their tasks.</em>
+  <em>A companion memory agent that lets your agents focus and improve while you keep ownership of everything they learn.</em>
 </h2>
 
 <p align="center">
@@ -17,7 +17,7 @@
 </p>
 
 <p align="center">
-  <a href="https://discord.gg/CyxRFQSQ3p">
+  <a href="https://memanto.ai/discord">
     <img src="https://img.shields.io/badge/Join-Discord-5865F2?style=for-the-badge&logo=discord&logoColor=white" alt="Join Discord">
   </a>
   <a href="https://www.youtube.com/watch?v=vEtOaoweIG4">
@@ -183,8 +183,8 @@ This means Memanto doesn't need a separate vector DB, embedding pipeline, or rer
 | System status dashboard | `memanto status` | View environment, configuration, server health, active session, and registered agents. |
 | Local REST API + Web UI | `memanto serve`, `memanto ui` | Run the MEMANTO REST API locally and open an interactive browser UI. (Optional for CLI usage). |
 | Agent lifecycle management | `memanto agent ...` | Create/list/delete agents, activate/deactivate sessions, and run `agent bootstrap` for an intelligence snapshot. |
-| Memory capture at scale | `memanto remember` | Store single memories with metadata or batch-ingest up to 100 records from JSON. |
-| Single-memory deletion | `memanto forget` | Delete one bad or outdated memory from the active agent after confirmation, or without the prompt with `--force`. |
+| Memory capture at scale | `memanto remember` | Store single memories, batch-ingest from JSON, or `--from-conversation` to automatically extract facts from chat logs. |
+| Single-memory editing & deletion | `memanto edit`, `memanto forget` | Update fields on an existing memory, or permanently delete a bad/outdated memory. |
 | File upload to memory | `memanto upload` | Upload documents (.pdf, .docx, .xlsx, .json, .txt, .csv, .md) directly into an agent's memory namespace — content becomes instantly searchable via `recall`. |
 | Advanced retrieval modes | `memanto recall` | Run standard search plus temporal queries (`--as-of`, `--changed-since`) with filters. |
 | Grounded QA over memory | `memanto answer` | Generate RAG answers using retrieved memory context. |
@@ -206,6 +206,12 @@ Use memory types to categorize what you store so retrieval is cleaner and more c
 
 ---
 
+## 📦 SDKs
+
+- **TypeScript / Node.js** — [`@moorcheh-ai/memanto`](sdks/typescript) — boots a local Memanto server via `uvx` and exposes an ergonomic `Memanto` client (`remember` / `recall` / `answer`).
+
+---
+
 ## REST API
 
 Memanto exposes a session-based REST API for programmatic access. Start the server locally:
@@ -240,7 +246,7 @@ Full endpoint reference is available at [docs.memanto.ai/api](https://docs.meman
 
 Have questions or feedback? We're here to help:
 - **Docs**: [https://docs.memanto.ai](https://docs.memanto.ai)
-- **Discord**: [Join our Discord server](https://discord.gg/CyxRFQSQ3p)
+- **Discord**: [Join our Discord server](https://memanto.ai/discord)
 - **Email**: support@moorcheh.ai
 - **X / Twitter**: [@moorcheh_ai](https://x.com/moorcheh_ai)
 

{memanto-0.2.2 → memanto-0.2.4}/docs/CLI_USER_GUIDE.md

@@ -20,7 +20,7 @@
 
 ## Introduction
 
-MEMANTO CLI provides a command-line interface for interacting with MEMANTO (Your agents focus. Memanto remembers.). It enables you to:
+MEMANTO CLI provides a command-line interface for interacting with MEMANTO (Memory that AI Agents Love!). It enables you to:
 
 - Create and manage AI agents
 - Store and retrieve agent memories

{memanto-0.2.2 → memanto-0.2.4}/docs/GETTING_STARTED.md

@@ -8,7 +8,7 @@
 
 ## What is MEMANTO?
 
-MEMANTO (Your agents focus. Memanto remembers.) is a production-ready FastAPI service that gives your AI agents persistent memory across conversations, sessions, and workflows.
+MEMANTO (Memory that AI Agents Love!) is a production-ready FastAPI service that gives your AI agents persistent memory across conversations, sessions, and workflows.
 
 **Think of it as**: A PostgreSQL database, but optimized for AI agents - with semantic search, AI-powered summarization, and built specifically for agent workflows.
 
@@ -278,7 +278,16 @@ You'll see all 17 API endpoints with interactive testing!
       "content": "MEMANTO is working",
       "type": "fact",
       "confidence": 1.0,
-      "created_at": "2025-12-28T10:30:00Z"
+      "status": "active",
+      "tags": [],
+      "source": "agent",
+      "source_ref": null,
+      "provenance": "explicit_statement",
+      "validation_count": 0,
+      "contradiction_detected": false,
+      "score": 0.92,
+      "created_at": "2025-12-28T10:30:00Z",
+      "updated_at": "2025-12-28T10:30:00Z"
     }
   ]
 }

{memanto-0.2.2 → memanto-0.2.4}/docs/V2_QUICK_START.md

@@ -326,6 +326,7 @@ except httpx.HTTPStatusError as e:
 
 - **Full Documentation**: [SESSION_ARCHITECTURE.md](SESSION_ARCHITECTURE.md)
 - **API Reference**: http://localhost:8000/docs
+- **TypeScript SDK**: See [`@moorcheh-ai/memanto`](../sdks/typescript) for the Node.js/TypeScript client
 
 ---
 

{memanto-0.2.2 → memanto-0.2.4}/integrations/mcp/memanto_mcp/tools.py

@@ -95,6 +95,17 @@ class MemoryHit(BaseModel):
     content: str | None = None
     confidence: float | None = None
     tags: list[str] = Field(default_factory=list)
+    status: str | None = None
+    source: str | None = Field(
+        default=None, description="Origin of the memory (e.g. user, agent, tool)."
+    )
+    source_ref: str | None = Field(
+        default=None, description="Reference to the source (e.g. file name, tool id)."
+    )
+    provenance: str | None = Field(
+        default=None,
+        description="How the memory was obtained (explicit_statement, inferred, ...).",
+    )
     created_at: str | None = None
     score: float | None = Field(
         default=None, description="Similarity score when available."
@@ -893,6 +904,10 @@ def _to_memory_hit(raw: dict[str, Any]) -> MemoryHit:
         content=raw.get("content"),
         confidence=raw.get("confidence"),
         tags=list(raw.get("tags") or []),
+        status=raw.get("status"),
+        source=raw.get("source"),
+        source_ref=raw.get("source_ref"),
+        provenance=raw.get("provenance"),
         created_at=str(raw.get("created_at")) if raw.get("created_at") else None,
         score=(
             raw.get("score")

memanto-0.2.4/memanto/__init__.py

@@ -0,0 +1,3 @@
+"""
+Memanto - Memory that AI Agents Love!
+"""

{memanto-0.2.2 → memanto-0.2.4}/memanto/app/_version.py

@@ -18,7 +18,7 @@ version_tuple: tuple[int | str, ...]
 commit_id: str | None
 __commit_id__: str | None
 
-__version__ = version = '0.2.2'
-__version_tuple__ = version_tuple = (0, 2, 2)
+__version__ = version = '0.2.4'
+__version_tuple__ = version_tuple = (0, 2, 4)
 
 __commit_id__ = commit_id = None

{memanto-0.2.2 → memanto-0.2.4}/memanto/app/constants.py

@@ -73,4 +73,13 @@ VALID_PROVENANCE_TYPES = {
 
 VALID_SCOPE_TYPES = {"user", "workspace", "agent", "session", "project", "task"}
 
+ALLOWED_UPDATE_FIELDS = {
+    "title",
+    "content",
+    "type",
+    "confidence",
+    "tags",
+    "source",
+}
+
 VALID_PATTERNS = {"support", "project", "tool"}

{memanto-0.2.2 → memanto-0.2.4}/memanto/app/main.py

@@ -64,7 +64,7 @@ async def lifespan(_: FastAPI):
 
 # Create FastAPI app
 app = FastAPI(
-    title="Memanto - Your agents focus. Memanto remembers.",
+    title="Memanto - Memory that AI Agents Love!",
     description="A memory layer service for agentic AI systems using Moorcheh SDK",
     version=__version__,
     docs_url="/docs",
@@ -97,7 +97,7 @@ mount_ui_static(app)
 async def root():
     return {
         "service": "MEMANTO",
-        "description": "A companion memory agent with its own intelligence that keeps your agents focused on their tasks.",
+        "description": "A companion memory agent that lets your agents focus and improve while you keep ownership of everything they learn.",
         "version": __version__,
         "docs": "/docs",
     }

{memanto-0.2.2 → memanto-0.2.4}/memanto/app/models/__init__.py

@@ -89,6 +89,38 @@ class BatchRememberRequest(BaseModel):
     )
 
 
+class ConversationMessage(BaseModel):
+    """Chat-style message used for conversation memory extraction."""
+
+    role: str = Field(..., min_length=1, max_length=50)
+    content: str = Field(..., min_length=1, max_length=10000)
+
+
+class ExtractMemoriesRequest(BaseModel):
+    """Request body for extracting typed memories from conversation turns."""
+
+    messages: list[ConversationMessage] = Field(
+        ...,
+        min_length=1,
+        max_length=200,
+        description="Conversation turns to extract durable memories from",
+    )
+    dry_run: bool = Field(
+        False,
+        description="When true, return candidates without storing them",
+    )
+    max_memories: int = Field(
+        20,
+        ge=1,
+        le=100,
+        description="Maximum candidate memories to extract",
+    )
+    ai_model: str | None = Field(
+        None,
+        description="Optional model override for extraction",
+    )
+
+
 class SupersedeRequest(BaseModel):
     """Request body for supersede endpoint"""
 
@@ -348,3 +380,102 @@ class HealthResponse(BaseModel):
     service: str
     version: str
     moorcheh_connected: bool
+
+
+# Session-based v2 endpoint responses (typed for OpenAPI codegen)
+
+
+class MemoryItem(BaseModel):
+    """Single memory record as returned by recall/answer endpoints."""
+
+    id: str | None = None
+    title: str = ""
+    content: str = ""
+    text: str = ""
+    type: str | None = None
+    confidence: float | None = None
+    status: str | None = None
+    tags: list[str] = Field(default_factory=list)
+    created_at: str | None = None
+    updated_at: str | None = None
+    expires_at: str | None = None
+    ttl_seconds: int | None = None
+    actor_id: str | None = None
+    source: str | None = None
+    scope_type: str | None = None
+    scope_id: str | None = None
+    score: float | None = None
+    provenance: str = "explicit_statement"
+    validation_count: int = 0
+    contradiction_detected: bool = False
+    superseded_by: str | None = None
+    supersedes: str | None = None
+    validated_at: str | None = None
+    change_type: str | None = None
+
+
+class RememberResponse(BaseModel):
+    memory_id: str
+    agent_id: str
+    session_id: str
+    namespace: str
+    status: str
+    provenance: str
+    confidence: float
+    type: str | None = None
+
+
+class BatchRememberResultItem(BaseModel):
+    id: str
+    status: str
+    action: str | None = None
+    reason: str | None = None
+    error: str | None = None
+    type: str | None = None
+
+
+class BatchRememberResponse(BaseModel):
+    agent_id: str
+    session_id: str
+    namespace: str
+    total_submitted: int
+    successful: int
+    failed: int
+    results: list[BatchRememberResultItem]
+
+
+class UploadFileResponse(BaseModel):
+    agent_id: str
+    session_id: str
+    namespace: str
+    file_name: str
+    file_size: int | None = None
+    status: str
+    message: str = ""
+
+
+class RecallResponse(BaseModel):
+    agent_id: str
+    session_id: str
+    query: str
+    memories: list[MemoryItem]
+    count: int
+
+
+class TemporalRecallResponse(BaseModel):
+    agent_id: str
+    session_id: str
+    memories: list[MemoryItem]
+    count: int
+    temporal_mode: str
+    as_of_date: str | None = None
+    since_date: str | None = None
+
+
+class AnswerResponse(BaseModel):
+    agent_id: str
+    session_id: str
+    question: str
+    answer: str
+    sources: list[Any] = Field(default_factory=list)
+    namespace: str