systemlink-cli 1.18.1__tar.gz → 1.19.0__tar.gz

{systemlink_cli-1.18.1 → systemlink_cli-1.19.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: systemlink-cli
-Version: 1.18.1
+Version: 1.19.0
 Summary: SystemLink Integrator CLI - cross-platform CLI for SystemLink workflows and templates.
 License-File: LICENSE
 Author: Fred Visser

{systemlink_cli-1.18.1 → systemlink_cli-1.19.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "systemlink-cli"
-version = "1.18.1"
+version = "1.19.0"
 description = "SystemLink Integrator CLI - cross-platform CLI for SystemLink workflows and templates."
 authors = ["Fred Visser <fred.visser@emerson.com>"]
 packages = [{ include = "slcli" }]

{systemlink_cli-1.18.1 → systemlink_cli-1.19.0}/slcli/_version.py

@@ -1,4 +1,4 @@
 """Version information for slcli."""
 
 # This file is auto-generated. Do not edit manually.
-__version__ = "1.18.1"
+__version__ = "1.19.0"

{systemlink_cli-1.18.1 → systemlink_cli-1.19.0}/slcli/mcp_server.py

@@ -254,12 +254,27 @@ def query_tag_history(path: str, take: int = 100) -> str:
     from .utils import get_base_url
 
     path = _require(path, "path")
-    encoded_path = urllib.parse.quote(path, safe="")
-    url = f"{get_base_url()}/nitag/v2/tags/{encoded_path}/values/history?take={take}"
-    data = _get_json(url)
+    url = f"{get_base_url()}/nitaghistorian/v2/tags/query-history"
+    data = _post_json(
+        url,
+        {
+            "path": path,
+            "startTime": "0001-01-01T00:00:00Z",
+            "endTime": "9999-12-31T23:59:59Z",
+            "take": take,
+            "sortOrder": "DESCENDING",
+        },
+    )
     if isinstance(data, list):
         return _dump(data)
-    return _dump(data.get("values", data.get("tagsWithAggregates", [])))
+    values = data.get("values", [])
+    value_type = data.get("type")
+    if isinstance(values, list) and isinstance(value_type, str):
+        values = [
+            {**item, "type": value_type} if isinstance(item, dict) and "type" not in item else item
+            for item in values
+        ]
+    return _dump(values)
 
 
 @server.tool()

{systemlink_cli-1.18.1 → systemlink_cli-1.19.0}/slcli/skills/slcli/references/commands.md

@@ -378,6 +378,7 @@ slcli dataframe delete <TABLE_ID>... [--yes]
 slcli tag list [OPTIONS]                            # List tags (filter by path glob, workspace)
 slcli tag get <TAG_PATH> [-f json]                  # Get tag metadata
 slcli tag get-value <TAG_PATH>                      # Read current tag value
+slcli tag history <TAG_PATH> [-w WORKSPACE] [-t TAKE] [-f json] [--graph]  # Read or graph history
 slcli tag set-value <TAG_PATH> <VALUE>              # Write a tag value
 slcli tag create --path <PATH> --data-type <TYPE>   # Create a new tag
 slcli tag update <TAG_PATH> [OPTIONS]               # Update tag metadata

{systemlink_cli-1.18.1 → systemlink_cli-1.19.0}/slcli/skills/slcli/references/webapp/systemlink-services.md

@@ -7,6 +7,7 @@ https://<server>/<service-prefix>/swagger/v2/<service-name>.yaml
 ```
 
 Examples:
+
 - `https://myserver.com/nitag/swagger/v2/nitag.yaml`
 - `https://myserver.com/nitest/swagger/v2/nitest.yaml`
 
@@ -14,18 +15,20 @@ Use the spec URL as the `input` in your `openapi-ts.config.ts`.
 
 ---
 
-## Tag Historian (`/nitag`)
+## Tag Services
+
+**Tag service base URL:** `window.location.origin + '/nitag'`
 
-**Base URL:** `window.location.origin + '/nitag'`
+**Tag Historian service base URL:** `window.location.origin + '/nitaghistorian'`
 
 ### Key endpoints
 
-| Operation | Method | Path |
-|-----------|--------|------|
-| Query tags with current values | POST | `/nitag/v2/query-tags-with-values` |
-| Get single tag | GET | `/nitag/v2/tags/{path}` |
-| Write tag value | PUT | `/nitag/v2/tags/{path}/values/current` |
-| Query tag history | POST | `/nitag/v2/history-data/query-decimated-data` |
+| Operation                      | Method | Path                                    |
+| ------------------------------ | ------ | --------------------------------------- |
+| Query tags with current values | POST   | `/nitag/v2/query-tags-with-values`      |
+| Get single tag                 | GET    | `/nitag/v2/tags/{path}`                 |
+| Write tag value                | PUT    | `/nitag/v2/tags/{path}/values/current`  |
+| Query tag history              | POST   | `/nitaghistorian/v2/tags/query-history` |
 
 ### Query body (`POST /query-tags-with-values`)
 
@@ -69,12 +72,12 @@ Use the spec URL as the `input` in your `openapi-ts.config.ts`.
 
 ### Key endpoints
 
-| Operation | Method | Path |
-|-----------|--------|------|
-| Query results | POST | `/nitest/v2/query-results` |
-| Get result by ID | GET | `/nitest/v2/results/{id}` |
-| Query steps | POST | `/nitest/v2/query-steps` |
-| Get products | GET | `/nitest/v2/products` |
+| Operation        | Method | Path                       |
+| ---------------- | ------ | -------------------------- |
+| Query results    | POST   | `/nitest/v2/query-results` |
+| Get result by ID | GET    | `/nitest/v2/results/{id}`  |
+| Query steps      | POST   | `/nitest/v2/query-steps`   |
+| Get products     | GET    | `/nitest/v2/products`      |
 
 ### Query body
 
@@ -95,11 +98,11 @@ Use the spec URL as the `input` in your `openapi-ts.config.ts`.
 
 ### Key endpoints
 
-| Operation | Method | Path |
-|-----------|--------|------|
-| Query assets | POST | `/niapm/v1/query-assets` |
-| Get asset | GET | `/niapm/v1/assets/{id}` |
-| Get calibration forecast | GET | `/niapm/v1/assets/{id}/policies` |
+| Operation                | Method | Path                             |
+| ------------------------ | ------ | -------------------------------- |
+| Query assets             | POST   | `/niapm/v1/query-assets`         |
+| Get asset                | GET    | `/niapm/v1/assets/{id}`          |
+| Get calibration forecast | GET    | `/niapm/v1/assets/{id}/policies` |
 
 ---
 
@@ -109,10 +112,10 @@ Use the spec URL as the `input` in your `openapi-ts.config.ts`.
 
 ### Key endpoints
 
-| Operation | Method | Path |
-|-----------|--------|------|
-| Get systems | GET | `/nisysmgmt/v1/systems` |
-| Query systems | POST | `/nisysmgmt/v1/query-systems` |
+| Operation     | Method | Path                          |
+| ------------- | ------ | ----------------------------- |
+| Get systems   | GET    | `/nisysmgmt/v1/systems`       |
+| Query systems | POST   | `/nisysmgmt/v1/query-systems` |
 
 ---
 
@@ -122,10 +125,10 @@ Use the spec URL as the `input` in your `openapi-ts.config.ts`.
 
 ### Key endpoints
 
-| Operation | Method | Path |
-|-----------|--------|------|
-| Query work orders | POST | `/niworkorder/v1/query` |
-| Update work order | PATCH | `/niworkorder/v1/work-orders/{id}` |
+| Operation         | Method | Path                               |
+| ----------------- | ------ | ---------------------------------- |
+| Query work orders | POST   | `/niworkorder/v1/query`            |
+| Update work order | PATCH  | `/niworkorder/v1/work-orders/{id}` |
 
 ---
 
@@ -137,11 +140,11 @@ The app is served by SystemLink and calls SystemLink. Browser session cookies ar
 
 ```typescript
 // hey-api client setup
-import { createClient } from '@hey-api/client-fetch';
+import { createClient } from "@hey-api/client-fetch";
 
 export const apiClient = createClient({
   baseUrl: `${window.location.origin}/nitag`,
-  credentials: 'include',
+  credentials: "include",
 });
 ```
 
@@ -153,7 +156,7 @@ No API key needed. The user must be logged in to SystemLink in that browser tab.
 export const apiClient = createClient({
   baseUrl: `${window.location.origin}/nitag`,
   headers: {
-    'x-ni-api-key': localStorage.getItem('sl_api_key') ?? '',
+    "x-ni-api-key": localStorage.getItem("sl_api_key") ?? "",
   },
 });
 ```
@@ -174,7 +177,7 @@ path = "cpu" or path = "mem"           OR
 keywords.Contains("production")        array contains
 ```
 
-String values must be double-quoted in the filter string. Build filters by joining parts with ` and `.
+String values must be double-quoted in the filter string. Build filters by joining parts with ` and `, including the surrounding spaces.
 
 ---
 
@@ -182,11 +185,11 @@ String values must be double-quoted in the filter string. Build filters by joini
 
 SystemLink APIs return standard HTTP status codes. Common ones:
 
-| Code | Meaning |
-|------|---------|
-| 401 | Not authenticated — user needs to log in, or API key is invalid |
-| 403 | Authenticated but not authorized for this workspace/resource |
-| 404 | Resource not found |
-| 422 | Invalid request body (e.g., bad LINQ filter) |
+| Code | Meaning                                                         |
+| ---- | --------------------------------------------------------------- |
+| 401  | Not authenticated — user needs to log in, or API key is invalid |
+| 403  | Authenticated but not authorized for this workspace/resource    |
+| 404  | Resource not found                                              |
+| 422  | Invalid request body (e.g., bad LINQ filter)                    |
 
 Show errors in a `<nimble-banner severity="error">` with the status code and message from the response body.

{systemlink_cli-1.18.1 → systemlink_cli-1.19.0}/slcli/tag_click.py

@@ -5,6 +5,7 @@ tag values. All tag operations are scoped to workspaces with proper error handli
 """
 
 import json
+import math
 import shutil
 import sys
 import urllib.parse
@@ -24,6 +25,8 @@ from .utils import (
 )
 from .workspace_utils import resolve_workspace_id
 
+_TAG_HISTORY_GRAPH_HEIGHT = 6
+
 
 def _tag_formatter(item: Dict[str, Any]) -> List[str]:
     """Format a tag for table output.
@@ -52,6 +55,124 @@ def _tag_formatter(item: Dict[str, Any]) -> List[str]:
     return [path, tag_type, value, last_updated]
 
 
+def _tag_history_formatter(item: Dict[str, Any]) -> List[str]:
+    """Format one historical tag value for table output."""
+    value_data = item.get("value", {})
+    if isinstance(value_data, dict):
+        value = value_data.get("value", "N/A")
+        tag_type = value_data.get("type", item.get("type", "N/A"))
+    else:
+        value = value_data if value_data is not None else "N/A"
+        tag_type = item.get("type", "N/A")
+
+    return [
+        str(item.get("timestamp", "N/A")),
+        str(value),
+        str(tag_type),
+    ]
+
+
+def _tag_history_numeric_value(item: Dict[str, Any]) -> Optional[float]:
+    """Return a finite numeric history value, if one is available."""
+    value_data = item.get("value")
+    value = value_data.get("value") if isinstance(value_data, dict) else value_data
+    if value is None or isinstance(value, bool):
+        return None
+
+    try:
+        numeric_value = float(value)
+    except (TypeError, ValueError):
+        return None
+
+    return numeric_value if math.isfinite(numeric_value) else None
+
+
+def _downsample_history(values: List[float], width: int) -> List[float]:
+    """Downsample values to fit the available graph width."""
+    if len(values) <= width:
+        return values
+    if width <= 1:
+        return [values[-1]]
+
+    return [values[round(index * (len(values) - 1) / (width - 1))] for index in range(width)]
+
+
+def _format_graph_value(value: float) -> str:
+    """Format a graph statistic without unnecessary trailing zeroes."""
+    return f"{value:.6g}"
+
+
+def _render_tag_history_graph(
+    tag_path: str, workspace_label: str, history: List[Dict[str, Any]]
+) -> None:
+    """Render numeric tag history as a terminal sparkline."""
+    if not history:
+        click.echo(f"No tag history found in workspace '{workspace_label}'")
+        return
+
+    chronological_history = list(reversed(history))
+    numeric_values = [_tag_history_numeric_value(item) for item in chronological_history]
+    if any(value is None for value in numeric_values):
+        click.echo(
+            f"Cannot graph non-numeric tag history for '{tag_path}' "
+            f"in workspace '{workspace_label}'."
+        )
+        click.echo("Run without --graph to view the history table.")
+        return
+
+    values = [value for value in numeric_values if value is not None]
+    minimum = min(values)
+    maximum = max(values)
+    latest = values[-1]
+    terminal_width = max(shutil.get_terminal_size().columns, 1)
+    graph_width = max(1, min(len(values), terminal_width - 16))
+    graph_values = _downsample_history(values, graph_width)
+    value_range = maximum - minimum
+    point_rows = [
+        (
+            _TAG_HISTORY_GRAPH_HEIGHT // 2
+            if value_range == 0
+            else round((maximum - value) / value_range * (_TAG_HISTORY_GRAPH_HEIGHT - 1))
+        )
+        for value in graph_values
+    ]
+    graph_rows = [[" "] * len(graph_values) for _ in range(_TAG_HISTORY_GRAPH_HEIGHT)]
+    for index, point_row in enumerate(point_rows):
+        graph_rows[point_row][index] = "●"
+        if index == 0:
+            continue
+
+        previous_row = point_rows[index - 1]
+        if previous_row == point_row:
+            continue
+
+        step = 1 if point_row > previous_row else -1
+        for row in range(previous_row + step, point_row, step):
+            graph_rows[row][index] = "│"
+
+    first_timestamp = chronological_history[0].get("timestamp", "N/A")
+    last_timestamp = chronological_history[-1].get("timestamp", "N/A")
+    click.echo(f"Tag history graph for '{tag_path}'")
+    click.echo(f"Workspace: {workspace_label}")
+    click.echo(f"Range: {first_timestamp} to {last_timestamp}")
+    click.echo(
+        f"Min: {_format_graph_value(minimum)}  "
+        f"Max: {_format_graph_value(maximum)}  "
+        f"Latest: {_format_graph_value(latest)}"
+    )
+    for row, graph_row in enumerate(graph_rows):
+        if value_range == 0:
+            row_label = (
+                _format_graph_value(maximum) if row == _TAG_HISTORY_GRAPH_HEIGHT // 2 else ""
+            )
+        else:
+            row_value = maximum - value_range * row / (_TAG_HISTORY_GRAPH_HEIGHT - 1)
+            row_label = _format_graph_value(row_value)
+        click.echo(f"  {row_label:>8} ┤{''.join(graph_row)}")
+    click.echo(f"  {_format_graph_value(minimum):>8} └{'─' * len(graph_values)}")
+    click.echo(f"  oldest{' ' * max(len(graph_values) - 12, 1)}newest")
+
+
 def _calculate_column_widths() -> List[int]:
     """Calculate dynamic column widths based on terminal size.
 
@@ -164,6 +285,59 @@ def _detect_value_type(value_str: str) -> Tuple[Any, str]:
     return value_str, "STRING"
 
 
+def _get_tag_history(tag_path: str, workspace_id: Optional[str], take: int) -> List[Dict[str, Any]]:
+    """Fetch historical values for a tag.
+
+    Args:
+        tag_path: Tag path.
+        workspace_id: Optional workspace ID.
+        take: Maximum number of history entries to return.
+
+    Returns:
+        Historical tag value dictionaries, most recent first.
+    """
+    query_payload: Dict[str, Any] = {
+        "path": tag_path,
+        "startTime": "0001-01-01T00:00:00Z",
+        "endTime": "9999-12-31T23:59:59Z",
+        "take": take,
+        "sortOrder": "DESCENDING",
+    }
+    if workspace_id:
+        query_payload["workspace"] = workspace_id
+
+    url = f"{get_base_url()}/nitaghistorian/v2/tags/query-history"
+    resp = make_api_request("POST", url, payload=query_payload)
+    data = resp.json()
+
+    if isinstance(data, list):
+        return [item for item in data if isinstance(item, dict)]
+
+    if not isinstance(data, dict):
+        return []
+
+    value_type = data.get("type")
+
+    def normalize_entries(entries: Any) -> List[Dict[str, Any]]:
+        if not isinstance(entries, list):
+            return []
+        normalized: List[Dict[str, Any]] = []
+        for item in entries:
+            if not isinstance(item, dict):
+                continue
+            if isinstance(value_type, str) and "type" not in item:
+                item = {**item, "type": value_type}
+            normalized.append(item)
+        return normalized
+
+    for key in ("values", "history", "tagsWithAggregates", "data"):
+        entries = data.get(key)
+        if isinstance(entries, list):
+            return normalize_entries(entries)
+
+    return []
+
+
 def register_tag_commands(cli: Any) -> None:
     """Register the 'tag' command group and its subcommands."""
 
@@ -320,6 +494,78 @@ def register_tag_commands(cli: Any) -> None:
         except Exception as exc:
             handle_api_error(exc)
 
+    @tag.command(name="history")
+    @click.argument("tag_path")
+    @click.option(
+        "--workspace",
+        "-w",
+        type=str,
+        default=None,
+        help="Workspace ID or name (defaults to default workspace)",
+    )
+    @click.option(
+        "--take",
+        "-t",
+        type=click.IntRange(min=1),
+        default=100,
+        show_default=True,
+        help="Maximum number of historical values to return",
+    )
+    @click.option(
+        "--format",
+        "-f",
+        type=click.Choice(["table", "json"]),
+        default="table",
+        show_default=True,
+        help="Output format",
+    )
+    @click.option(
+        "--graph",
+        is_flag=True,
+        help="Render numeric history as a terminal sparkline (table format only)",
+    )
+    def tag_history(
+        tag_path: str,
+        workspace: Optional[str],
+        take: int,
+        format: str,
+        graph: bool,
+    ) -> None:
+        """Show historical values for a tag.
+
+        TAG_PATH is the path identifier of the tag.
+        """
+        validate_output_format(format)
+        if graph and format == "json":
+            click.echo("✗ --graph cannot be used with --format json", err=True)
+            sys.exit(ExitCodes.INVALID_INPUT)
+
+        try:
+            ws_id = resolve_workspace_id(workspace)
+            history = _get_tag_history(tag_path, ws_id, take)
+            workspace_label = ws_id or workspace or "default workspace"
+
+            if graph:
+                _render_tag_history_graph(tag_path, workspace_label, history)
+                return
+
+            history_resp = FilteredResponse({"values": history})
+
+            UniversalResponseHandler.handle_list_response(
+                resp=history_resp,
+                data_key="values",
+                item_name="tag history entry",
+                format_output=format,
+                formatter_func=_tag_history_formatter,
+                headers=["Timestamp", "Value", "Type"],
+                column_widths=[28, 30, 12],
+                empty_message=f"No tag history found in workspace '{workspace_label}'",
+                enable_pagination=False,
+                page_size=take,
+            )
+        except Exception as exc:
+            handle_api_error(exc)
+
     @tag.command(name="get")
     @click.argument("tag_path")
     @click.option(

{systemlink_cli-1.18.1 → systemlink_cli-1.19.0}/slcli/utils.py

@@ -11,6 +11,7 @@ import click
 import keyring
 import requests
 
+from . import ssl_trust
 from .rich_output import print_json
 from .ssl_trust import use_standard_ssl_context
 
@@ -585,8 +586,13 @@ def get_ssl_verify(server_uri: Optional[str] = None) -> Union[bool, str]:
         except (OSError, ValueError):
             pass
 
-    if os.environ.get("REQUESTS_CA_BUNDLE") or os.environ.get("SSL_CERT_FILE"):
-        return os.environ.get("REQUESTS_CA_BUNDLE") or os.environ["SSL_CERT_FILE"]
+    requests_ca_bundle = os.environ.get("REQUESTS_CA_BUNDLE")
+    if requests_ca_bundle:
+        return requests_ca_bundle
+
+    ssl_cert_file = os.environ.get("SSL_CERT_FILE")
+    if ssl_cert_file and not ssl_trust.OS_TRUST_INJECTED:
+        return ssl_cert_file
 
     return True