ragfly-cli 1.19.0__tar.gz → 1.20.0__tar.gz

{ragfly_cli-1.19.0/ragfly_cli.egg-info → ragfly_cli-1.20.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ragfly-cli
-Version: 1.19.0
+Version: 1.20.0
 Summary: RAGfly CLI — operate RAGfly from the terminal and CI (login + cloud API). Lightweight, no desktop dependencies.
 Author: CAB Ltda
 License: MIT
@@ -49,24 +49,24 @@ export RAGFLY_API_KEY=rf_xxxxxxxxxx
 `cloud group` and `cloud api-key` manage a person's session and credentials: they
 need `ragfly login`, and the server refuses them for an API key.
 
-## `RAGFLY_ROOT` (optional) — open original files on disk
+## Opening an original file on disk (optional)
 
-Searching, asking and citing need zero extra config. Only if a script or agent
-on this machine must open the **original file** on disk, set `RAGFLY_ROOT` once:
-it is the **parent folder** of the folder you selected when uploading your
-documents via the web app. RAGfly never reads it nor stores your absolute
-path — documents uploaded via browser carry a *relative* `ruta_archivo`, and
-the real path is `$RAGFLY_ROOT + ruta_archivo`.
+Searching and citing need no local path setup. A document result may include an
+`fs` object. For a local relative file, read `fs.home_var` and join that
+environment variable's value with `fs.relative_path`. Each root has its own
+variable; configure only the roots available on this machine.
 
 ```bash
-# Example: you uploaded /Users/ana/Dropbox/MisDocumentos → the PARENT is the root
-echo 'export RAGFLY_ROOT="/Users/ana/Dropbox"' >> ~/.zshrc
-# "/MisDocumentos/letras/cancion.txt" → /Users/ana/Dropbox/MisDocumentos/letras/cancion.txt
+export RAGFLY_HOME_442681="/Users/ana/Dropbox"
+export RAGFLY_HOME_991203="/Volumes/Archive"
 ```
 
-Not needed for documents loaded via RAGfly Desktop (their paths are already
-absolute). Step-by-step walkthrough:
-<https://ragfly.ai/build/mcp#setting-up-ragfly_root--once-per-machine-in-3-steps>
+If `fs.is_cloud_only` is true, use the authorized cloud provider. If
+`fs.is_public_url` is true, open its public URL. If `fs.is_absolute` is true,
+use the absolute path on the machine where it exists. If `fs.home_var` is null
+or unset, do not guess a local root. See the
+[MCP guide](https://ragfly.ai/build/mcp#opening-a-document-on-disk-fs-block)
+for the full order and examples.
 
 ## Command surface
 
@@ -78,10 +78,12 @@ ragfly
     ├── group          list | switch | clear      (signed-in person)
     ├── api-key        create | list | revoke     (signed-in person)
     ├── document       list | show | edges
-    ├── space          list | show
+    ├── space          list | show | compose | read | refresh | promote
     ├── queue          show | runs
     ├── skill          list | show | run
     ├── catalog
+    ├── document-type  list
+    ├── characteristic list
     ├── function       show
     ├── search
     ├── chat           ask
@@ -112,6 +114,8 @@ Output is English end to end (`--status VECTORIZED`, `-o json | jq`).
 ragfly cloud document list --status VECTORIZED --limit 20 -o id
 ragfly cloud skill run SUMMARIZE_DOCUMENT --space 12
 ragfly cloud search "Q1 revenue"
+ragfly cloud search "statements" --filter @filter.json --space 12
+ragfly cloud chat ask "How do I release the entity of my key?" --mode help
 ```
 
 Full reference: <https://api.ragfly.ai/docs>.

{ragfly_cli-1.19.0 → ragfly_cli-1.20.0}/README.md

@@ -29,24 +29,24 @@ export RAGFLY_API_KEY=rf_xxxxxxxxxx
 `cloud group` and `cloud api-key` manage a person's session and credentials: they
 need `ragfly login`, and the server refuses them for an API key.
 
-## `RAGFLY_ROOT` (optional) — open original files on disk
+## Opening an original file on disk (optional)
 
-Searching, asking and citing need zero extra config. Only if a script or agent
-on this machine must open the **original file** on disk, set `RAGFLY_ROOT` once:
-it is the **parent folder** of the folder you selected when uploading your
-documents via the web app. RAGfly never reads it nor stores your absolute
-path — documents uploaded via browser carry a *relative* `ruta_archivo`, and
-the real path is `$RAGFLY_ROOT + ruta_archivo`.
+Searching and citing need no local path setup. A document result may include an
+`fs` object. For a local relative file, read `fs.home_var` and join that
+environment variable's value with `fs.relative_path`. Each root has its own
+variable; configure only the roots available on this machine.
 
 ```bash
-# Example: you uploaded /Users/ana/Dropbox/MisDocumentos → the PARENT is the root
-echo 'export RAGFLY_ROOT="/Users/ana/Dropbox"' >> ~/.zshrc
-# "/MisDocumentos/letras/cancion.txt" → /Users/ana/Dropbox/MisDocumentos/letras/cancion.txt
+export RAGFLY_HOME_442681="/Users/ana/Dropbox"
+export RAGFLY_HOME_991203="/Volumes/Archive"
 ```
 
-Not needed for documents loaded via RAGfly Desktop (their paths are already
-absolute). Step-by-step walkthrough:
-<https://ragfly.ai/build/mcp#setting-up-ragfly_root--once-per-machine-in-3-steps>
+If `fs.is_cloud_only` is true, use the authorized cloud provider. If
+`fs.is_public_url` is true, open its public URL. If `fs.is_absolute` is true,
+use the absolute path on the machine where it exists. If `fs.home_var` is null
+or unset, do not guess a local root. See the
+[MCP guide](https://ragfly.ai/build/mcp#opening-a-document-on-disk-fs-block)
+for the full order and examples.
 
 ## Command surface
 
@@ -58,10 +58,12 @@ ragfly
     ├── group          list | switch | clear      (signed-in person)
     ├── api-key        create | list | revoke     (signed-in person)
     ├── document       list | show | edges
-    ├── space          list | show
+    ├── space          list | show | compose | read | refresh | promote
     ├── queue          show | runs
     ├── skill          list | show | run
     ├── catalog
+    ├── document-type  list
+    ├── characteristic list
     ├── function       show
     ├── search
     ├── chat           ask
@@ -92,6 +94,8 @@ Output is English end to end (`--status VECTORIZED`, `-o json | jq`).
 ragfly cloud document list --status VECTORIZED --limit 20 -o id
 ragfly cloud skill run SUMMARIZE_DOCUMENT --space 12
 ragfly cloud search "Q1 revenue"
+ragfly cloud search "statements" --filter @filter.json --space 12
+ragfly cloud chat ask "How do I release the entity of my key?" --mode help
 ```
 
 Full reference: <https://api.ragfly.ai/docs>.

{ragfly_cli-1.19.0 → ragfly_cli-1.20.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "ragfly-cli"
-version = "1.19.0"
+version = "1.20.0"
 description = "RAGfly CLI — operate RAGfly from the terminal and CI (login + cloud API). Lightweight, no desktop dependencies."
 readme = "README.md"
 requires-python = ">=3.10"

ragfly_cli-1.20.0/ragfly_cli/__init__.py

@@ -0,0 +1 @@
+__version__ = "1.20.0"

{ragfly_cli-1.19.0 → ragfly_cli-1.20.0}/ragfly_cli/_http.py

@@ -41,9 +41,8 @@ def default_headers(
     Returns:
         dict de headers listo para pasar a httpx.
 
-    El header `X-Override-Grupo` se envía cuando hay grupo activo configurado
-    o explícito. El backend lo respeta como override de sesión (mismo patrón
-    que el dropdown de grupo del frontend web).
+    El header `X-Override-Grupo` solo se envía para una sesión humana. Una API
+    key tiene un grupo fijo en el servidor y nunca hereda el grupo local del CLI.
     """
     from ragfly_cli import __version__ as _client_version
 
@@ -53,14 +52,17 @@ def default_headers(
     if content_type:
         headers["Content-Type"] = "application/json"
 
-    # Resolver grupo activo: explícito > config
-    grupo = grupo_override
-    if grupo is None:
-        try:
-            from .config import get_config
-            grupo = get_config().codigo_grupo or None
-        except Exception:
-            grupo = None
+    # El override pertenece a la sesión humana. Enviar el grupo guardado en
+    # otra sesión con una API key puede dar 403 y nunca debe cambiar su alcance.
+    grupo = None
+    if not (token and token.startswith(("rf_", "slm_live_"))):
+        grupo = grupo_override
+        if grupo is None:
+            try:
+                from .config import get_config
+                grupo = get_config().codigo_grupo or None
+            except Exception:
+                grupo = None
     if grupo:
         headers["X-Override-Grupo"] = grupo
 

{ragfly_cli-1.19.0 → ragfly_cli-1.20.0}/ragfly_cli/cli.py

@@ -236,6 +236,32 @@ def cloud_me(output: str):
             ("Active group", "group"), ("Active entity", "entity")])
 
 
+# ── cloud entity ────────────────────────────────────────────────────────────
+
+@cloud.group("entity")
+def cloud_entity():
+    """Active entity focus for the authenticated credential."""
+
+
+@cloud_entity.command("set")
+@click.argument("entity_code", required=False)
+@click.option("--release", is_flag=True, help="Release the focus and use all authorized entities.")
+@click.option("-o", "--output", type=OUTPUT_TABLE, default="table")
+def cloud_entity_set(entity_code: str | None, release: bool, output: str):
+    """Set ENTITY_CODE as active, or use --release to clear the focus."""
+    if release == (entity_code is not None):
+        raise click.UsageError("Pass exactly one of ENTITY_CODE or --release.")
+    data = _v1(
+        "POST", "/v1/session/active-entity",
+        body={"entity_code": None if release else entity_code},
+    )
+    if output == "json":
+        _emit_json(data)
+        return
+    active = data.get("active_entity") or "all authorized entities"
+    console.print(f"[green]✓ Active entity:[/green] [bold]{active}[/bold]")
+
+
 # ── cloud group (signed-in person only) ──────────────────────────────────────
 
 @cloud.group("group")
@@ -413,6 +439,48 @@ def cloud_space_show(space_id: int, document_limit: int, output: str):
     _table("Documents", data.get("documents") or [], [("Code", "code"), ("Name", "name"), ("Status", "status")])
 
 
+@cloud_space.command("compose")
+@click.argument("operation", type=click.Choice(["union", "intersection", "difference", "symmetric_difference"]))
+@click.argument("space_a", type=int)
+@click.argument("space_b", type=int)
+@click.option("--name", default="", help="Name of the result (generated when empty)")
+@click.option("--type", "space_type", type=click.Choice(["AREA", "SPACE"]), default="AREA", show_default=True)
+@click.option("-o", "--output", type=OUTPUT_TABLE, default="json")
+def cloud_space_compose(operation: str, space_a: int, space_b: int, name: str, space_type: str, output: str):
+    """Combine two working spaces by set algebra into a new one."""
+    data = _v1("POST", "/v1/spaces/compose", body={
+        "operation": operation, "space_id_a": space_a, "space_id_b": space_b,
+        "name": name, "space_type": space_type,
+    })
+    _emit_json(data) if output == "json" else _fields("New working space", data, [
+        ("ID", "space_id"), ("Name", "name"), ("Type", "type"), ("Documents", "total_documents")])
+
+
+@cloud_space.command("read")
+@click.argument("space_id", type=int)
+@click.option("--resolution", type=click.Choice(["count", "manifest", "chunks", "text"]), default="manifest", show_default=True)
+@click.option("--query", default="", help="Sub-question to rank by (required with --resolution chunks)")
+@click.option("--limit", type=int, default=50, show_default=True)
+def cloud_space_read(space_id: int, resolution: str, query: str, limit: int):
+    """Read a working space at the chosen resolution (JSON output)."""
+    _emit_json(_v1("POST", f"/v1/spaces/{space_id}/read",
+                   body={"resolution": resolution, "query": query, "limit": limit}))
+
+
+@cloud_space.command("refresh")
+@click.argument("space_id", type=int)
+def cloud_space_refresh(space_id: int):
+    """Recompute the members of a working space (JSON output)."""
+    _emit_json(_v1("POST", f"/v1/spaces/{space_id}/refresh"))
+
+
+@cloud_space.command("promote")
+@click.argument("space_id", type=int)
+def cloud_space_promote(space_id: int):
+    """Turn a temporary working space into a permanent one (JSON output)."""
+    _emit_json(_v1("POST", f"/v1/spaces/{space_id}/promote"))
+
+
 # ── cloud queue ──────────────────────────────────────────────────────────────
 
 @cloud.group("queue")
@@ -508,6 +576,38 @@ def cloud_catalog(type_: str, output: str):
         _table("Skills", data["skills"], [("Code", "code"), ("Name", "name"), ("Applies to", "applies_to")])
 
 
+@cloud.group("document-type")
+def cloud_document_type():
+    """Document types of an entity: the codes `search --filter` accepts."""
+
+
+@cloud_document_type.command("list")
+@click.option("--entity", default=None, help="Entity code (defaults to the active entity)")
+@click.option("-o", "--output", type=OUTPUT_LIST, default="table")
+def cloud_document_type_list(entity: str | None, output: str):
+    """List the document types of the entity, with their parent type."""
+    data = _v1("GET", "/v1/catalog/document-types", params={"entity_code": entity})
+    _list(data, output, key="document_types", id_key="code", title="Document types",
+          columns=[("Code", "code"), ("Name", "name"), ("Parent", "parent_code"), ("Documents", "document_count")])
+
+
+@cloud.group("characteristic")
+def cloud_characteristic():
+    """Content characteristics of the document types: the codes `search --filter` accepts."""
+
+
+@cloud_characteristic.command("list")
+@click.option("--document-type", "document_types", multiple=True, help="Document type code (repeat for several)")
+@click.option("--entity", default=None, help="Entity code (defaults to the active entity)")
+@click.option("-o", "--output", type=OUTPUT_LIST, default="table")
+def cloud_characteristic_list(document_types: tuple[str, ...], entity: str | None, output: str):
+    """List the characteristics available for those types (all when none is given)."""
+    data = _v1("GET", "/v1/catalog/characteristics", params={
+        "document_types": ",".join(document_types) or None, "entity_code": entity})
+    _list(data, output, key="characteristics", id_key="code", title="Characteristics",
+          columns=[("Category", "category_code"), ("Code", "code"), ("Name", "name"), ("Role", "role")])
+
+
 @cloud.group("function")
 def cloud_function():
     """Functions (screens) of the RAGfly application."""
@@ -531,8 +631,12 @@ def cloud_function_show(function_code: str, output: str):
 @click.option("--limit", type=int, default=10, show_default=True)
 @click.option("--min-similarity", type=float, default=0.0, show_default=True)
 @click.option("--entity", default=None, help="Filter by entity code")
+@click.option("--space", "space_id", type=int, default=None, help="Search only inside this working space")
+@click.option("--filter", "filter_json", default=None,
+              help="Structured filter as JSON, @file or - (document_types, attributes, characteristics)")
 @click.option("-o", "--output", type=OUTPUT_TABLE, default="table")
-def cloud_search(query: tuple[str, ...], limit: int, min_similarity: float, entity: str | None, output: str):
+def cloud_search(query: tuple[str, ...], limit: int, min_similarity: float, entity: str | None,
+                 space_id: int | None, filter_json: str | None, output: str):
     """Semantic search over the group's vectorized documents."""
     text = " ".join(query).strip()
     if not text:
@@ -540,6 +644,10 @@ def cloud_search(query: tuple[str, ...], limit: int, min_similarity: float, enti
     body = {"query": text, "limit": limit, "min_similarity": min_similarity}
     if entity:
         body["entity_code"] = entity
+    if space_id is not None:
+        body["space_id"] = space_id
+    if filter_json:
+        body["filter"] = _json_argument(filter_json, "--filter")
     data = _v1("POST", "/v1/documents/search", body=body)
     if output == "json":
         _emit_json(data)
@@ -561,8 +669,10 @@ def cloud_chat():
 @click.argument("message", nargs=-1, required=True)
 @click.option("--function", "function_code", default="CHAT-USER", show_default=True, help="Chat function code")
 @click.option("--conversation", "conversation_id", type=int, default=None, help="Continue an existing conversation")
+@click.option("--mode", type=click.Choice(["default", "help"]), default=None,
+              help="help: answer questions about RAGfly itself (how to use or integrate it), without links to web screens")
 @click.option("-o", "--output", type=click.Choice(["text", "json"]), default="text")
-def cloud_chat_ask(message: tuple[str, ...], function_code: str, conversation_id: int | None, output: str):
+def cloud_chat_ask(message: tuple[str, ...], function_code: str, conversation_id: int | None, mode: str | None, output: str):
     """Ask a question. Creates a conversation unless --conversation is given."""
     question = " ".join(message).strip()
     if not question:
@@ -570,6 +680,8 @@ def cloud_chat_ask(message: tuple[str, ...], function_code: str, conversation_id
     body = {"question": question, "function_code": function_code}
     if conversation_id:
         body["conversation_id"] = conversation_id
+    if mode:
+        body["mode"] = mode
     data = _v1("POST", "/v1/ask", body=body)
     if output == "json":
         _emit_json(data)

{ragfly_cli-1.19.0 → ragfly_cli-1.20.0}/ragfly_cli/grupo_activo.py

@@ -49,7 +49,7 @@ def set_grupo_activo(codigo_grupo: str) -> None:
     path = _config_path()
     if not path.exists():
         raise FileNotFoundError(
-            f"No existe {path}. Ejecuta `ragfly setup` primero."
+            f"{path} does not exist. Run `ragfly setup` first."
         )
 
     content = path.read_text()

{ragfly_cli-1.19.0 → ragfly_cli-1.20.0}/ragfly_cli/oop/cli_command.py

@@ -74,10 +74,10 @@ class CliCommand:
         except SystemExit:
             raise
         except KeyboardInterrupt:
-            self.aviso("Interrumpido.")
+            self.aviso("Interrupted.")
             raise SystemExit(130)
         except Exception as e:
-            self.error(f"Error inesperado: {e}")
+            self.error(f"Unexpected error: {e}")
             raise SystemExit(on_unexpected_exit_code)
 
     def salir(self, mensaje: str, exit_code: int = 1) -> NoReturn:

{ragfly_cli-1.19.0 → ragfly_cli-1.20.0}/ragfly_cli/oop/http_client.py

@@ -9,7 +9,7 @@ Encapsula el patrón repetido en `cloud_commands.py`:
     except httpx.HTTPStatusError as e:
         _manejar_http_error(e)
     except httpx.RequestError as e:
-        raise CloudError(f"Error de conexión: {e}", exit_code=2)
+        raise CloudError(f"Could not connect to the server: {e}", exit_code=2)
 
 Ejemplo:
     from ragfly_cli.oop import CloudHttpClient
@@ -99,7 +99,7 @@ class CloudHttpClient:
         except httpx.HTTPStatusError as e:
             _manejar_http_error(e)
         except httpx.RequestError as e:
-            raise CloudError(f"Error de conexión: {e}", exit_code=2)
+            raise CloudError(f"Could not connect to the server: {e}", exit_code=2)
 
     # ── Verbos HTTP ───────────────────────────────────────────────────────────
 

{ragfly_cli-1.19.0 → ragfly_cli-1.20.0}/ragfly_cli/version_check.py

@@ -88,9 +88,9 @@ def chequear_actualizacion(
 
     obligatoria = data.get("obligatoria", False)
     notas = data.get("notas") or ""
-    prefix = "⚠️  ACTUALIZACIÓN OBLIGATORIA" if obligatoria else "ℹ️  Hay una nueva versión disponible"
+    prefix = "⚠️  MANDATORY UPDATE" if obligatoria else "ℹ️  A new version is available"
 
-    msg = f"{prefix}: RAGfly Desktop v{latest} (tu versión: v{__version__})"
+    msg = f"{prefix}: RAGfly Desktop v{latest} (your version: v{__version__})"
     if notas:
         msg += f"\n   {notas}"
     return msg

{ragfly_cli-1.19.0 → ragfly_cli-1.20.0/ragfly_cli.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ragfly-cli
-Version: 1.19.0
+Version: 1.20.0
 Summary: RAGfly CLI — operate RAGfly from the terminal and CI (login + cloud API). Lightweight, no desktop dependencies.
 Author: CAB Ltda
 License: MIT
@@ -49,24 +49,24 @@ export RAGFLY_API_KEY=rf_xxxxxxxxxx
 `cloud group` and `cloud api-key` manage a person's session and credentials: they
 need `ragfly login`, and the server refuses them for an API key.
 
-## `RAGFLY_ROOT` (optional) — open original files on disk
+## Opening an original file on disk (optional)
 
-Searching, asking and citing need zero extra config. Only if a script or agent
-on this machine must open the **original file** on disk, set `RAGFLY_ROOT` once:
-it is the **parent folder** of the folder you selected when uploading your
-documents via the web app. RAGfly never reads it nor stores your absolute
-path — documents uploaded via browser carry a *relative* `ruta_archivo`, and
-the real path is `$RAGFLY_ROOT + ruta_archivo`.
+Searching and citing need no local path setup. A document result may include an
+`fs` object. For a local relative file, read `fs.home_var` and join that
+environment variable's value with `fs.relative_path`. Each root has its own
+variable; configure only the roots available on this machine.
 
 ```bash
-# Example: you uploaded /Users/ana/Dropbox/MisDocumentos → the PARENT is the root
-echo 'export RAGFLY_ROOT="/Users/ana/Dropbox"' >> ~/.zshrc
-# "/MisDocumentos/letras/cancion.txt" → /Users/ana/Dropbox/MisDocumentos/letras/cancion.txt
+export RAGFLY_HOME_442681="/Users/ana/Dropbox"
+export RAGFLY_HOME_991203="/Volumes/Archive"
 ```
 
-Not needed for documents loaded via RAGfly Desktop (their paths are already
-absolute). Step-by-step walkthrough:
-<https://ragfly.ai/build/mcp#setting-up-ragfly_root--once-per-machine-in-3-steps>
+If `fs.is_cloud_only` is true, use the authorized cloud provider. If
+`fs.is_public_url` is true, open its public URL. If `fs.is_absolute` is true,
+use the absolute path on the machine where it exists. If `fs.home_var` is null
+or unset, do not guess a local root. See the
+[MCP guide](https://ragfly.ai/build/mcp#opening-a-document-on-disk-fs-block)
+for the full order and examples.
 
 ## Command surface
 
@@ -78,10 +78,12 @@ ragfly
     ├── group          list | switch | clear      (signed-in person)
     ├── api-key        create | list | revoke     (signed-in person)
     ├── document       list | show | edges
-    ├── space          list | show
+    ├── space          list | show | compose | read | refresh | promote
     ├── queue          show | runs
     ├── skill          list | show | run
     ├── catalog
+    ├── document-type  list
+    ├── characteristic list
     ├── function       show
     ├── search
     ├── chat           ask
@@ -112,6 +114,8 @@ Output is English end to end (`--status VECTORIZED`, `-o json | jq`).
 ragfly cloud document list --status VECTORIZED --limit 20 -o id
 ragfly cloud skill run SUMMARIZE_DOCUMENT --space 12
 ragfly cloud search "Q1 revenue"
+ragfly cloud search "statements" --filter @filter.json --space 12
+ragfly cloud chat ask "How do I release the entity of my key?" --mode help
 ```
 
 Full reference: <https://api.ragfly.ai/docs>.

{ragfly_cli-1.19.0 → ragfly_cli-1.20.0}/ragfly_cli.egg-info/SOURCES.txt

@@ -20,4 +20,6 @@ ragfly_cli.egg-info/top_level.txt
 ragfly_cli/oop/__init__.py
 ragfly_cli/oop/cli_command.py
 ragfly_cli/oop/http_client.py
-tests/test_agent_context_cli.py
+tests/test_agent_context_cli.py
+tests/test_api_key_group_override.py
+tests/test_surface_parity_cli.py

{ragfly_cli-1.19.0 → ragfly_cli-1.20.0}/tests/test_agent_context_cli.py

@@ -47,6 +47,19 @@ def test_every_cloud_call_goes_to_v1_with_the_cli_surface(wire):
     assert call["headers"]["X-RAGfly-Client"] == "cli"
 
 
+def test_entity_set_and_release_use_the_single_public_session_operation(wire):
+    wire.reply = httpx.Response(200, json={"active_entity": "E1"})
+    result = run("cloud", "entity", "set", "E1", "-o", "json")
+    assert result.exit_code == 0, result.output
+    assert wire.calls[0]["url"].endswith("/v1/session/active-entity")
+    assert wire.calls[0]["json"] == {"entity_code": "E1"}
+
+    wire.reply = httpx.Response(200, json={"active_entity": None})
+    result = run("cloud", "entity", "set", "--release", "-o", "json")
+    assert result.exit_code == 0, result.output
+    assert wire.calls[1]["json"] == {"entity_code": None}
+
+
 def test_agent_context_and_tool(wire):
     wire.reply = httpx.Response(200, json={"function_profile": "support_chat", "system_prompt_hash": "abc", "tools": []})
     result = run("cloud", "agent", "context", "--profile", "support_chat")

ragfly_cli-1.20.0/tests/test_api_key_group_override.py

@@ -0,0 +1,18 @@
+from types import SimpleNamespace
+
+from ragfly_cli import config
+from ragfly_cli._http import default_headers
+
+
+def test_api_key_never_inherits_a_saved_group(monkeypatch):
+    monkeypatch.setattr(config, "get_config", lambda: SimpleNamespace(codigo_grupo="OTHER-GROUP"))
+    for token in ("rf_fixture", "slm_live_fixture"):
+        headers = default_headers(token=token)
+        assert headers["Authorization"] == f"Bearer {token}"
+        assert "X-Override-Grupo" not in headers
+
+
+def test_human_session_keeps_its_saved_group(monkeypatch):
+    monkeypatch.setattr(config, "get_config", lambda: SimpleNamespace(codigo_grupo="MY-GROUP"))
+    headers = default_headers(token="jwt.header.signature")
+    assert headers["X-Override-Grupo"] == "MY-GROUP"

ragfly_cli-1.20.0/tests/test_surface_parity_cli.py

@@ -0,0 +1,75 @@
+"""The CLI exposes the same /v1 operations as the SDKs and MCP: ask mode, filtered search, catalogs, spaces."""
+import json
+
+import httpx
+import pytest
+from click.testing import CliRunner
+
+from ragfly_cli.cli import app
+
+
+@pytest.fixture
+def wire(monkeypatch):
+    monkeypatch.setenv("RAGFLY_API_KEY", "rf_test")
+    monkeypatch.delenv("RAGFLY_TOKEN", raising=False)
+    monkeypatch.setattr("ragfly_cli.config.get_config", lambda: type("C", (), {"codigo_grupo": ""})())
+
+    class Wire:
+        reply = httpx.Response(200, json={})
+        calls: list = []
+
+    def fake_request(method, url, **kwargs):
+        Wire.calls.append({"method": method, "url": url, **kwargs})
+        response = Wire.reply
+        response.request = httpx.Request(method, url)
+        return response
+
+    monkeypatch.setattr(httpx, "request", fake_request)
+    Wire.calls = []
+    return Wire
+
+
+def run(*args):
+    return CliRunner().invoke(app, list(args))
+
+
+def test_ask_sends_mode_only_when_given(wire):
+    wire.reply = httpx.Response(200, json={"answer": "A", "conversation_id": 1})
+    assert run("cloud", "chat", "ask", "how do I release the entity?", "--mode", "help").exit_code == 0
+    assert wire.calls[0]["json"] == {"question": "how do I release the entity?", "function_code": "CHAT-USER", "mode": "help"}
+    assert run("cloud", "chat", "ask", "hello").exit_code == 0
+    assert "mode" not in wire.calls[1]["json"]
+    assert run("cloud", "chat", "ask", "hello", "--mode", "support").exit_code != 0
+
+
+def test_search_takes_space_and_structured_filter(wire):
+    wire.reply = httpx.Response(200, json={"documents": []})
+    flt = {"document_types": ["TDOC_cartola"], "attributes": [{"field": "language", "operator": "EQ", "value": "es"}]}
+    result = run("cloud", "search", "cartolas", "--space", "12", "--filter", json.dumps(flt), "-o", "json")
+    assert result.exit_code == 0, result.output
+    body = wire.calls[0]["json"]
+    assert wire.calls[0]["url"].endswith("/v1/documents/search")
+    assert body["query"] == "cartolas" and body["space_id"] == 12 and body["filter"] == flt
+    assert run("cloud", "search", "x", "--filter", "[1]").exit_code != 0  # a filter is a JSON object
+
+
+def test_catalog_commands_call_the_public_catalog_routes(wire):
+    wire.reply = httpx.Response(200, json={"document_types": [{"code": "T1", "name": "Statement", "parent_code": None, "document_count": 3}]})
+    assert run("cloud", "document-type", "list", "--entity", "E1", "-o", "id").output.strip() == "T1"
+    assert wire.calls[0]["url"].endswith("/v1/catalog/document-types") and wire.calls[0]["params"] == {"entity_code": "E1"}
+    wire.reply = httpx.Response(200, json={"characteristics": []})
+    assert run("cloud", "characteristic", "list", "--document-type", "T1", "--document-type", "T2", "-o", "json").exit_code == 0
+    assert wire.calls[1]["url"].endswith("/v1/catalog/characteristics")
+    assert wire.calls[1]["params"] == {"document_types": "T1,T2"}
+
+
+def test_space_commands_cover_compose_read_refresh_and_promote(wire):
+    wire.reply = httpx.Response(200, json={"space_id": 9})
+    assert run("cloud", "space", "compose", "difference", "1", "2", "--name", "N", "--type", "SPACE").exit_code == 0
+    assert wire.calls[0]["url"].endswith("/v1/spaces/compose")
+    assert wire.calls[0]["json"] == {"operation": "difference", "space_id_a": 1, "space_id_b": 2, "name": "N", "space_type": "SPACE"}
+    assert run("cloud", "space", "read", "9", "--resolution", "chunks", "--query", "q", "--limit", "5").exit_code == 0
+    assert wire.calls[1]["url"].endswith("/v1/spaces/9/read")
+    assert wire.calls[1]["json"] == {"resolution": "chunks", "query": "q", "limit": 5}
+    assert run("cloud", "space", "refresh", "9").exit_code == 0 and wire.calls[2]["url"].endswith("/v1/spaces/9/refresh")
+    assert run("cloud", "space", "promote", "9").exit_code == 0 and wire.calls[3]["url"].endswith("/v1/spaces/9/promote")

ragfly_cli-1.19.0/ragfly_cli/__init__.py

@@ -1 +0,0 @@
-__version__ = "1.19.0"