cortexdb-cli 0.3.0__tar.gz → 0.4.0__tar.gz

{cortexdb_cli-0.3.0 → cortexdb_cli-0.4.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: cortexdb-cli
-Version: 0.3.0
+Version: 0.4.0
 Summary: Command-line interface for CortexDB — the long-term memory layer for AI.
 Project-URL: Homepage, https://cortexdb.ai
 Project-URL: Documentation, https://cortexdb.ai/docs

{cortexdb_cli-0.3.0 → cortexdb_cli-0.4.0}/cortexdb_cli/__init__.py

@@ -1,3 +1,3 @@
 """CortexDB CLI — command-line interface for the v1 memory API."""
 
-__version__ = "0.3.0"
+__version__ = "0.4.0"

{cortexdb_cli-0.3.0 → cortexdb_cli-0.4.0}/cortexdb_cli/commands/recall.py

@@ -1,99 +1,121 @@
-"""cortexdb recall — POST /v1/recall."""
-
-from __future__ import annotations
-
-from typing import Any
-
-import click
-
-from cortexdb_cli.client import get_client
-from cortexdb_cli.errors import handle_errors
-from cortexdb_cli.output import is_json_mode, print_recall, spinner
-
-
-@click.command("recall")
-@click.argument("query")
-@click.option("--scope", "-S", help="Scope path (defaults to your default scope)")
-@click.option(
-    "--view",
-    type=click.Choice(["raw", "granular", "structured", "holistic", "descend"]),
-    default=None,
-    help="Pack shape. Defaults to your configured view (CORTEXDB_VIEW env or "
-    "`cortexdb config set view ...`), else 'holistic'. 'descend' = the scope + all "
-    "child scopes; 'holistic' = the scope + its parents; 'granular' = exact scope only.",
-)
-@click.option(
-    "--include",
-    multiple=True,
-    type=click.Choice(["events", "episodes", "facts", "beliefs", "understanding"]),
-    help="Layers to fill (repeatable). Default: facts + beliefs + episodes.",
-)
-@click.option(
-    "--temporal",
-    default=None,
-    help='Natural-language time window, e.g. "last 30 days".',
-)
-@click.option(
-    "--max-tokens",
-    type=int,
-    default=None,
-    help="Budget for the returned context_block (string).",
-)
-@click.option(
-    "--diagnostics",
-    type=click.Choice(["none", "summary", "full"]),
-    default="none",
-    show_default=True,
-    help='"none" works on every tier. "summary"/"full" need the diagnostics.read capability.',
-)
-@click.pass_context
-@handle_errors
-def recall_cmd(
-    ctx: click.Context,
-    query: str,
-    scope: str | None,
-    view: str,
-    include: tuple[str, ...],
-    temporal: str | None,
-    max_tokens: int | None,
-    diagnostics: str,
-) -> None:
-    """Recall context from memory.
-
-    \b
-        cortexdb recall "what did we decide about Acme?"
-        cortexdb recall "renewal status" --temporal "last 30 days"
-    """
-    cfg = ctx.obj
-    view = view or cfg.get("view") or "holistic"
-    if view not in ("raw", "granular", "structured", "holistic", "descend"):
-        raise click.UsageError(
-            f"Invalid view {view!r}. Choose: raw, granular, structured, holistic, descend."
-        )
-    target_scope = scope or cfg.get("scope") or cfg.get("actor")
-    if not target_scope:
-        raise click.UsageError(
-            "No scope configured. Run `cortexdb init` first, or pass --scope explicitly."
-        )
-
-    body: dict[str, Any] = {
-        "scope": target_scope,
-        "view": view,
-        "query": query,
-        "diagnostics": diagnostics,
-    }
-    if include:
-        body["include"] = list(include)
-    if temporal:
-        body["temporal"] = {"natural": temporal}
-    if max_tokens is not None:
-        body["budgets"] = {"max_tokens": max_tokens}
-
-    with get_client(cfg) as client:
-        if not is_json_mode(cfg):
-            with spinner("Recalling..."):
-                resp = client.post("/v1/recall", json=body)
-        else:
-            resp = client.post("/v1/recall", json=body)
-        resp.raise_for_status()
-        print_recall(resp.json(), cfg)
+"""cortexdb recall — POST /v1/recall."""
+
+from __future__ import annotations
+
+from typing import Any
+
+import click
+
+from cortexdb_cli.client import get_client
+from cortexdb_cli.errors import handle_errors
+from cortexdb_cli.output import is_json_mode, print_recall, spinner
+
+
+@click.command("recall")
+@click.argument("query")
+@click.option("--scope", "-S", help="Scope path (defaults to your default scope)")
+@click.option(
+    "--view",
+    type=click.Choice(["raw", "granular", "structured", "holistic", "descend"]),
+    default=None,
+    help="Pack shape. Defaults to your configured view (CORTEXDB_VIEW env or "
+    "`cortexdb config set view ...`), else 'holistic'. 'descend' = the scope + all "
+    "child scopes; 'holistic' = the scope + its parents; 'granular' = exact scope only.",
+)
+@click.option(
+    "--include",
+    multiple=True,
+    type=click.Choice(["events", "episodes", "facts", "beliefs", "understanding"]),
+    help="Layers to fill (repeatable). Default: facts + beliefs + episodes.",
+)
+@click.option(
+    "--temporal",
+    default=None,
+    help='Natural-language time window, e.g. "last 30 days".',
+)
+@click.option(
+    "--max-tokens",
+    type=int,
+    default=None,
+    help="Budget for the returned context_block (string).",
+)
+@click.option(
+    "--diagnostics",
+    type=click.Choice(["none", "summary", "full"]),
+    default="none",
+    show_default=True,
+    help='"none" works on every tier. "summary"/"full" need the diagnostics.read capability.',
+)
+@click.option(
+    "--filter",
+    "filters",
+    multiple=True,
+    metavar="KEY=VALUE",
+    help="Hard attribute filter, repeatable (AND across keys, any-of when a "
+    "key repeats). Keys: labels, intent, modality, caller, observed_actor. "
+    "Example: --filter labels=primary_inbox",
+)
+@click.pass_context
+@handle_errors
+def recall_cmd(
+    ctx: click.Context,
+    query: str,
+    scope: str | None,
+    view: str,
+    include: tuple[str, ...],
+    temporal: str | None,
+    max_tokens: int | None,
+    diagnostics: str,
+    filters: tuple[str, ...],
+) -> None:
+    """Recall context from memory.
+
+    \b
+        cortexdb recall "what did we decide about Acme?"
+        cortexdb recall "renewal status" --temporal "last 30 days"
+    """
+    cfg = ctx.obj
+    view = view or cfg.get("view") or "holistic"
+    if view not in ("raw", "granular", "structured", "holistic", "descend"):
+        raise click.UsageError(
+            f"Invalid view {view!r}. Choose: raw, granular, structured, holistic, descend."
+        )
+    target_scope = scope or cfg.get("scope") or cfg.get("actor")
+    if not target_scope:
+        raise click.UsageError(
+            "No scope configured. Run `cortexdb init` first, or pass --scope explicitly."
+        )
+
+    body: dict[str, Any] = {
+        "scope": target_scope,
+        "view": view,
+        "query": query,
+        "diagnostics": diagnostics,
+    }
+    if include:
+        body["include"] = list(include)
+    if temporal:
+        body["temporal"] = {"natural": temporal}
+    if max_tokens is not None:
+        body["budgets"] = {"max_tokens": max_tokens}
+    if filters:
+        fmap: dict[str, Any] = {}
+        for f in filters:
+            if "=" not in f:
+                raise click.UsageError(f"--filter must be KEY=VALUE, got {f!r}")
+            k, v = f.split("=", 1)
+            if k in fmap:
+                prev = fmap[k] if isinstance(fmap[k], list) else [fmap[k]]
+                fmap[k] = prev + [v]
+            else:
+                fmap[k] = v
+        body["filters"] = {"metadata": fmap}
+
+    with get_client(cfg) as client:
+        if not is_json_mode(cfg):
+            with spinner("Recalling..."):
+                resp = client.post("/v1/recall", json=body)
+        else:
+            resp = client.post("/v1/recall", json=body)
+        resp.raise_for_status()
+        print_recall(resp.json(), cfg)

{cortexdb_cli-0.3.0 → cortexdb_cli-0.4.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "cortexdb-cli"
-version = "0.3.0"
+version = "0.4.0"
 description = "Command-line interface for CortexDB — the long-term memory layer for AI."
 readme = "README.md"
 license = "Apache-2.0"