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

{astromesh_cli-0.3.0 → astromesh_cli-0.4.0}/.gitignore

@@ -43,3 +43,12 @@ docs-site/.astro/
 # SDD scratch
 .superpowers/
 config/connections.yaml
+
+# Worktrees de sesiones de Claude Code. Son repos git EMBEBIDOS: un `git add -A`
+# se los lleva adentro de un commit, y ya pasó — en astromesh-herald entró uno
+# dentro de un commit de release. Se ignora SÓLO `worktrees/`: este repo SÍ
+# versiona `.claude/skills/` y sus comandos, y un ignore amplio se los llevaría.
+.claude/worktrees/
+
+# macOS
+.DS_Store

astromesh_cli-0.4.0/CHANGELOG.md

@@ -0,0 +1,46 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+
+## [0.4.0] - 2026-10-16
+
+### Added
+- `astromeshctl eval <config_dir> [archivos...] [--out reporte.json]`: corre los `kind: Eval` con
+  el runner del core (`astromesh.evals`, el mismo de `astromesh-eval`). Exit 0 si todos cumplen,
+  1 si alguno queda bajo umbral, 2 por error de carga (un eval inválido no corre ningún caso).
+- `run` muestra un panel **BLOCKED by guardrail** con dirección, regla y motivo cuando el core
+  0.70 bloquea la corrida (que vuelve HTTP 200 con el rechazo como `answer`), y una tabla con las
+  `propuestas` de las tools `mode: propose`. La tabla por modelo suma la columna `Cached`
+  (`tokens_cached`).
+- `new agent --context-window N`; la plantilla trae `guardrails` válidos para el core 0.70
+  (`pii_detection` en entrada y salida, `max_length`, `cost_limit` 4000), `context_window`
+  (comentado si no se pasa) y un `knowledge.bundle` comentado. Un test la carga con
+  `AgentRuntime` sin warnings de guardrails.
+
+### Changed
+- Piso del core `astromesh>=0.70.0`.
+
+## [0.3.1] - 2026-09-27
+
+### Changed
+- Bumped the `astromesh` core dependency floor to `>=0.59.0` (`pyproject.toml`). No CLI code changes.
+
+## [0.2.1] - 2026-08-10
+
+### Changed
+- Bumped the `astromesh` core dependency floor to `>=0.40.0` (`pyproject.toml`).
+
+## [0.2.0] - 2026-07-27
+
+### Added
+- `run` now surfaces the per-model consumption breakdown (`usage.by_model`, astromesh core v0.36.0): a "Por modelo" table with provider / model / role / calls / tokens in-out / cost.
+- `version` now also reports the installed astromesh **core** version (via `importlib.metadata`), not just the CLI's own.
+
+### Changed
+- Bumped the astromesh core dependency pin to `>=0.36.0`.
+- `run` and `ask` now read the real run-response contract (`answer` + `usage`) instead of the stale `response`/`tokens_used` field names, via a shared `_format_run_output` helper; `trace_id` is read from the nested `trace`. `ask` previously rendered an empty body against core ≥ the version that introduced `answer`.

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

@@ -1,10 +1,10 @@
-Metadata-Version: 2.4
+Metadata-Version: 2.5
 Name: astromesh-cli
-Version: 0.3.0
+Version: 0.4.0
 Summary: CLI tool for managing Astromesh nodes and clusters
 License: Apache-2.0
 Requires-Python: >=3.12
-Requires-Dist: astromesh>=0.40.0
+Requires-Dist: astromesh>=0.70.0
 Requires-Dist: jinja2>=3.1.0
 Requires-Dist: rich>=13.0.0
 Requires-Dist: typer>=0.12.0

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

@@ -1,3 +1,3 @@
 """Astromesh CLI — manage Astromesh nodes and clusters."""
 
-__version__ = "0.3.0"
+__version__ = "0.4.0"

astromesh_cli-0.4.0/astromesh_cli/commands/eval.py

@@ -0,0 +1,17 @@
+"""astromeshctl eval — run `kind: Eval` files with core's eval runner (`astromesh-eval`)."""
+
+import typer
+
+
+def eval_command(
+    config_dir: str = typer.Argument(..., help="Config tree with the agents under test"),
+    files: list[str] | None = typer.Argument(  # noqa: B008
+        None, help="*.eval.yaml files (default: <config_dir>/evals/*.eval.yaml)"
+    ),
+    out: str | None = typer.Option(None, "--out", help="Write the JSON report here"),
+) -> None:
+    """Run agent evals locally. Exit 0 all pass, 1 below threshold, 2 load error."""
+    from astromesh.evals.__main__ import main
+
+    argv = [config_dir, *(files or [])] + (["--out", out] if out else [])
+    raise typer.Exit(code=main(argv))

{astromesh_cli-0.3.0 → astromesh_cli-0.4.0}/astromesh_cli/commands/new.py

@@ -1,7 +1,6 @@
 """astromeshctl new — Scaffold new agents, workflows, and tools."""
 
 from pathlib import Path
-from typing import Optional
 
 import typer
 from jinja2 import Environment, FileSystemLoader
@@ -27,6 +26,7 @@ def render_agent_template(
     temperature: float = 0.3,
     max_tokens: int = 2048,
     description: str = "",
+    context_window: int | None = None,
 ) -> str:
     """Render an agent YAML template."""
     env = _get_jinja_env()
@@ -42,6 +42,7 @@ def render_agent_template(
         tools=tools or [],
         temperature=temperature,
         max_tokens=max_tokens,
+        context_window=context_window,
     )
 
 
@@ -80,7 +81,10 @@ def new_agent(
     provider: str = typer.Option("ollama", "--provider", help="LLM provider"),
     model: str = typer.Option("llama3.1:8b", "--model", help="Model name"),
     orchestration: str = typer.Option("react", "--orchestration", help="Orchestration pattern"),
-    tools: Optional[list[str]] = typer.Option(None, "--tools", help="Tools to include"),
+    tools: list[str] | None = typer.Option(None, "--tools", help="Tools to include"),  # noqa: B008
+    context_window: int | None = typer.Option(
+        None, "--context-window", help="Model context window in tokens (sizes the history)"
+    ),
     output_dir: str = typer.Option("./config/agents", "--output-dir", help="Output directory"),
     force: bool = typer.Option(False, "--force", help="Overwrite existing file"),
 ) -> None:
@@ -99,6 +103,7 @@ def new_agent(
         model=model,
         orchestration_pattern=orchestration,
         tools=tools,
+        context_window=context_window,
     )
     dest.write_text(content)
     console.print(

{astromesh_cli-0.3.0 → astromesh_cli-0.4.0}/astromesh_cli/commands/run.py

@@ -2,7 +2,6 @@
 
 import json
 import uuid
-from typing import Optional
 
 import typer
 from rich.panel import Panel
@@ -36,16 +35,44 @@ def _format_run_output(data: dict) -> tuple[str, str, list[dict]]:
     return text, subtitle, rows
 
 
+def _print_guardrail_and_propuestas(data: dict) -> None:
+    """Core 0.70: a blocked run is HTTP 200 with the refusal as `answer`; say so."""
+    if data.get("blocked"):
+        g = data.get("guardrail") or {}
+        console.print(
+            Panel(
+                f"{g.get('direction', '?')} rule [bold]{g.get('rule', '?')}[/bold]: "
+                f"{g.get('reason', '')}",
+                title="[red]BLOCKED by guardrail[/red]",
+                border_style="red",
+            )
+        )
+    propuestas = [p for p in data.get("propuestas") or [] if isinstance(p, dict)]
+    if propuestas:
+        table = Table(title="Propuestas (sin ejecutar)", show_header=True)
+        for col in ("Tool", "Tipo", "Destino", "Operación", "Argumentos"):
+            table.add_column(col, style="cyan" if col == "Tool" else None)
+        for p in propuestas:
+            table.add_row(
+                str(p.get("tool", "")),
+                str(p.get("tipo", "")),
+                str(p.get("destino", "")),
+                str(p.get("operacion", "")),
+                json.dumps(p.get("argumentos", {}), ensure_ascii=False),
+            )
+        console.print(table)
+
+
 def run_command(
     name: str = typer.Argument(..., help="Agent or workflow name to run"),
     query: str = typer.Argument("", help="Query to send to the agent"),
-    session: Optional[str] = typer.Option(
+    session: str | None = typer.Option(
         None, "--session", help="Session ID (auto-generated if not set)"
     ),
     json_output: bool = typer.Option(False, "--json", help="Output raw JSON response"),
     timeout: float = typer.Option(60.0, "--timeout", help="Request timeout in seconds"),
     workflow: bool = typer.Option(False, "--workflow", help="Run as workflow instead of agent"),
-    input_data: Optional[str] = typer.Option(None, "--input", help="Workflow input data (JSON)"),
+    input_data: str | None = typer.Option(None, "--input", help="Workflow input data (JSON)"),
 ) -> None:
     """Execute an agent with a query or run a workflow."""
     if workflow:
@@ -64,7 +91,7 @@ def run_command(
             json={"query": query, "session_id": session_id},
             timeout=timeout,
         )
-    except Exception as e:
+    except Exception as e:  # noqa: BLE001
         print_error(f"Failed to run agent '{name}': {e}")
         raise typer.Exit(code=1)
 
@@ -78,18 +105,24 @@ def run_command(
             text,
             title=f"[cyan]{name}[/cyan]",
             subtitle=subtitle,
-            border_style="blue",
+            border_style="red" if data.get("blocked") else "blue",
         )
     )
+    _print_guardrail_and_propuestas(data)
     if by_model_rows:
         table = Table(title="Por modelo", show_header=True)
-        for col in ("Provider", "Model", "Role", "Calls", "In", "Out", "Cost"):
+        for col in ("Provider", "Model", "Role", "Calls", "In", "Cached", "Out", "Cost"):
             table.add_column(col, style="cyan" if col == "Provider" else None)
         for r in by_model_rows:
             cost = r.get("cost", 0.0) or 0.0
             table.add_row(
-                r.get("provider", ""), r.get("model", ""), r.get("role", ""),
-                str(r.get("calls", 0)), str(r.get("tokens_in", 0)), str(r.get("tokens_out", 0)),
+                r.get("provider", ""),
+                r.get("model", ""),
+                r.get("role", ""),
+                str(r.get("calls", 0)),
+                str(r.get("tokens_in", 0)),
+                str(r.get("tokens_cached", 0)),
+                str(r.get("tokens_out", 0)),
                 f"${cost:.4f}" if cost else "—",
             )
         console.print(table)
@@ -115,7 +148,7 @@ def _run_workflow(
             json=payload,
             timeout=timeout,
         )
-    except Exception as e:
+    except Exception as e:  # noqa: BLE001
         print_error(f"Failed to run workflow '{name}': {e}")
         raise typer.Exit(code=1)
 

{astromesh_cli-0.3.0 → astromesh_cli-0.4.0}/astromesh_cli/main.py

@@ -21,6 +21,7 @@ from astromesh_cli.commands import (
     tools,
     traces,
 )
+from astromesh_cli.commands import eval as eval_cmd
 
 app = typer.Typer(
     name="astromeshctl",
@@ -44,12 +45,14 @@ app.command("trace")(traces.trace_command)
 app.command("metrics")(metrics.metrics_command)
 app.command("cost")(metrics.cost_command)
 app.command("ask")(ask.ask_command)
+app.command("eval")(eval_cmd.eval_command)
 
 
 @app.command()
 def version():
     """Show astromesh version."""
-    from importlib.metadata import PackageNotFoundError, version as _pkg_version
+    from importlib.metadata import PackageNotFoundError
+    from importlib.metadata import version as _pkg_version
 
     typer.echo(f"astromesh-cli {__version__}")
     try:
@@ -70,7 +73,7 @@ def _load_plugins(app: typer.Typer) -> None:
         try:
             register_fn = ep.load()
             register_fn(app)
-        except Exception as exc:
+        except Exception as exc:  # noqa: BLE001
             typer.echo(f"Warning: failed to load plugin '{ep.name}': {exc}", err=True)
 
 

astromesh_cli-0.4.0/astromesh_cli/templates/agent.yaml.j2

@@ -0,0 +1,47 @@
+apiVersion: astromesh/v1
+kind: Agent
+metadata:
+  name: {{ name }}
+spec:
+  identity:
+    display_name: "{{ display_name }}"
+    description: "{{ description }}"
+  model:
+    primary:
+      provider: {{ provider }}
+      model: {{ model }}
+      temperature: {{ temperature }}
+      max_tokens: {{ max_tokens }}
+{% if context_window %}
+      context_window: {{ context_window }}
+{% else %}
+      # Declare the model's window so the runtime sizes the history budget:
+      # context_window: 128000
+{% endif %}
+    routing:
+      strategy: quality_first
+  prompts:
+    system: |
+      You are {{ display_name }}, a helpful AI assistant.
+  orchestration:
+    pattern: {{ orchestration_pattern }}
+    max_iterations: 10
+    timeout: 30
+{% if tools %}
+  tools:
+{% for tool in tools %}
+    - name: {{ tool }}
+{% endfor %}
+{% endif %}
+  guardrails:
+    input:
+      - type: pii_detection   # redact (default) | block | warn
+      - type: max_length      # truncate (default) | block
+        max_chars: 10000
+    output:
+      - type: pii_detection
+      - type: cost_limit      # blocks the run past this many output tokens
+        max_tokens_per_turn: 4000
+  # An OKF knowledge bundle (a directory) adds the kb_index/kb_read/kb_find tools:
+  # knowledge:
+  #   bundle: ./knowledge/{{ name }}

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

@@ -4,12 +4,12 @@ build-backend = "hatchling.build"
 
 [project]
 name = "astromesh-cli"
-version = "0.3.0"
+version = "0.4.0"
 description = "CLI tool for managing Astromesh nodes and clusters"
 requires-python = ">=3.12"
 license = {text = "Apache-2.0"}
 dependencies = [
-    "astromesh>=0.40.0",
+    "astromesh>=0.70.0",
     "typer>=0.12.0",
     "rich>=13.0.0",
     "jinja2>=3.1.0",

astromesh_cli-0.4.0/tests/test_core070.py

@@ -0,0 +1,73 @@
+"""CLI against core 0.70: blocked/propuestas in `run`, a template core loads, `eval`."""
+
+import logging
+
+import yaml
+from typer.testing import CliRunner
+
+from astromesh_cli.commands import run as run_mod
+from astromesh_cli.commands.new import render_agent_template
+from astromesh_cli.main import app
+
+runner = CliRunner()
+
+
+def test_run_shows_blocked_and_propuestas(monkeypatch):
+    body = {
+        "answer": "I can't help with that request.",
+        "blocked": True,
+        "guardrail": {"direction": "input", "rule": "pii_detection", "reason": "pii detected"},
+        "propuestas": [
+            {"tool": "erp_crear", "tipo": "api", "destino": "erp", "operacion": "crear"}
+        ],
+        "usage": {"tokens_in": 0, "tokens_out": 0, "by_model": []},
+    }
+    monkeypatch.setattr(run_mod, "api_post_with_timeout", lambda *a, **k: body)
+    result = runner.invoke(app, ["run", "support", "hi"])
+    assert result.exit_code == 0
+    assert "BLOCKED by guardrail" in result.stdout and "pii_detection" in result.stdout
+    assert "erp_crear" in result.stdout
+
+
+async def test_agent_template_loads_in_core_without_warnings(tmp_path, caplog):
+    from astromesh.runtime.engine import AgentRuntime
+
+    (tmp_path / "agents").mkdir()
+    text = render_agent_template("bot", context_window=128000)
+    spec = yaml.safe_load(text)["spec"]
+    assert spec["model"]["primary"]["context_window"] == 128000
+    (tmp_path / "agents" / "bot.agent.yaml").write_text(text)
+    runtime = AgentRuntime(config_dir=str(tmp_path))
+    with caplog.at_level(logging.WARNING, logger="astromesh.core.guardrails"):
+        await runtime.bootstrap()
+    assert "bot" in runtime._agents, runtime._agent_errors
+    assert not caplog.records
+    guard = runtime._agents["bot"]._guardrails
+    assert guard.has_input and guard.has_output and guard.cost_limit["max_tokens"] == 4000
+
+
+def test_template_without_context_window_leaves_it_commented():
+    assert (
+        "context_window"
+        not in yaml.safe_load(render_agent_template("bot"))["spec"]["model"]["primary"]
+    )
+
+
+def test_eval_forwards_to_core_runner(monkeypatch):
+    import astromesh.evals.__main__ as core_eval
+
+    seen = {}
+
+    def fake_main(argv):
+        seen["argv"] = argv
+        return 1
+
+    monkeypatch.setattr(core_eval, "main", fake_main)
+    result = runner.invoke(app, ["eval", "cfg", "a.eval.yaml", "--out", "r.json"])
+    assert result.exit_code == 1
+    assert seen["argv"] == ["cfg", "a.eval.yaml", "--out", "r.json"]
+
+
+def test_eval_without_evals_is_a_load_error(tmp_path):
+    result = runner.invoke(app, ["eval", str(tmp_path)])
+    assert result.exit_code == 2

{astromesh_cli-0.3.0 → astromesh_cli-0.4.0}/uv.lock

@@ -35,9 +35,10 @@ wheels = [
 
 [[package]]
 name = "astromesh"
-version = "0.40.0"
+version = "0.70.0"
 source = { editable = "../" }
 dependencies = [
+    { name = "astromesh-okf" },
     { name = "fastapi" },
     { name = "httpx" },
     { name = "jinja2" },
@@ -52,6 +53,7 @@ requires-dist = [
     { name = "aiosqlite", marker = "extra == 'sqlite'", specifier = ">=0.20.0" },
     { name = "astromesh", extras = ["redis", "postgres", "sqlite", "chromadb", "qdrant", "faiss", "embeddings", "onnx", "observability", "mcp", "mesh", "litellm", "centinela", "glyph"], marker = "extra == 'all'" },
     { name = "astromesh-glyph", marker = "extra == 'glyph'", editable = "../astromesh-glyph" },
+    { name = "astromesh-okf", specifier = ">=0.1,<0.2" },
     { name = "asyncpg", marker = "extra == 'postgres'", specifier = ">=0.30.0" },
     { name = "chromadb", marker = "extra == 'chromadb'", specifier = ">=0.5.0" },
     { name = "faiss-cpu", marker = "extra == 'faiss'", specifier = ">=1.8.0" },
@@ -60,7 +62,7 @@ requires-dist = [
     { name = "huggingface-hub", marker = "extra == 'centinela'", specifier = ">=0.24" },
     { name = "jinja2", specifier = ">=3.1.0" },
     { name = "litellm", marker = "extra == 'litellm'", specifier = ">=1.50.0" },
-    { name = "mcp", marker = "extra == 'mcp'", specifier = ">=1.0.0" },
+    { name = "mcp", marker = "extra == 'mcp'", specifier = ">=1.28.1,<2" },
     { name = "onnxruntime", marker = "extra == 'onnx'", specifier = ">=1.19.0" },
     { name = "opentelemetry-api", marker = "extra == 'observability'", specifier = ">=1.27.0" },
     { name = "opentelemetry-exporter-otlp", marker = "extra == 'observability'", specifier = ">=1.27.0" },
@@ -68,7 +70,7 @@ requires-dist = [
     { name = "prometheus-client", marker = "extra == 'observability'", specifier = ">=0.21.0" },
     { name = "psutil", specifier = ">=5.9.0" },
     { name = "psutil", marker = "extra == 'mesh'", specifier = ">=5.9.0" },
-    { name = "pydantic", specifier = ">=2.9.0" },
+    { name = "pydantic", specifier = ">=2.9.0,<3" },
     { name = "pyyaml", specifier = ">=6.0" },
     { name = "qdrant-client", marker = "extra == 'qdrant'", specifier = ">=1.11.0" },
     { name = "redis", extras = ["hiredis"], marker = "extra == 'redis'", specifier = ">=5.0.0" },
@@ -95,7 +97,7 @@ dev = [
 
 [[package]]
 name = "astromesh-cli"
-version = "0.3.0"
+version = "0.4.0"
 source = { editable = "." }
 dependencies = [
     { name = "astromesh" },
@@ -137,6 +139,18 @@ requires-dist = [
 ]
 provides-extras = ["dev", "test", "all"]
 
+[[package]]
+name = "astromesh-okf"
+version = "0.1.0"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "pyyaml" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/a5/33/ccf8f70e6cd22021dff6e11cba7c34b3d25d504675a1a417f18bc7c37730/astromesh_okf-0.1.0.tar.gz", hash = "sha256:acb932dc0a6969a77b52588e3572c147b0b69f5136860818c1b83474b503c7cf", size = 51340, upload-time = "2026-10-14T02:03:58.256Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/e9/9d/cf840f718086009198c763516beec46abaf5d2346ea2afde34c9c6be94b3/astromesh_okf-0.1.0-py3-none-any.whl", hash = "sha256:8be5fa9d80cbd331decc02f2f28b3b614d79f5fc7d7967ed15cb1f0aa20b2bab", size = 28989, upload-time = "2026-10-14T02:03:57.036Z" },
+]
+
 [[package]]
 name = "certifi"
 version = "2026.7.22"

astromesh_cli-0.3.0/CHANGELOG.md

@@ -1,23 +0,0 @@
-# Changelog
-
-All notable changes to this project will be documented in this file.
-
-The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
-and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
-
-## [Unreleased]
-
-## [0.2.1] - 2026-08-10
-
-### Changed
-- Bumped the `astromesh` core dependency floor to `>=0.40.0` (`pyproject.toml`).
-
-## [0.2.0] - 2026-07-27
-
-### Added
-- `run` now surfaces the per-model consumption breakdown (`usage.by_model`, astromesh core v0.36.0): a "Por modelo" table with provider / model / role / calls / tokens in-out / cost.
-- `version` now also reports the installed astromesh **core** version (via `importlib.metadata`), not just the CLI's own.
-
-### Changed
-- Bumped the astromesh core dependency pin to `>=0.36.0`.
-- `run` and `ask` now read the real run-response contract (`answer` + `usage`) instead of the stale `response`/`tokens_used` field names, via a shared `_format_run_output` helper; `trace_id` is read from the nested `trace`. `ask` previously rendered an empty body against core ≥ the version that introduced `answer`.

astromesh_cli-0.3.0/astromesh_cli/templates/agent.yaml.j2

@@ -1,29 +0,0 @@
-apiVersion: astromesh/v1
-kind: Agent
-metadata:
-  name: {{ name }}
-spec:
-  identity:
-    display_name: "{{ display_name }}"
-    description: "{{ description }}"
-  model:
-    primary:
-      provider: {{ provider }}
-      model: {{ model }}
-      temperature: {{ temperature }}
-      max_tokens: {{ max_tokens }}
-    routing:
-      strategy: quality_first
-  prompts:
-    system: |
-      You are {{ display_name }}, a helpful AI assistant.
-  orchestration:
-    pattern: {{ orchestration_pattern }}
-    max_iterations: 10
-    timeout: 30
-{% if tools %}
-  tools:
-{% for tool in tools %}
-    - name: {{ tool }}
-{% endfor %}
-{% endif %}