openrunner-sdk 2.19.2__tar.gz → 2.20.0__tar.gz

{openrunner_sdk-2.19.2 → openrunner_sdk-2.20.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: openrunner-sdk
-Version: 2.19.2
+Version: 2.20.0
 Summary: OpenRunner SDK - W&B-compatible ML experiment tracking client
 Project-URL: Homepage, https://github.com/jqueguiner/openrunner
 Project-URL: Repository, https://github.com/jqueguiner/openrunner

{openrunner_sdk-2.19.2 → openrunner_sdk-2.20.0}/openrunner/__init__.py

@@ -120,7 +120,7 @@ launch.from_run = _launch_from_run  # type: ignore[attr-defined]
 # openrunner.trace.patch_openai() syntax
 trace.patch_openai = _patch_openai  # type: ignore[attr-defined]
 
-__version__ = "2.19.2"
+__version__ = "2.20.0"
 
 logger = logging.getLogger("openrunner")
 

{openrunner_sdk-2.19.2 → openrunner_sdk-2.20.0}/openrunner/install_commands.py

@@ -783,6 +783,127 @@ If NO_RUNS: tell user no training runs found in project.
 If NO_METRICS: tell user runs exist but no metrics logged yet.
 """
 
+STATUSLINE_CMD = """---
+name: {prefix}statusline
+description: Configure which metrics appear in the Claude Code footer
+allowed-tools:
+  - Bash
+  - AskUserQuestion
+---
+<objective>
+Configure which training metrics appear in the Claude Code statusline footer.
+Fetches available metrics from the most recent run and lets the user pick.
+</objective>
+
+<process>
+1. Fetch available metrics from the latest run in the configured project.
+2. Present them to the user as a numbered list.
+3. Ask which metric to use for the sparkline (primary).
+4. Ask which additional metrics to show (comma-separated numbers).
+5. Save to ~/.openrunner/statusline.json.
+6. Confirm and show preview.
+</process>
+
+### Step 1: Fetch available metrics
+
+```bash
+python3 -c "
+import sys, os, json
+from pathlib import Path
+for p in ([os.path.join(d, 'site-packages') for d in __import__('glob').glob(os.path.expanduser('~/.local/lib/python3.*/')) + __import__('glob').glob(os.path.expanduser('~/Library/Python/3.*/lib/python/'))]):
+    if os.path.isdir(p): sys.path.insert(0, p)
+from openrunner.session import get_session_config
+from openrunner.api_client import APIClient
+
+config = get_session_config()
+if not config.get('api_key'):
+    print('NOT_CONFIGURED'); sys.exit(1)
+
+client = APIClient(base_url=config['base_url'], api_key=config['api_key'])
+pname = config.get('project', '')
+pid = None
+for p in client.list_projects():
+    full = f'{{p.get(\"org_name\",\"\")}}/{{p.get(\"name\",\"\")}}'
+    if full.lower() == pname.lower() or (p.get('name') or '').lower() == pname.lower():
+        pid = p.get('id'); break
+
+if not pid:
+    print('PROJECT_NOT_FOUND'); client.close(); sys.exit(1)
+
+# Get latest run
+resp = client._request('get', f'/projects/{{pid}}/runs', params={{'limit': 1, 'order': 'desc'}})
+runs_data = resp.json()
+runs = runs_data.get('runs', []) if isinstance(runs_data, dict) else runs_data
+if not runs:
+    print('NO_RUNS'); client.close(); sys.exit(1)
+
+rid = runs[0].get('id', '')
+run_name = runs[0].get('display_name') or rid
+
+# Get all metrics for this run
+resp = client._request('get', f'/runs/{{rid}}/metrics', params={{'max_points': 10000}})
+data = resp.json()
+metrics = data.get('metrics', data) if isinstance(data, dict) else {{}}
+if 'detail' in metrics:
+    metrics = {{}}
+
+keys = sorted(metrics.keys())
+if not keys:
+    print('NO_METRICS'); client.close(); sys.exit(1)
+
+print(f'METRICS_FROM_RUN={{run_name}}')
+for i, k in enumerate(keys, 1):
+    pts = metrics[k]
+    n = len(pts) if isinstance(pts, list) else 0
+    last = ''
+    if n > 0:
+        lp = pts[-1]
+        v = lp.get('value', lp) if isinstance(lp, dict) else lp
+        if isinstance(v, float):
+            last = f' (latest: {{v:.4f}}, {{n}} pts)'
+        else:
+            last = f' (latest: {{v}}, {{n}} pts)'
+    print(f'  [{{i}}] {{k}}{{last}}')
+
+# Also show current config if exists
+cfg_path = Path.home() / '.openrunner' / 'statusline.json'
+if cfg_path.exists():
+    cfg = json.loads(cfg_path.read_text())
+    print('\\nCURRENT_CONFIG: sparkline=%s metrics=%s' % (cfg.get('sparkline','auto'), cfg.get('metrics',[])))
+else:
+    print('\\nCURRENT_CONFIG: not configured (auto-detect)')
+
+client.close()
+"
+```
+
+### Step 2: Ask the user
+
+After showing the list, ask:
+- "Which metric for the sparkline? (number or name)" — this is the primary one shown as a mini chart
+- "Which additional metrics to display? (comma-separated numbers, or 'auto')"
+
+### Step 3: Save config
+
+```bash
+python3 -c "
+import json
+from pathlib import Path
+cfg_path = Path.home() / '.openrunner' / 'statusline.json'
+cfg_path.parent.mkdir(parents=True, exist_ok=True)
+cfg = {{'sparkline': 'SPARKLINE_KEY', 'metrics': METRICS_LIST}}
+cfg_path.write_text(json.dumps(cfg, indent=2))
+print(f'Saved: {{cfg_path}}')
+print(f'  Sparkline: {{cfg[\"sparkline\"]}}')
+print(f'  Metrics: {{cfg[\"metrics\"]}}')
+print()
+print('Footer will show on next statusline refresh (30s).')
+"
+```
+
+Replace SPARKLINE_KEY with the user's chosen metric key and METRICS_LIST with the Python list of chosen keys.
+"""
+
 MCP_CMD = """---
 name: {prefix}mcp
 description: Register OpenRunner MCP server for native tool access
@@ -954,6 +1075,7 @@ def install_claude_code() -> list[str]:
         "update.md": UPDATE_CMD,
         "mcp.md": MCP_CMD,
         "plot-session-run.md": PLOT_SESSION_RUN_CMD,
+        "statusline.md": STATUSLINE_CMD,
     }
 
     files = []
@@ -1033,6 +1155,7 @@ def _install_all_commands_to_dir(cmd_dir: Path, prefix: str = "openrunner:") ->
         "update.md": UPDATE_CMD,
         "mcp.md": MCP_CMD,
         "plot-session-run.md": PLOT_SESSION_RUN_CMD,
+        "statusline.md": STATUSLINE_CMD,
     }
 
     files = []

{openrunner_sdk-2.19.2 → openrunner_sdk-2.20.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "openrunner-sdk"
-version = "2.19.2"
+version = "2.20.0"
 description = "OpenRunner SDK - W&B-compatible ML experiment tracking client"
 readme = "README.md"
 license = {text = "MIT"}