nexus-agent-cli 0.2.0__tar.gz → 0.5.0__tar.gz

{nexus_agent_cli-0.2.0 → nexus_agent_cli-0.5.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: nexus-agent-cli
-Version: 0.2.0
+Version: 0.5.0
 Summary: Nexus internal agent ops CLI — pull run params, push analysis results, send notifications. Admin only.
 Requires-Python: >=3.10
 Requires-Dist: httpx>=0.27
@@ -61,6 +61,26 @@ nexus-agent push-backtest --ticker tqqq \
     --conservative conservative_aggregated.json \
     --normal normal_aggregated.json
 
+# 回读 S3（均为只读，登录即可）：最新回测 / 市场分析报告 / 组合推荐
+nexus-agent get-backtest --ticker tqqq --out tqqq_backtest.json
+nexus-agent get-market-analysis --ticker tqqq --out tqqq_market.json
+nexus-agent get-portfolio --out portfolio.json
+
+# 拉取 S3 上最新的 signal_position 基线 config（Position-Research 阶段用）
+nexus-agent pull-config --ticker tqqq --kind normal --out tqqq-normal.json
+
+# 历史版本（by-date）：列出 → 取指定版本
+nexus-agent pull-config --ticker tqqq --kind normal --list --since 2026-06-01
+nexus-agent pull-config --ticker tqqq --kind normal --date 2026-06-01_to_2026-06-14 --out old.json
+nexus-agent get-market-analysis --ticker tqqq --list
+nexus-agent get-portfolio --list --since 2026-06-01
+
+# 回传 Position-Research 产出的 3 套仓位 config（≠ push-backtest 的回测聚合）
+nexus-agent push-config --ticker tqqq --time-range 2026-06-01_2026-06-14 \
+    --aggressive tqqq-aggressive.json \
+    --conservative tqqq-conservative.json \
+    --normal tqqq-normal.json
+
 # 服务端 SES 发通知邮件
 nexus-agent notify --to a@x.com --to b@y.com --subject "Weekly report" --body-file summary.txt
 ```
@@ -73,7 +93,7 @@ nexus-agent notify --to a@x.com --to b@y.com --subject "Weekly report" --body-fi
 | `NEXUS_AGENT_API_BASE_URL` | — | 直接覆盖完整 API base（含 `/api`） |
 | `NEXUS_AGENT_COGNITO_DOMAIN` | `auth.lookatwallstreet.com` | Cognito Hosted UI 域名 |
 | `NEXUS_AGENT_COGNITO_CLIENT_ID` | （内置） | Cognito app client id |
-| `NEXUS_AGENT_REDIRECT_URI` | `http://127.0.0.1:8252/callback` | 本地回调（须 localhost+端口） |
+| `NEXUS_AGENT_REDIRECT_URI` | `http://127.0.0.1:8251/callback` | 本地回调（须 localhost+端口；端口必须已加入 Cognito app client 的 Allowed callback URLs） |
 
 例如指向本地后端调试：
 

{nexus_agent_cli-0.2.0 → nexus_agent_cli-0.5.0}/README.md

@@ -50,6 +50,26 @@ nexus-agent push-backtest --ticker tqqq \
     --conservative conservative_aggregated.json \
     --normal normal_aggregated.json
 
+# 回读 S3（均为只读，登录即可）：最新回测 / 市场分析报告 / 组合推荐
+nexus-agent get-backtest --ticker tqqq --out tqqq_backtest.json
+nexus-agent get-market-analysis --ticker tqqq --out tqqq_market.json
+nexus-agent get-portfolio --out portfolio.json
+
+# 拉取 S3 上最新的 signal_position 基线 config（Position-Research 阶段用）
+nexus-agent pull-config --ticker tqqq --kind normal --out tqqq-normal.json
+
+# 历史版本（by-date）：列出 → 取指定版本
+nexus-agent pull-config --ticker tqqq --kind normal --list --since 2026-06-01
+nexus-agent pull-config --ticker tqqq --kind normal --date 2026-06-01_to_2026-06-14 --out old.json
+nexus-agent get-market-analysis --ticker tqqq --list
+nexus-agent get-portfolio --list --since 2026-06-01
+
+# 回传 Position-Research 产出的 3 套仓位 config（≠ push-backtest 的回测聚合）
+nexus-agent push-config --ticker tqqq --time-range 2026-06-01_2026-06-14 \
+    --aggressive tqqq-aggressive.json \
+    --conservative tqqq-conservative.json \
+    --normal tqqq-normal.json
+
 # 服务端 SES 发通知邮件
 nexus-agent notify --to a@x.com --to b@y.com --subject "Weekly report" --body-file summary.txt
 ```
@@ -62,7 +82,7 @@ nexus-agent notify --to a@x.com --to b@y.com --subject "Weekly report" --body-fi
 | `NEXUS_AGENT_API_BASE_URL` | — | 直接覆盖完整 API base（含 `/api`） |
 | `NEXUS_AGENT_COGNITO_DOMAIN` | `auth.lookatwallstreet.com` | Cognito Hosted UI 域名 |
 | `NEXUS_AGENT_COGNITO_CLIENT_ID` | （内置） | Cognito app client id |
-| `NEXUS_AGENT_REDIRECT_URI` | `http://127.0.0.1:8252/callback` | 本地回调（须 localhost+端口） |
+| `NEXUS_AGENT_REDIRECT_URI` | `http://127.0.0.1:8251/callback` | 本地回调（须 localhost+端口；端口必须已加入 Cognito app client 的 Allowed callback URLs） |
 
 例如指向本地后端调试：
 

nexus_agent_cli-0.5.0/nexus_agent_cli/__init__.py

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

{nexus_agent_cli-0.2.0 → nexus_agent_cli-0.5.0}/nexus_agent_cli/api_client.py

@@ -60,6 +60,21 @@ def get_strategy_data(
     return get_json("/nexus-agent/strategy-data/", params=params)
 
 
+def get_backtest(ticker: str) -> Any:
+    """GET /nexus-agent/backtest/ — latest aggregated backtest data for one ticker."""
+    return get_json("/nexus-agent/backtest/", params={"ticker": ticker})
+
+
+def get_market_analysis(ticker: str) -> Any:
+    """GET /nexus-agent/market-analysis/ — latest market analysis report for one ticker."""
+    return get_json("/nexus-agent/market-analysis/", params={"ticker": ticker})
+
+
+def get_portfolio_recommendation() -> Any:
+    """GET /nexus-agent/portfolio-recommendation/ — latest portfolio recommendation."""
+    return get_json("/nexus-agent/portfolio-recommendation/")
+
+
 def upload_market_analysis(ticker: str, content: str, language: str = "zh") -> Any:
     """POST /nexus-agent/upload/market-analysis/"""
     return post_json(
@@ -85,6 +100,56 @@ def upload_backtest(ticker: str, levels: dict[str, Any]) -> Any:
     return post_json("/nexus-agent/upload/backtest/", {"ticker": ticker, **levels})
 
 
+def get_position_config(
+    ticker: str, kind: str = "normal", date_range: str | None = None
+) -> Any:
+    """GET /nexus-agent/position-config/ — signal_position config from S3.
+
+    Mirrors the worker's download_latest_normal_config_from_s3: the server reads
+    configs/signal_position/{ticker}/<date_range>/{ticker}-{kind}.json and returns it
+    as JSON. With date_range, fetch that specific historical version; otherwise the
+    latest. This is the Position-Research baseline the local skill cannot otherwise read.
+    """
+    params: dict[str, Any] = {"ticker": ticker, "kind": kind}
+    if date_range:
+        params["date_range"] = date_range
+    return get_json("/nexus-agent/position-config/", params=params)
+
+
+def list_history(
+    artifact_type: str, ticker: str | None = None, kind: str | None = None, since: str | None = None
+) -> Any:
+    """GET /nexus-agent/history/ — list historical versions of an artifact.
+
+    artifact_type: config / market-analysis / portfolio.
+    Returns {type, count, items: [{key, created_at, date_range?}, ...]} newest-first.
+    """
+    params: dict[str, Any] = {"type": artifact_type}
+    if ticker:
+        params["ticker"] = ticker
+    if kind:
+        params["kind"] = kind
+    if since:
+        params["since"] = since
+    return get_json("/nexus-agent/history/", params=params)
+
+
+def upload_position_config(
+    ticker: str, configs: dict[str, Any], time_range: str | None = None
+) -> Any:
+    """POST /nexus-agent/upload/position-config/ — write the 3 position configs to S3.
+
+    configs: {aggressive/conservative/normal: {<level>: {...}}}. Distinct from
+    upload_backtest (which uploads backtest aggregation, not position configs).
+    Server writes configs/signal_position/{ticker}/{time_range}/{ticker}-{kind}.json
+    and invalidates the dashboard cache.
+    """
+    body: dict[str, Any] = {"ticker": ticker, **configs}
+    if time_range is not None:
+        body["time_range"] = time_range
+    return post_json("/nexus-agent/upload/position-config/", body)
+
+
 def notify(
     to: list[str], subject: str, body_text: str | None = None, body_html: str | None = None
 ) -> Any:

{nexus_agent_cli-0.2.0 → nexus_agent_cli-0.5.0}/nexus_agent_cli/commands/run/cmd.py

@@ -126,6 +126,142 @@ def register(app: typer.Typer) -> None:
             _run_err(e)
         console.print(JSON(json.dumps(data)))
 
+    @app.command(
+        "pull-config",
+        help="Pull the latest signal_position config for one ticker from S3 (the "
+        "Position-Research baseline; S3 creds stay server-side).",
+    )
+    def pull_config(
+        ticker: str = typer.Option(..., "--ticker", help="tqqq / soxl / ibit."),
+        kind: str = typer.Option(
+            "normal", "--kind", help="normal (default) / aggressive / conservative."
+        ),
+        list_versions: bool = typer.Option(
+            False, "--list", help="List historical config versions instead of fetching one."
+        ),
+        date_range: str = typer.Option(
+            None, "--date", help="Fetch a specific version by its date_range (from --list)."
+        ),
+        since: str = typer.Option(
+            None, "--since", help="With --list: only versions created on/after this ISO date."
+        ),
+        out: Path = typer.Option(
+            None, "--out", help="Write JSON to this file instead of stdout."
+        ),
+    ) -> None:
+        try:
+            if list_versions:
+                data = api_client.list_history("config", ticker=ticker, kind=kind, since=since)
+            else:
+                data = api_client.get_position_config(ticker, kind=kind, date_range=date_range)
+        except Exception as e:
+            _run_err(e)
+        _emit(data, out)
+
+    def _emit(data: object, out) -> None:
+        if out is not None:
+            out.write_text(json.dumps(data, ensure_ascii=False, indent=2), encoding="utf-8")
+            console.print(f"[green]已保存 →[/green] {out}")
+        else:
+            console.print(JSON(json.dumps(data)))
+
+    @app.command(
+        "get-backtest", help="Fetch the latest aggregated backtest data for one ticker from S3."
+    )
+    def get_backtest(
+        ticker: str = typer.Option(..., "--ticker", help="tqqq / soxl / ibit."),
+        out: Path = typer.Option(None, "--out", help="Write JSON to this file instead of stdout."),
+    ) -> None:
+        try:
+            data = api_client.get_backtest(ticker)
+        except Exception as e:
+            _run_err(e)
+        _emit(data, out)
+
+    @app.command(
+        "get-market-analysis",
+        help="Fetch the latest market analysis report for one ticker from S3.",
+    )
+    def get_market_analysis(
+        ticker: str = typer.Option(..., "--ticker", help="tqqq / soxl / ibit."),
+        list_versions: bool = typer.Option(
+            False, "--list", help="List historical report versions instead of fetching the latest."
+        ),
+        since: str = typer.Option(
+            None, "--since", help="With --list: only versions created on/after this ISO date."
+        ),
+        out: Path = typer.Option(None, "--out", help="Write JSON to this file instead of stdout."),
+    ) -> None:
+        try:
+            if list_versions:
+                data = api_client.list_history("market-analysis", ticker=ticker, since=since)
+            else:
+                data = api_client.get_market_analysis(ticker)
+        except Exception as e:
+            _run_err(e)
+        _emit(data, out)
+
+    @app.command(
+        "get-portfolio", help="Fetch the latest portfolio recommendation from S3."
+    )
+    def get_portfolio(
+        list_versions: bool = typer.Option(
+            False, "--list", help="List historical portfolio versions instead of the latest."
+        ),
+        since: str = typer.Option(
+            None, "--since", help="With --list: only versions created on/after this ISO date."
+        ),
+        out: Path = typer.Option(None, "--out", help="Write JSON to this file instead of stdout."),
+    ) -> None:
+        try:
+            if list_versions:
+                data = api_client.list_history("portfolio", since=since)
+            else:
+                data = api_client.get_portfolio_recommendation()
+        except Exception as e:
+            _run_err(e)
+        _emit(data, out)
+
+    @app.command(
+        "push-config",
+        help="Upload the 3 Position-Research configs for one ticker "
+        "(distinct from push-backtest, which uploads backtest aggregation).",
+    )
+    def push_config(
+        ticker: str = typer.Option(..., "--ticker", help="tqqq / soxl / ibit."),
+        aggressive: Path = typer.Option(
+            None, "--aggressive", exists=True, readable=True, help="{ticker}-aggressive.json"
+        ),
+        conservative: Path = typer.Option(
+            None, "--conservative", exists=True, readable=True, help="{ticker}-conservative.json"
+        ),
+        normal: Path = typer.Option(
+            None, "--normal", exists=True, readable=True, help="{ticker}-normal.json"
+        ),
+        time_range: str = typer.Option(
+            None, "--time-range", help="e.g. 2026-06-01_2026-06-14 (for the S3 key)."
+        ),
+    ) -> None:
+        configs: dict[str, object] = {}
+        for name, path in (
+            ("aggressive", aggressive),
+            ("conservative", conservative),
+            ("normal", normal),
+        ):
+            if path is not None:
+                try:
+                    configs[name] = json.loads(path.read_text(encoding="utf-8"))
+                except Exception as e:
+                    _run_err(e)
+        if not configs:
+            console.print("[red]至少提供一个档位文件: --aggressive / --conservative / --normal[/red]")
+            raise typer.Exit(1)
+        try:
+            data = api_client.upload_position_config(ticker, configs, time_range=time_range)
+        except Exception as e:
+            _run_err(e)
+        console.print(JSON(json.dumps(data)))
+
     @app.command("notify", help="Send a notification email via server-side SES.")
     def notify(
         to: list[str] = typer.Option(..., "--to", help="Recipient (repeatable)."),

{nexus_agent_cli-0.2.0 → nexus_agent_cli-0.5.0}/nexus_agent_cli/config.py

@@ -15,8 +15,11 @@ CREDENTIALS_PATH = CONFIG_DIR / "credentials.json"
 DEFAULT_API_ENDPOINT = "https://api.nexusquant.co"
 DEFAULT_COGNITO_DOMAIN = "auth.lookatwallstreet.com"
 DEFAULT_COGNITO_CLIENT_ID = "5o7hhd4hn4birr8c29vndehiat"
-# 与 nexusquant-cli (8251) 错开端口，便于两套 CLI 同机登录。
-DEFAULT_REDIRECT_URI = "http://127.0.0.1:8252/callback"
+# 与 nexusquant-cli 共用同一个 Cognito app client（5o7hhd4hn4birr8c29vndehiat），
+# 该 client 只登记了 8251/callback。沿用 8251 以避免 redirect_mismatch；
+# 两套 CLI 不会同时跑 OAuth 回调，端口冲突可忽略。需要错开时用 NEXUS_AGENT_REDIRECT_URI 覆盖
+# （但所选端口必须已加入 app client 的 Allowed callback URLs）。
+DEFAULT_REDIRECT_URI = "http://127.0.0.1:8251/callback"
 
 
 def _env(name: str, default: str | None = None) -> str | None:

{nexus_agent_cli-0.2.0 → nexus_agent_cli-0.5.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "nexus-agent-cli"
-version = "0.2.0"
+version = "0.5.0"
 description = "Nexus internal agent ops CLI — pull run params, push analysis results, send notifications. Admin only."
 readme = "README.md"
 requires-python = ">=3.10"

nexus_agent_cli-0.2.0/nexus_agent_cli/__init__.py

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