Add McLaren NVIDIA demo app

Author: Ickerday

Dockerfile

@@ -23,7 +23,7 @@ USER splunk
 
 WORKDIR /tmp/sdk
 
-RUN /bin/bash -c "LD_LIBRARY_PATH=/opt/splunk/lib /opt/splunk/bin/python3.13 -m pip install '.[openai]' --target=/splunklib-deps"
+RUN /bin/bash -c "LD_LIBRARY_PATH=/opt/splunk/lib /opt/splunk/bin/python3.13 -m pip install '.[openai,bedrock]' --target=/splunklib-deps"
 
 USER ${ANSIBLE_USER}
 WORKDIR /opt/splunk

Makefile

@@ -116,3 +116,7 @@ docker-splunk-restart:
 .PHONY: docker-tail-python-log
 docker-tail-python-log:
 	docker exec -it $(CONTAINER_NAME) sudo tail $(SPLUNK_HOME)/var/log/splunk/python.log
+
+.PHONY: bedrock-login
+bedrock-login:
+	./scripts/bedrock-login.sh

compose.yml

@@ -11,6 +11,7 @@ services:
             - SPLUNK_HEC_TOKEN=11111111-1111-1111-1111-1111111111113
             - SPLUNK_PASSWORD=changed!
             - SPLUNK_APPS_URL=https://github.com/splunk/sdk-app-collection/releases/latest/download/sdkappcollection.tgz
+            - TZ=Europe/Warsaw
         ports:
             - "8000:8000"
             - "8088:8088"
@@ -33,6 +34,7 @@ services:
             - "./examples/ai_custom_search_app:/opt/splunk/etc/apps/ai_custom_search_app"
             - "./examples/ai_custom_alert_app:/opt/splunk/etc/apps/ai_custom_alert_app"
             - "./examples/ai_modinput_app:/opt/splunk/etc/apps/ai_modinput_app"
+            - "~/Projects/mclaren-demo-app:/opt/splunk/etc/apps/mclaren_demo_app"
 
             - "./splunklib:/opt/splunk/etc/apps/eventing_app/bin/splunklib"
             - "./splunklib:/opt/splunk/etc/apps/generating_app/bin/splunklib"
@@ -44,6 +46,9 @@ services:
             - "./splunklib:/opt/splunk/etc/apps/ai_custom_search_app/bin/lib/splunklib"
             - "./splunklib:/opt/splunk/etc/apps/ai_custom_alert_app/bin/lib/splunklib"
             - "./splunklib:/opt/splunk/etc/apps/ai_modinput_app/bin/lib/splunklib"
+            - "./splunklib:/opt/splunk/etc/apps/mclaren_demo_app/bin/lib/splunklib"
 
             - "./tests:/opt/splunk/etc/apps/ai_agentic_test_app/bin/lib/tests"
             - "./tests:/opt/splunk/etc/apps/ai_agentic_test_local_tools_app/bin/lib/tests"
+
+            - "~/.aws:/home/splunk/.aws:ro"

examples/ai_modinput_app/bin/agentic_weather.py

@@ -20,8 +20,6 @@
 from _collections_abc import dict_items
 from typing import final, override
 
-from splunklib.ai.messages import AIMessage, ContentBlock, TextBlock
-
 # ! NOTE: This insert is only needed for splunk-sdk-python CI/CD to work.
 # ! Remove this if you're modifying this example locally.
 sys.path.insert(0, "/splunklib-deps")
@@ -33,6 +31,7 @@
 
 from splunklib.ai import OpenAIModel
 from splunklib.ai.agent import Agent
+from splunklib.ai.messages import AIMessage, ContentBlock, TextBlock
 from splunklib.modularinput.argument import Argument
 from splunklib.modularinput.event import Event
 from splunklib.modularinput.event_writer import EventWriter

examples/mclaren_demo_app/CLAUDE.md

@@ -0,0 +1,91 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Running
+
+```bash
+# Start Splunk (from the splunk-sdk-python root):
+docker compose up -d --build
+
+# Start the F1 2025 data collector (separate Docker container):
+./start-collector.sh
+
+# After Splunk is up, enable all three modinput stanzas:
+docker exec splunk /opt/splunk/bin/splunk http-event-collector enable -uri https://localhost:8089 -auth admin:changed! -server-cert-cn SplunkServerDefaultCert
+curl -sk -u admin:changed! https://localhost:8089/services/data/inputs/turn_coach/turn_coach/enable -d '' -X POST
+curl -sk -u admin:changed! https://localhost:8089/services/data/inputs/pit_strategy/pit_strategy/enable -d '' -X POST
+curl -sk -u admin:changed! https://localhost:8089/services/data/inputs/race_summary/race_summary/enable -d '' -X POST
+```
+
+The `docker-compose.yml` in the repo root mounts `examples/mclaren_demo_app` directly into
+the Splunk container as `/opt/splunk/etc/apps/mclaren_demo_app` — no deploy step needed.
+
+## Commands
+
+```bash
+# Lint: ruff fix + format + basedpyright (run from splunk-sdk-python root)
+make lint
+
+# Tail the advisor log
+docker exec splunk tail -f /opt/splunk/var/log/splunk/mclaren_demo_app.log
+
+# Run a modular input manually (LD_LIBRARY_PATH required for libssl inside container)
+docker exec splunk bash -c "LD_LIBRARY_PATH=/opt/splunk/lib /opt/splunk/bin/python3.13 /opt/splunk/etc/apps/mclaren_demo_app/bin/turn_coach.py"
+
+# Restart Splunk (picks up config changes without full container rebuild)
+make docker-splunk-restart
+
+# Full container rebuild (needed after Dockerfile or compose.yml changes)
+make docker-refresh
+```
+
+No test suite. `make lint` (from the repo root) is the only automated gate.
+Run it after every code change before considering work done.
+
+## Architecture
+
+Three **modular inputs** poll `index=main source=f1_2025` via oneshot searches and
+emit structured JSON advice to `index=main`.
+
+```
+F1 2025 game → UDP → f1-2025 collector (Docker :8501)
+  → HEC → Splunk Enterprise (:8088) → index=main source=f1_2025
+
+Modular inputs (bin/*.py, each a splunklib.modularinput.Script subclass):
+  turn_coach.py   — triggers on sector change (LapData.sector field)
+  pit_strategy.py — triggers on lap change (LapData.current_lap_num field)
+  race_summary.py — triggers on race end (FinalClassificationData result_status=3)
+
+Each input → splunklib.ai.Agent (LangChain backend) → LLM → JSON event → index=main
+```
+
+**LLM connector:** `bedrock_connector.py` creates an `AnthropicBedrockModel` that
+authenticates via the `ssc-ci-cd_bedrock-inference-role` AWS profile using SigV4
+(no stored credentials — `credential_process` in `~/.aws/config` calls `dev-login`).
+The fallback is `circuit_connector.py` which uses the Cisco Circuit AI gateway (OpenAI-compatible).
+All three modinputs import one of these connectors to get their `_LLM_MODEL`.
+
+**Dashboard:** Single `advisor` dashboard (`local/data/ui/views/advisor.xml`) with three
+side-by-side panels (Turn Coach, Pit Strategy, Race Debrief). Each panel has its own
+JS/CSS file under `appserver/static/`. Dashboard loads via Splunk Simple XML extension
+(`script=` / `stylesheet=` attributes).
+
+**Events:** All three sourcetypes use `KV_MODE = json` (see `default/props.conf`).
+JS polls via `service.oneshotSearch()` (Splunk Web SDK, authenticated) every 3 seconds.
+
+**Dependencies:** Runtime deps are bundled into `bin/lib/` (volume-mounted live into
+Splunk). `bin/lib/splunklib` is a symlink to the repo's `splunklib/` (set up in
+`docker-compose.yml`). All other 3rd-party packages (`langchain*`, `httpx`, `pydantic`,
+`boto3`/`botocore`, etc.) must be installed into `bin/lib/` before the modinputs can run.
+
+## Key Constraints
+
+- `bin/lib/` is the only dependency path available inside the Splunk container.
+- AWS session tokens from `dev-login` expire ~1h; refresh by running any `aws` command
+  via `dev-login` or logging in again.
+- After any JS/CSS/conf change, hit `http://localhost:8000/en-GB/debug/refresh` then hard-reload
+  the dashboard. This reloads all app confs and bumps static asset cache in one shot.
+- `basedpyright` config in the root `pyproject.toml` silences `splunklib` type stubs —
+  use `# pyright: ignore[reportMissingImports]` for splunklib imports in bin/ files.
+- Line length limit is 100 chars (ruff `E501` is ignored, but keep lines readable).

examples/mclaren_demo_app/README/inputs.conf.spec

@@ -0,0 +1,11 @@
+[turn_coach://<name>]
+python.required = 3.13
+placeholder = <string>
+
+[pit_strategy://<name>]
+python.required = 3.13
+placeholder = <string>
+
+[race_summary://<name>]
+python.required = 3.13
+placeholder = <string>

examples/mclaren_demo_app/appserver/static/advisor_shared.css

@@ -0,0 +1,158 @@
+:root {
+  --color-accent: #e8440a;
+  --color-bg: #111;
+  --color-border: #2a2a2a;
+  --color-border-subtle: #222;
+  --color-text: #e0e0e0;
+  --color-text-dim: #aaa;
+  --color-text-muted: #666;
+  --color-text-new: #fff;
+}
+
+body[data-tc-theme="light"] {
+  --color-bg: #f5f5f5;
+  --color-border: #d0d0d0;
+  --color-border-subtle: #e0e0e0;
+  --color-text: #1a1a1a;
+  --color-text-dim: #444;
+  --color-text-muted: #888;
+  --color-text-new: #000;
+}
+
+[id$="-panel"] {
+  display: flex;
+  flex-direction: column;
+  max-height: 75vh;
+  font-family: "Splunk Platform Sans", sans-serif;
+}
+
+[id$="-header"] {
+  display: flex;
+  flex-shrink: 0;
+  justify-content: space-between;
+  align-items: center;
+  padding: 10px 16px;
+  border-bottom: 1px solid var(--color-border);
+  background: var(--color-bg);
+  cursor: default;
+}
+
+.advisor-collapse-btn {
+  background: none;
+  border: none;
+  color: var(--color-text-muted);
+  font-size: 14px;
+  padding: 0 8px 0 0;
+  cursor: pointer;
+  line-height: 1;
+  transition: transform 0.2s ease;
+}
+
+.advisor-collapse-btn.collapsed {
+  transform: rotate(-90deg);
+}
+
+[id$="-feed"].collapsed {
+  display: none;
+}
+
+[id$="-header"] h1 {
+  font-size: 1em;
+  color: var(--color-text-dim);
+  letter-spacing: 2px;
+  text-transform: uppercase;
+}
+
+[id$="-feed"] {
+  padding: 12px 16px;
+  display: flex;
+  flex-direction: column;
+  overflow-y: auto;
+  flex: 1;
+  min-height: 0;
+  background: var(--color-bg);
+}
+
+[id$="-empty"] {
+  color: var(--color-text-muted);
+  text-align: center;
+  margin-top: 10px;
+  margin-bottom: 10px;
+  font-size: 12px;
+}
+
+[class$="-controls"] {
+  display: flex;
+  gap: 8px;
+  align-items: center;
+}
+
+.advisor-btn {
+  background: none;
+  border: 1px solid #333;
+  color: #666;
+  font-size: 11px;
+  padding: 3px 8px;
+  cursor: pointer;
+  letter-spacing: 1px;
+}
+
+.advisor-btn:hover {
+  border-color: #666;
+  color: #aaa;
+}
+
+.advisor-btn:disabled {
+  opacity: 0.3;
+  cursor: not-allowed;
+}
+
+.advisor-message {
+  padding: 10px 0;
+  border-bottom: 1px solid var(--color-border-subtle);
+  animation: advisor-fadein 0.3s ease;
+}
+
+.advisor-message:last-child {
+  border-bottom: none;
+}
+
+.advisor-message-header {
+  font-size: 10px;
+  color: var(--color-text-muted);
+  margin-bottom: 4px;
+  letter-spacing: 1px;
+}
+
+.advisor-label {
+  color: var(--color-accent);
+}
+
+.advisor-advice {
+  color: var(--color-text);
+  line-height: 1.5;
+  font-size: 14px;
+}
+
+.advisor-message.new .advisor-advice {
+  color: var(--color-text-new);
+}
+
+#dl-feed .advisor-advice {
+  font-family: monospace;
+  font-size: 12px;
+  white-space: pre-wrap;
+  word-break: break-all;
+}
+
+@keyframes advisor-fadein {
+  from {
+    opacity: 0;
+    transform: translateY(-4px);
+  }
+
+  to {
+    opacity: 1;
+    transform: translateY(0);
+  }
+}

examples/mclaren_demo_app/appserver/static/advisor_shared.js

@@ -0,0 +1,54 @@
+window.advisorShared = {
+    // Creates a message element. Pass time="" to omit the time span (e.g. debug log uses label=time).
+    createMessage({ label, time = "", advice }) {
+        const msgHeader = document.createElement("div");
+        msgHeader.className = "advisor-message-header";
+
+        const labelSpan = document.createElement("span");
+        labelSpan.className = "advisor-label";
+        labelSpan.textContent = label;
+        msgHeader.appendChild(labelSpan);
+
+        if (time) {
+            const timeSpan = document.createElement("span");
+            timeSpan.style.marginLeft = "8px";
+            timeSpan.textContent = time;
+            msgHeader.appendChild(timeSpan);
+        }
+
+        const adviceDiv = document.createElement("div");
+        adviceDiv.className = "advisor-advice";
+        adviceDiv.textContent = advice;
+
+        const msg = document.createElement("div");
+        msg.className = "advisor-message";
+        msg.appendChild(msgHeader);
+        msg.appendChild(adviceDiv);
+
+        return msg;
+    },
+
+    insertMessage(feed, emptyId, msg, isNew) {
+        document.getElementById(emptyId)?.remove();
+
+        if (isNew) {
+            msg.classList.add("new");
+            feed.prepend(msg);
+            setTimeout(() => msg.classList.remove("new"), 2000);
+        } else {
+            feed.append(msg);
+        }
+    },
+};
+
+require(["splunkjs/mvc/simplexml/ready!"], () => {
+    document.addEventListener("click", (e) => {
+        const btn = e.target.closest(".advisor-collapse-btn");
+        if (!btn) return;
+        const header = btn.closest("[id$='-header']");
+        const feed = header?.nextElementSibling;
+        if (!feed) return;
+        const collapsed = feed.classList.toggle("collapsed");
+        btn.classList.toggle("collapsed", collapsed);
+    });
+});