cade-cli 0.15.6__tar.gz → 0.15.7__tar.gz

{cade_cli-0.15.6 → cade_cli-0.15.7}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: cade-cli
-Version: 0.15.6
+Version: 0.15.7
 Summary: Cade - The CLI Agent from Arcade.dev
 Project-URL: Homepage, https://arcade.dev
 Project-URL: Documentation, https://docs.arcade.dev

{cade_cli-0.15.6 → cade_cli-0.15.7}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "cade-cli"
-version = "0.15.6"
+version = "0.15.7"
 description = "Cade - The CLI Agent from Arcade.dev"
 readme = "README.md"
 requires-python = ">=3.11"

{cade_cli-0.15.6 → cade_cli-0.15.7}/src/cade_mcp_local/resources.py

@@ -116,7 +116,7 @@ def register_resources(app: MCPApp, instructions: str) -> None:
         title="cade mem sources (active persona)",
         description=(
             "JSON listing of memory sources registered for the active persona "
-            "(equivalent to `cade mem list`). Read each call so the listing "
+            "(equivalent to `cade mem sources`). Read each call so the listing "
             "reflects sources added after server start."
         ),
         mime_type="application/json",

{cade_cli-0.15.6 → cade_cli-0.15.7}/src/cadecoder/cli/commands/mem.py

@@ -10,7 +10,7 @@ from __future__ import annotations
 
 import os
 from pathlib import Path
-from typing import Any
+from typing import Annotated, Any
 
 import typer
 from rich.console import Console
@@ -53,14 +53,19 @@ def _apply_memory_env() -> Path:
 def _load_librarian_app() -> Any:
     """Import and return librarian's Typer app (lazy, after the env is set).
 
-    The app is rebranded under ``cade mem``: the low-level ``index`` group is
-    replaced by a top-level ``update`` command (the former ``index build``) and
-    a cade-native ``status`` command that reports the current agent's memory
-    under "Agent Memory" branding.
+    The app is rebranded under ``cade mem``:
+
+    * the low-level ``index`` group becomes a top-level ``update`` command (the
+      former ``index build``);
+    * a cade-native ``status`` command reports the current agent's memory under
+      "Agent Memory" branding;
+    * ``list`` shows the agent's memory **documents** (what users expect from
+      "list"), while the source-directory listing moves to ``sources``.
     """
     from librarian.cli import app
 
     _remap_index_to_update(app)
+    _remap_list_to_docs(app)
     _add_status_command(app)
     return app
 
@@ -97,6 +102,52 @@ def _remap_index_to_update(app: Any) -> None:
         )(build_callback)
 
 
+def _remap_list_to_docs(app: Any) -> None:
+    """Make ``cade mem list`` show memory *documents*, not source directories.
+
+    librarian's top-level ``list`` lists registered source directories — a
+    power-user concept. Under ``cade mem``, "list" should show what's actually
+    in the agent's memory (its indexed documents, including anything the agent
+    saved via ``Memory_*`` tools). So the source listing moves to
+    ``cade mem sources`` and ``list`` is replaced by a cade-native command that
+    renders documents with the same output (and flags) as the in-chat
+    ``/mem list``.
+
+    Power users keep librarian's ``cade mem docs list`` (``--source`` /
+    ``--format`` / ``paths``) untouched.
+
+    Idempotent: safe to call more than once on the same app singleton.
+    """
+    if "sources" in _command_names(app):
+        return  # already remapped
+
+    commands = list(app.registered_commands)
+    list_sources_callback = next(
+        (
+            rc.callback
+            for rc in commands
+            if (rc.name or getattr(rc.callback, "__name__", "")) == "list"
+        ),
+        None,
+    )
+    if list_sources_callback is None:
+        return  # librarian build without a top-level `list` — leave as-is
+
+    # Drop the original top-level `list` (sources), re-register it as `sources`,
+    # and install the cade-native document listing as `list`.
+    app.registered_commands = [
+        rc for rc in commands if (rc.name or getattr(rc.callback, "__name__", "")) != "list"
+    ]
+    app.command(
+        name="sources",
+        help="List the source directories that feed this agent's memory.",
+    )(list_sources_callback)
+    app.command(
+        name="list",
+        help="List the documents stored in this agent's memory.",
+    )(_cade_mem_list)
+
+
 def _add_status_command(app: Any) -> None:
     """Register the cade-native ``status`` command (idempotent)."""
     if "status" in _command_names(app):
@@ -161,6 +212,86 @@ def _mem_status() -> None:
     out.print(table)
 
 
+def _mem_list(*, json_output: bool = False, limit: int = 50) -> None:
+    """Render the documents stored in the current agent's memory.
+
+    The single source of truth for both ``cade mem list`` (CLI) and the in-chat
+    ``/mem list`` command, so the two surfaces always agree. Reads the agent's
+    index directly via ``Database(db_path=...)`` (no env / no HOME side effects)
+    so it never clobbers a long-lived session, mirroring ``_read_memory_stats``.
+
+    Args:
+        json_output: Emit a JSON array (id/title/path/type) to stdout instead of
+            a table — for scripting and piping.
+        limit: Maximum number of documents to display.
+    """
+    import json
+
+    from rich.console import Console as _Console
+    from rich.table import Table
+
+    runtime = get_runtime()
+    memory_dir = ensure_memory_dir(runtime.persona_name)
+    db_path = memory_dir / ".librarian" / "index.db"
+
+    out = _Console()
+
+    documents: list[Any] = []
+    if db_path.exists():
+        try:
+            from librarian.storage.database import Database
+
+            documents = Database(db_path=str(db_path)).list_documents()
+        except Exception as exc:  # noqa: BLE001
+            if json_output:
+                print("[]")
+            else:
+                out.print(f"[red]Could not read this agent's memory:[/red] {exc}")
+            return
+
+    if json_output:
+        payload = [
+            {
+                "id": doc.id,
+                "title": doc.title,
+                "path": doc.path,
+                "type": doc.asset_type.value if getattr(doc, "asset_type", None) else "text",
+            }
+            for doc in documents[:limit]
+        ]
+        print(json.dumps(payload, indent=2, default=str))
+        return
+
+    if not documents:
+        out.print(
+            "[dim]No documents in this agent's memory yet — add docs or run 'cade mem update'.[/dim]"
+        )
+        return
+
+    home = str(Path.home())
+    table = Table(
+        title=f"Agent Memory — {len(documents)} document(s)",
+        show_header=True,
+        header_style="bold cyan",
+    )
+    table.add_column("ID", style="dim", width=4)
+    table.add_column("Title", style="green", max_width=44)
+    table.add_column("Path", style="blue", overflow="fold")
+    for doc in documents[:limit]:
+        table.add_row(str(doc.id), doc.title or "Untitled", doc.path.replace(home, "~"))
+    out.print(table)
+    if len(documents) > limit:
+        out.print(f"[dim]Showing {limit} of {len(documents)}. Use --limit to see more.[/dim]")
+
+
+def _cade_mem_list(
+    json_output: Annotated[bool, typer.Option("--json", help="Output as JSON")] = False,
+    limit: Annotated[int, typer.Option("--limit", "-l", help="Max documents to show")] = 50,
+) -> None:
+    """List the documents stored in this agent's memory."""
+    _mem_list(json_output=json_output, limit=limit)
+
+
 def _run_mem(args: list[str]) -> int:
     """Run librarian's CLI in-process, branded as ``cade mem``.
 
@@ -248,7 +379,9 @@ def mem_command(ctx: typer.Context) -> None:
 __all__ = (
     "MEM_CONTEXT_SETTINGS",
     "_apply_memory_env",
+    "_cade_mem_list",
     "_load_librarian_app",
+    "_mem_list",
     "_run_mem",
     "_warm_memory",
     "mem_command",

{cade_cli-0.15.6 → cade_cli-0.15.7}/src/cadecoder/ui/session.py

@@ -884,10 +884,10 @@ class ChatSession:
         console.print("[cyan]Switching to voice mode — keeping this conversation…[/cyan]")
 
     async def _handle_mem_command(self, cmd: str) -> None:
-        """Handle /mem (Agent Memory status) and /mem search <query>.
+        """Handle /mem (status), /mem list (documents), and /mem search <query>.
 
-        The bare/`status` view reuses the same renderer as the ``cade mem`` CLI
-        so the Agent Memory experience is identical in both surfaces.
+        The status and list views reuse the same renderers as the ``cade mem``
+        CLI so the Agent Memory experience is identical in both surfaces.
         """
         parts = cmd.split(None, 2)
         sub = parts[1] if len(parts) >= 2 else "status"
@@ -898,6 +898,12 @@ class ChatSession:
             _mem_status()
             return
 
+        if sub in ("list", "ls", "docs"):
+            from cadecoder.cli.commands.mem import _mem_list
+
+            _mem_list()
+            return
+
         if sub == "search" and len(parts) >= 3:
             query = parts[2]
             try:
@@ -913,7 +919,7 @@ class ChatSession:
                 )
             return
 
-        console.print("[dim]Usage: /mem [status] | /mem search <query>[/dim]")
+        console.print("[dim]Usage: /mem [status] | /mem list | /mem search <query>[/dim]")
 
     @staticmethod
     def _print_mem_search_results(result: object) -> None:

{cade_cli-0.15.6 → cade_cli-0.15.7}/src/cadecoder/ui/slash.py

@@ -51,7 +51,7 @@ SLASH_COMMANDS: tuple[SlashCommand, ...] = (
         ("list", "add", "remove", "enable", "disable"),
     ),
     SlashCommand("/hooks", " …", "Manage lifecycle hooks", ("list", "reload")),
-    SlashCommand("/mem", " …", "Search/manage memory", ("status", "search")),
+    SlashCommand("/mem", " …", "Search/manage memory", ("status", "list", "search")),
     SlashCommand("/notify", " <msg>", "Send a push notification"),
     SlashCommand("/pwd", "", "Show current directory", hidden=True),
     SlashCommand("/cd", " <path>", "Change directory", hidden=True),