deeptutor-memory 1.7.0__py3-none-any.whl

deeptutor_cli/memory.py

@@ -0,0 +1,99 @@
+"""CLI memory commands for the three-layer memory subsystem (v2)."""
+
+from __future__ import annotations
+
+from rich.console import Console
+from rich.markdown import Markdown
+from rich.panel import Panel
+import typer
+
+from deeptutor.services.memory import (
+    L3_SLOTS,
+    SURFACES,
+    get_memory_store,
+    paths,
+)
+
+console = Console()
+
+
+def register(app: typer.Typer) -> None:
+    @app.command("show")
+    def memory_show(
+        target: str = typer.Argument(
+            "L3",
+            help="What to show: 'L3' (all four global docs), 'L2' (all seven surface docs), or a single doc name (e.g. 'profile', 'chat').",
+        ),
+    ) -> None:
+        """Display memory document content."""
+        store = get_memory_store()
+
+        if target == "L3":
+            text = store.read_l3_concat()
+            console.print(Panel(Markdown(text), title="[bold]L3 (concatenated)[/]"))
+            return
+
+        if target == "L2":
+            for surface in SURFACES:
+                content = store.read_raw("L2", surface)
+                if content.strip():
+                    console.print(Panel(Markdown(content), title=f"[bold]L2/{surface}.md[/]"))
+                else:
+                    console.print(f"[dim]L2/{surface}.md: (empty)[/]")
+            return
+
+        # Single doc name — resolve to L2 or L3.
+        if target in L3_SLOTS:
+            content = store.read_raw("L3", target)
+            label = f"L3/{target}.md"
+        elif target in SURFACES:
+            content = store.read_raw("L2", target)
+            label = f"L2/{target}.md"
+        else:
+            console.print(
+                f"[red]Unknown doc: {target}. Use 'L2', 'L3', a surface ({', '.join(SURFACES)}), or a slot ({', '.join(L3_SLOTS)}).[/]"
+            )
+            raise typer.Exit(1)
+
+        if content.strip():
+            console.print(Panel(Markdown(content), title=f"[bold]{label}[/]"))
+        else:
+            console.print(f"[dim]{label}: (empty)[/]")
+
+    @app.command("clear")
+    def memory_clear(
+        target: str = typer.Argument(
+            "all",
+            help="What to clear: 'all' (entire memory), 'trace' (all L1 trace), or a surface name to clear that surface's L1.",
+        ),
+        force: bool = typer.Option(False, "--force", "-f", help="Skip confirmation."),
+    ) -> None:
+        """Clear memory (use 'all' for a full reset, or a surface name for L1 only)."""
+        if target != "all" and target != "trace" and target not in SURFACES:
+            console.print(f"[red]Unknown target: {target}[/]")
+            raise typer.Exit(1)
+
+        if not force:
+            label = "all memory" if target == "all" else f"L1 trace for {target}"
+            if not typer.confirm(f"Clear {label}?"):
+                raise typer.Abort()
+
+        if target == "all":
+            root = paths.memory_root()
+            for entry in root.iterdir() if root.exists() else []:
+                if entry.is_file():
+                    entry.unlink()
+                elif entry.is_dir() and entry.name in {"trace", "L2", "L3"}:
+                    for child in entry.rglob("*"):
+                        if child.is_file():
+                            child.unlink()
+            console.print("[green]Cleared all memory.[/]")
+        elif target == "trace":
+            for surface in SURFACES:
+                for f in paths.trace_dir(surface).glob("*.jsonl"):
+                    f.unlink()
+            console.print("[green]Cleared all L1 trace.[/]")
+        else:
+            for f in paths.trace_dir(target).glob("*.jsonl"):  # type: ignore[arg-type]
+                f.unlink()
+            console.print(f"[green]Cleared L1 trace for {target}.[/]")

deeptutor_memory-1.7.0.dist-info/METADATA

@@ -0,0 +1,6 @@
+Metadata-Version: 2.4
+Name: deeptutor-memory
+Version: 1.7.0
+Summary: DeepTutor memory module
+Requires-Python: <3.15,>=3.11
+Requires-Dist: deeptutor==1.7.0

deeptutor_memory-1.7.0.dist-info/RECORD

@@ -0,0 +1,50 @@
+deeptutor/agents/loop/native_memory.py,sha256=JC1-jl3ThT6oz46oDQEWssD7DpzMAUQbVF18M-Dd33g,857
+deeptutor/api/routers/memory.py,sha256=MaPlFRxIshqSxC_zqiVUM5SupLJ7Y4BH27MSokf8MdY,26305
+deeptutor/services/memory/__init__.py,sha256=ARou8XCxeXZ9Ci6MYp5xjLmg8n7RtjrNpIaDYbCw7Ss,1248
+deeptutor/services/memory/document.py,sha256=jnwTVKSGjzxBCRTmGPn_vB8hBy5t33mBKwI8bXmbalA,8249
+deeptutor/services/memory/ids.py,sha256=9NeGCXlbLQJdCZeFLTNLPVJWY9kjgFVqCEtnyV_Ztfc,2670
+deeptutor/services/memory/ops.py,sha256=OOA4j4SCcjFBhu-_maBvYCFycbJDNmRQ1OEWyggWL-0,5237
+deeptutor/services/memory/paths.py,sha256=uG7TPD68rW2pvJvHdvYuVWOq8lG31yo595jO0wUrpRQ,3027
+deeptutor/services/memory/recall.py,sha256=GEs9n1KGPfKDX8mawMUy0VhyG73PUoZNiuL3HAtc14c,8527
+deeptutor/services/memory/settings.py,sha256=ZMaI83iipDakC8-6vlWhzjqidlZbGllHkvP4Psm960w,6123
+deeptutor/services/memory/store.py,sha256=_spHZS7NP7ghVyNYcPi1LGzxuz7SofSTzkLUmBF_qUA,17468
+deeptutor/services/memory/trace.py,sha256=ci0wxweeHNPA_0TAAvUJ-A9ohOz9CxF359EO5IBBQWQ,4832
+deeptutor/services/memory/consolidator/__init__.py,sha256=2ixbdCtGmjQM3-vR5T8Bf-hkCVD0YuOsnvnIXar_NRs,2183
+deeptutor/services/memory/consolidator/chunker.py,sha256=O15nxQhGP5JZIvLDKJos_sh_K2SVOtilrPNNpKfmnAE,4507
+deeptutor/services/memory/consolidator/guards.py,sha256=rZ2tz50apMUMIhVQh1BM1bMBeQB7RAOZfpnlLBLKCrQ,2889
+deeptutor/services/memory/consolidator/line_doc.py,sha256=3kJMvlhi0VyPa-oP20gzN0_qfoFYcGJjP5vyFFXw0G8,17278
+deeptutor/services/memory/consolidator/meta.py,sha256=Nu8QZDbihvKayYQgFeJNWn9rFEFKQfk7nglSxc3wXKA,5331
+deeptutor/services/memory/consolidator/parse.py,sha256=n9PTs8yg4olQtDNq9NIGcumpWYXKOUouFhpytsdfxZk,4545
+deeptutor/services/memory/consolidator/references.py,sha256=ufTe81DkVb_dSLKnMwgsNYRO9FYCcRfWvQb6YCcaOO0,13406
+deeptutor/services/memory/consolidator/runs.py,sha256=6ZwHMOTxaLICXpmL-yzHUegaIHhyoLtHa3_gYAVFlyA,13135
+deeptutor/services/memory/consolidator/modes/__init__.py,sha256=SepvFsZBMM-0tesy4ViSJfh2mbOP1EkNUTj8RTcnl_g,1116
+deeptutor/services/memory/consolidator/modes/_runtime.py,sha256=_a2NWX-5qVG176HZzYT1Xi7i7WBs-JXLtnP7k0Ama20,10405
+deeptutor/services/memory/consolidator/modes/_shims.py,sha256=5T03hkkDeUAuFZgoZYX_izpswPcC88HFCVUNjSzbePg,4404
+deeptutor/services/memory/consolidator/modes/audit.py,sha256=LR3aHRvpkM0QRjiA2zn-i5truO2Jql8xQJf33bdGlY4,15328
+deeptutor/services/memory/consolidator/modes/dedup.py,sha256=d4n-qeNtCfYZuM9AnZgo-90ZQjFc5acxsnvZ1-J2yTs,6582
+deeptutor/services/memory/consolidator/modes/merge.py,sha256=Dfab0qHMQ5-55Ql4Yv0NUD20V0eygnW52j_R4DF-LZw,7748
+deeptutor/services/memory/consolidator/modes/update.py,sha256=Gxj2PUZr-Z9eeu8fSSgswpGcXA546myFgspe4mFldvU,22709
+deeptutor/services/memory/consolidator/prompts/en/_meta.yaml,sha256=tEBZbpVjeqS-iT57jgpOWNqv0fP82sEJ8keWvHi_jzs,2078
+deeptutor/services/memory/consolidator/prompts/en/audit_l2.yaml,sha256=-xsYIddIpP3nIZFl6dGipOt97Jx8VQa5RFf8a22Y94M,1697
+deeptutor/services/memory/consolidator/prompts/en/audit_l3.yaml,sha256=Q78e4hMqMEUcjHd6GqZmNhlcmIHtETc57mXP8ecdNBY,1422
+deeptutor/services/memory/consolidator/prompts/en/dedup.yaml,sha256=jZcCR7w76w52y88H8htG4PXuPys6WIewFFCdRRZGa00,1453
+deeptutor/services/memory/consolidator/prompts/en/update_l2.yaml,sha256=DQh5dEDDi3GK9a1O-ljVTWwQ5YRjqhvSN_fIBqYKUIE,1757
+deeptutor/services/memory/consolidator/prompts/en/update_l3.yaml,sha256=zlMfoFzd8_FmqpA_97LvNSvjV8peGmqAoSyqJAMc7Nc,2054
+deeptutor/services/memory/consolidator/prompts/zh/_meta.yaml,sha256=trtwobOQWGT9Gk9Kif05eDkzz_Ko7VgD9UeFHTkPj7M,1741
+deeptutor/services/memory/consolidator/prompts/zh/audit_l2.yaml,sha256=6StwN3gGwoK6x7GxNLXjlVrk7EUgmHJTXnysFgSpIBE,1518
+deeptutor/services/memory/consolidator/prompts/zh/audit_l3.yaml,sha256=m5mUur6T9laXRwFphJ72UdINaXJP3DFQ-by87_EGFGc,1180
+deeptutor/services/memory/consolidator/prompts/zh/dedup.yaml,sha256=S5bpTjSiBRjbxvhF3W7rgYgmoQ9fFFO31LKlSmtZk9U,1238
+deeptutor/services/memory/consolidator/prompts/zh/update_l2.yaml,sha256=zuf8QGEnIytO8GIe7_m4eoYTP34XSX34ENoWuEt8O30,1690
+deeptutor/services/memory/consolidator/prompts/zh/update_l3.yaml,sha256=EbM3uqvtkoSGPuI9eK74sL3XFnxiVnVX-S8gwsBuo7Y,1898
+deeptutor/services/memory/prompts/en.yaml,sha256=szrLCfDoB7__CUNCtL7qZVR06u6FLVsAZAksQSXtxIo,6074
+deeptutor/services/memory/prompts/zh.yaml,sha256=yuCToM-yGIxpT0pk2Kr-qWASLAleZjJjKD7ySqdkKwo,5741
+deeptutor/services/memory/snapshot/__init__.py,sha256=p2vI5Mba8g6p_y2QiiuZZxLIgP6L0ULsYfK4FCowcDA,4169
+deeptutor/services/memory/snapshot/adapters.py,sha256=M7BgmMOrw9-BJ95-cf90Uu7Hu2mBDpkp4hubDpdFt9M,27142
+deeptutor/services/memory/snapshot/diff.py,sha256=jQDPc-QdLROqHqwHRsw3fIEEq4KXyNWaLEjgTdE3lKQ,2152
+deeptutor/services/memory/snapshot/entity.py,sha256=F6BXWEgeG25A8rz56rmtQSfpcAF69fH6vhgqgl8ebmM,2764
+deeptutor/services/memory/snapshot/store.py,sha256=KE-qLY_qcmqdfFoesEuYazzghpAZTb4kOJ-F5Rfd6R8,3503
+deeptutor_cli/memory.py,sha256=YzGImZf-k28FmMnOAmM3I1D9oe9ScO-0IzmSTiPMxTU,3674
+deeptutor_memory-1.7.0.dist-info/METADATA,sha256=8H4Bo1wFpq1bq8y9wQlXVPG2YPBIu-FjpB3jH0uYPk8,155
+deeptutor_memory-1.7.0.dist-info/WHEEL,sha256=mOdXR9C3wMVov7cSY8PY-XCzo3SmmWCHvGQr5csJoao,91
+deeptutor_memory-1.7.0.dist-info/top_level.txt,sha256=J6ORXwc7UnijwSqfUkl8JAiAiAoZAd3pFNwq8jm5_uY,24
+deeptutor_memory-1.7.0.dist-info/RECORD,,

deeptutor_memory-1.7.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (84.2.1)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

deeptutor_memory-1.7.0.dist-info/top_level.txt

@@ -0,0 +1,2 @@
+deeptutor
+deeptutor_cli