@agenthippo-ai/agenthippo 0.1.0

package/out/scripts/agentide-litellm.sh

@@ -0,0 +1,700 @@
+#!/usr/bin/env bash
+#
+# Starts LiteLLM via uv. By default installs litellm[proxy] from PyPI (pinned version).
+# Use --git or LITELLM_FROM_GIT=true to install from GitHub at DEFAULT_LITELLM_VERSION instead.
+# LITELLM_UV_WITH overrides both (space-separated uv --with package specs).
+
+set -euo pipefail
+
+# Prepend common tool install locations so uv is discoverable when this script
+# runs from a GUI-launched context (VS Code task, IDE-spawned Git Bash on
+# Windows) where the inherited PATH is minimal. Mirrors
+# extensions/agentide/src/utils/toolPath.ts.
+augment_path_for_tools() {
+    local extra
+    local candidates=(
+        "$HOME/.local/bin"
+        "$HOME/.cargo/bin"
+        "$HOME/.uv/bin"
+        "/opt/homebrew/bin"
+        "/usr/local/bin"
+        "/home/linuxbrew/.linuxbrew/bin"
+    )
+    # Git Bash / MSYS / Cygwin on Windows: add Windows-style install locations
+    # translated to unix paths (Git Bash mounts C: as /c, etc.).
+    case "${OSTYPE:-}" in
+        msys*|cygwin*|win32*)
+            if [ -n "${LOCALAPPDATA:-}" ]; then
+                local localappdata_unix
+                localappdata_unix="$(printf '%s' "$LOCALAPPDATA" | sed -e 's|\\|/|g' -e 's|^\([A-Za-z]\):|/\L\1|')"
+                candidates+=(
+                    "$localappdata_unix/Microsoft/WinGet/Links"
+                    "$localappdata_unix/Programs/uv"
+                )
+            fi
+            candidates+=(
+                "$HOME/scoop/shims"
+                "/c/Program Files/uv"
+            )
+            ;;
+    esac
+    for extra in "${candidates[@]}"; do
+        if [ -d "$extra" ] && [[ ":$PATH:" != *":$extra:"* ]]; then
+            PATH="$extra:$PATH"
+        fi
+    done
+    export PATH
+}
+augment_path_for_tools
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+DEFAULT_CONFIG_PATH="${SCRIPT_DIR}/analytics/agentide-litellm-otel.config.yaml"
+DEFAULT_LITELLM_VERSION="${DEFAULT_LITELLM_VERSION:-1.85.0}"
+# Resolve branded home dir from env first, then legacy fallbacks.
+AGENT_HOME_DIR="${AGENT_HOME_DIR:-${AGENTHIPPO_HOME:-$HOME/.agent-hippo}}"
+DEFAULT_ENV_FILE="${AGENT_HOME_DIR}/.env"
+DEFAULT_TLS_DIR="${AGENT_HOME_DIR}/litellm-tls"
+
+CONFIG_PATH="${LITELLM_CONFIG_PATH:-$DEFAULT_CONFIG_PATH}"
+ENV_FILE="${LITELLM_ENV_FILE:-$DEFAULT_ENV_FILE}"
+HOST="${LITELLM_HOST:-127.0.0.1}"
+
+STOP_MODE=false
+FROM_GIT_CLI=false
+SHOW_HELP=false
+EXTRA_ARGS=()
+
+while [[ $# -gt 0 ]]; do
+	case "$1" in
+		--stop)
+			STOP_MODE=true
+			shift
+			;;
+		--config)
+			CONFIG_PATH="$2"
+			shift 2
+			;;
+		--git)
+			FROM_GIT_CLI=true
+			shift
+			;;
+		--help|-h)
+			SHOW_HELP=true
+			shift
+			;;
+		*)
+			EXTRA_ARGS+=("$1")
+			shift
+			;;
+	esac
+done
+
+if [[ "$SHOW_HELP" == true ]]; then
+	cat <<EOF
+Usage: $(basename "$0") [options] [extra args passed to litellm...]
+
+Start the LiteLLM proxy using uv (https://docs.astral.sh/uv/).
+
+Options:
+  --config PATH  Config YAML (default: LITELLM_CONFIG_PATH or analytics/agentide-litellm-otel.config.yaml)
+  --stop         Stop using litellm.pid under AGENT_HOME_DIR
+  --git          Install litellm[proxy] from GitHub (tag from DEFAULT_LITELLM_VERSION; default ${DEFAULT_LITELLM_VERSION}) instead of PyPI
+  -h, --help     Show this help
+
+Environment (common):
+  DEFAULT_LITELLM_VERSION  PyPI version / git ref (default: ${DEFAULT_LITELLM_VERSION})
+  LITELLM_PYTHON_VERSION   Python version for uv (default: 3.12)
+  LITELLM_FROM_GIT         true to use GitHub install like --git (e.g. from .env)
+  LITELLM_UV_WITH          Overrides package source entirely (space-separated uv --with specs)
+EOF
+	exit 0
+fi
+
+normalize_bool() {
+	local value="${1:-false}"
+	value="$(printf '%s' "$value" | tr '[:upper:]' '[:lower:]')"
+	case "$value" in
+		1|true|yes|on) return 0 ;;
+		*) return 1 ;;
+	esac
+}
+
+get_windows_listener_pid() {
+	local port="$1"
+	if ! command -v powershell.exe >/dev/null 2>&1; then
+		return 1
+	fi
+
+	powershell.exe -NoProfile -Command "\$p = Get-NetTCPConnection -LocalPort ${port} -State Listen -ErrorAction SilentlyContinue | Select-Object -First 1 -ExpandProperty OwningProcess; if (\$p) { Write-Output \$p }" 2>/dev/null | tr -d '\r'
+}
+
+get_listener_pids() {
+	local port="$1"
+	local pids=""
+	if command -v lsof >/dev/null 2>&1; then
+		pids="$(lsof -tiTCP:"${port}" -sTCP:LISTEN 2>/dev/null || true)"
+	elif command -v fuser >/dev/null 2>&1; then
+		pids="$(fuser "${port}/tcp" 2>/dev/null || true)"
+	fi
+
+	if [[ -z "$pids" ]]; then
+		return 1
+	fi
+
+	printf '%s\n' $pids
+}
+
+port_in_use() {
+	local port="$1"
+	get_listener_pids "$port" >/dev/null 2>&1
+}
+
+process_cmdline() {
+	local pid="$1"
+	ps -p "$pid" -o command= 2>/dev/null || true
+}
+
+cmdline_matches_litellm() {
+	local cmdline="$1"
+	local config_path="$2"
+	local port="$3"
+
+	if [[ "$cmdline" != *litellm* ]]; then
+		return 1
+	fi
+
+	if [[ -n "$config_path" && "$cmdline" == *"$config_path"* ]]; then
+		return 0
+	fi
+
+	if [[ "$cmdline" =~ (^|[[:space:]])--port[[:space:]]+${port}([[:space:]]|$) ]]; then
+		return 0
+	fi
+
+	return 1
+}
+
+stop_litellm_pid() {
+	local pid="$1"
+	if [[ -z "$pid" ]]; then
+		return 1
+	fi
+	if ! kill -0 "$pid" 2>/dev/null; then
+		return 1
+	fi
+
+	echo "Stopping LiteLLM (PID: $pid)"
+	kill "$pid" 2>/dev/null || true
+	sleep 1
+	if kill -0 "$pid" 2>/dev/null; then
+		kill -9 "$pid" 2>/dev/null || true
+	fi
+	return 0
+}
+
+stop_litellm_matches() {
+	local config_path="$1"
+	local port="$2"
+	local stopped=1
+	local seen=" "
+
+	local pids
+	pids="$(pgrep -f "litellm" 2>/dev/null || true)"
+	for pid in $pids; do
+		if [[ "$pid" == "$$" || "$seen" == *" $pid "* ]]; then
+			continue
+		fi
+		local cmdline
+		cmdline="$(process_cmdline "$pid")"
+		if cmdline_matches_litellm "$cmdline" "$config_path" "$port"; then
+			seen="${seen}${pid} "
+			stop_litellm_pid "$pid" && stopped=0
+		fi
+	done
+
+	pids="$(get_listener_pids "$port" 2>/dev/null || true)"
+	for pid in $pids; do
+		if [[ "$pid" == "$$" || "$seen" == *" $pid "* ]]; then
+			continue
+		fi
+		local cmdline
+		cmdline="$(process_cmdline "$pid")"
+		if cmdline_matches_litellm "$cmdline" "$config_path" "$port"; then
+			seen="${seen}${pid} "
+			stop_litellm_pid "$pid" && stopped=0
+		fi
+	done
+
+	return "$stopped"
+}
+
+ensure_mkcert() {
+	if command -v mkcert >/dev/null 2>&1; then
+		return 0
+	fi
+
+	echo "mkcert not found. Attempting to install..." >&2
+	if command -v brew >/dev/null 2>&1; then
+		echo "Installing mkcert via Homebrew (may prompt for password)..." >&2
+		if brew list mkcert >/dev/null 2>&1; then
+			brew upgrade mkcert
+		else
+			brew install mkcert
+		fi
+	else
+		echo "Homebrew not found. Please install mkcert manually: https://github.com/FiloSottile/mkcert" >&2
+		exit 1
+	fi
+
+	if ! command -v mkcert >/dev/null 2>&1; then
+		echo "mkcert installation failed. Install manually and re-run." >&2
+		exit 1
+	fi
+}
+
+if normalize_bool "${LITELLM_ENABLE_TLS:-false}"; then
+	DEFAULT_PORT=4443
+	TLS_ENABLED=true
+else
+	DEFAULT_PORT=4000
+	TLS_ENABLED=false
+fi
+
+PORT="${LITELLM_PORT:-$DEFAULT_PORT}"
+SCHEME=$([[ "$TLS_ENABLED" == true ]] && echo "https" || echo "http")
+TLS_CERT="${LITELLM_TLS_CERT:-${DEFAULT_TLS_DIR}/localhost.pem}"
+TLS_KEY="${LITELLM_TLS_KEY:-${DEFAULT_TLS_DIR}/localhost-key.pem}"
+LITELLM_URL="${SCHEME}://${HOST}:${PORT}"
+
+if [[ -f "$ENV_FILE" ]]; then
+	echo "Loading environment variables from ${ENV_FILE}"
+	set -a
+	# shellcheck disable=SC1090
+	source "$ENV_FILE"
+	set +a
+fi
+
+if [[ "$STOP_MODE" == true ]]; then
+	PID_FILE="${AGENT_HOME_DIR}/litellm.pid"
+	STOP_CONFIG_PATH="$CONFIG_PATH"
+	STOPPED=false
+	if [[ -f "$PID_FILE" ]]; then
+		while IFS= read -r line; do
+			if [[ "$line" == config=* ]]; then
+				STOP_CONFIG_PATH="${line#config=}"
+				break
+			fi
+		done < "$PID_FILE"
+	fi
+	if [[ -f "$PID_FILE" ]]; then
+		PID=$(head -n 1 "$PID_FILE" | tr -d "\r")
+		if [[ -n "$PID" ]]; then
+			if [[ -d "/proc/${PID}" ]]; then
+				stop_litellm_pid "$PID" && STOPPED=true || true
+			elif command -v taskkill.exe >/dev/null 2>&1; then
+				echo "Stopping LiteLLM (PID: $PID)"
+				taskkill.exe /PID "$PID" /T /F >/dev/null 2>&1 || true
+				STOPPED=true
+			else
+				stop_litellm_pid "$PID" && STOPPED=true || true
+			fi
+		fi
+		rm -f "$PID_FILE" 2>/dev/null || true
+	fi
+
+	if stop_litellm_matches "$STOP_CONFIG_PATH" "$PORT"; then
+		STOPPED=true
+		rm -f "$PID_FILE" 2>/dev/null || true
+		exit 0
+	fi
+
+	if [[ "$STOPPED" == false ]]; then
+		echo "LiteLLM PID file not found. Nothing to stop."
+	fi
+	exit 0
+fi
+
+if [[ "$TLS_ENABLED" == true ]]; then
+	mkdir -p "$DEFAULT_TLS_DIR"
+	if [[ ! -f "$TLS_CERT" || ! -f "$TLS_KEY" ]]; then
+		ensure_mkcert
+		echo "Generating development TLS certificate via mkcert at ${DEFAULT_TLS_DIR}"
+		mkcert -install >/dev/null 2>&1 || true
+		mkcert -cert-file "$TLS_CERT" -key-file "$TLS_KEY" localhost 127.0.0.1 ::1
+	fi
+fi
+
+if [[ ! -f "$CONFIG_PATH" ]]; then
+	echo "LiteLLM config not found at ${CONFIG_PATH}. Update LITELLM_CONFIG_PATH or create the file." >&2
+	exit 1
+fi
+
+# LiteLLM 1.85+ resolves custom callback modules beside the config file (not only PYTHONPATH).
+sync_agentide_litellm_hooks_beside_config() {
+	local config_dir="$1"
+	local hooks_src="${SCRIPT_DIR}/agentide_litellm_hooks_v1.py"
+	local hooks_dest="${config_dir}/agentide_litellm_hooks_v1.py"
+	if [[ ! -f "$hooks_src" ]]; then
+		return 0
+	fi
+	if ! grep -q 'agentide_litellm_hooks_v1' "$CONFIG_PATH"; then
+		return 0
+	fi
+	if [[ ! -f "$hooks_dest" ]] || ! cmp -s "$hooks_src" "$hooks_dest"; then
+		cp "$hooks_src" "$hooks_dest"
+	fi
+}
+sync_agentide_litellm_hooks_beside_config "$(dirname "$CONFIG_PATH")"
+
+# User-owned ~/.agent-hippo/litellm-otel.yaml is not auto-replaced; merge required proxy callbacks.
+ensure_codex_proxy_callback_in_config() {
+	local template="${SCRIPT_DIR}/analytics/agentide-litellm-otel.config.yaml"
+	if [[ ! -f "$CONFIG_PATH" ]] || [[ ! -f "$template" ]]; then
+		return 0
+	fi
+	if ! grep -q 'agentide_litellm_hooks_v1' "$CONFIG_PATH"; then
+		return 0
+	fi
+	if grep -q 'codex_proxy_sanitizer' "$CONFIG_PATH"; then
+		return 0
+	fi
+	local template_callbacks
+	template_callbacks="$(grep -E '^[[:space:]]*callbacks:' "$template" | tail -1)"
+	if [[ -z "$template_callbacks" ]]; then
+		return 0
+	fi
+	local tmp_config="${CONFIG_PATH}.tmp.$$"
+	if ! grep -E '^[[:space:]]*callbacks:' "$CONFIG_PATH" >/dev/null; then
+		return 0
+	fi
+	awk -v repl="$template_callbacks" '
+		/^[[:space:]]*callbacks:/ { print repl; next }
+		{ print }
+	' "$CONFIG_PATH" >"$tmp_config" && mv "$tmp_config" "$CONFIG_PATH"
+	echo "  config : patched callbacks (added codex_proxy_sanitizer)"
+}
+ensure_codex_proxy_callback_in_config
+
+stop_litellm_matches "$CONFIG_PATH" "$PORT" || true
+sleep 1
+if port_in_use "$PORT"; then
+	echo "LiteLLM port ${PORT} is still in use. Stop the existing process and retry." >&2
+	exit 1
+fi
+
+CHILD_PATH_SEP=':'
+SHELL_AGENT_HOME_DIR="$AGENT_HOME_DIR"
+CHILD_AGENT_HOME_DIR="$AGENT_HOME_DIR"
+CHILD_CONFIG_PATH="$CONFIG_PATH"
+CHILD_SCRIPT_DIR="$SCRIPT_DIR"
+CHILD_TLS_CERT="$TLS_CERT"
+CHILD_TLS_KEY="$TLS_KEY"
+if command -v cygpath >/dev/null 2>&1; then
+	case "$(uname -s)" in
+		MINGW*|MSYS*|CYGWIN*)
+			CHILD_PATH_SEP=';'
+			CHILD_AGENT_HOME_DIR="$(cygpath -w "$AGENT_HOME_DIR")"
+			CHILD_CONFIG_PATH="$(cygpath -w "$CONFIG_PATH")"
+			CHILD_SCRIPT_DIR="$(cygpath -w "$SCRIPT_DIR")"
+			if [[ -n "$TLS_CERT" ]]; then
+				CHILD_TLS_CERT="$(cygpath -w "$TLS_CERT")"
+			fi
+			if [[ -n "$TLS_KEY" ]]; then
+				CHILD_TLS_KEY="$(cygpath -w "$TLS_KEY")"
+			fi
+			;;
+	esac
+fi
+
+if grep -q 'OPENAI_API_KEY' "$CONFIG_PATH" && [[ -z "${OPENAI_API_KEY:-}" ]]; then
+	echo "OPENAI_API_KEY is not set but the config references it. Export OPENAI_API_KEY before running this script." >&2
+	exit 1
+fi
+
+LANGFUSE_CALLBACK_PRESENT=false
+LANGFUSE_SHOULD_INSTALL=false
+AGENTOPS_CALLBACK_PRESENT=false
+AGENTOPS_SHOULD_INSTALL=false
+OTEL_CALLBACK_PRESENT=false
+OTEL_SHOULD_INSTALL=false
+
+# Check Langfuse configuration if callbacks include langfuse
+if grep -q 'callbacks.*langfuse' "$CONFIG_PATH" || grep -q 'callbacks:.*\[.*langfuse' "$CONFIG_PATH"; then
+	LANGFUSE_CALLBACK_PRESENT=true
+	if normalize_bool "${LITELLM_DISABLE_LANGFUSE:-false}"; then
+		echo "  langfuse: disabled (LITELLM_DISABLE_LANGFUSE=true)"
+	else
+		LANGFUSE_SHOULD_INSTALL=true
+		if [[ -z "${LANGFUSE_SECRET_KEY:-}" ]] || [[ -z "${LANGFUSE_PUBLIC_KEY:-}" ]]; then
+			echo ""
+			echo "⚠️  Langfuse is enabled but credentials are missing!" >&2
+			echo "   Set LANGFUSE_SECRET_KEY and LANGFUSE_PUBLIC_KEY in ${ENV_FILE}" >&2
+			echo "   Or use cloud.langfuse.com to get your keys." >&2
+			echo "   See scripts/LANGFUSE_SETUP.md for setup instructions." >&2
+			echo ""
+			echo "   To disable Langfuse, set LITELLM_DISABLE_LANGFUSE=true" >&2
+			echo "   or comment out 'callbacks: [\"langfuse\"]' in the config." >&2
+			echo ""
+		else
+			LANGFUSE_HOST="${LANGFUSE_HOST:-https://cloud.langfuse.com}"
+			echo "  langfuse: enabled (${LANGFUSE_HOST})"
+		fi
+	fi
+fi
+
+# Check OpenTelemetry configuration if callbacks include otel
+if grep -q 'callbacks.*otel' "$CONFIG_PATH" || grep -q 'callbacks:.*\[.*otel' "$CONFIG_PATH"; then
+	OTEL_CALLBACK_PRESENT=true
+	if normalize_bool "${LITELLM_DISABLE_OTEL:-false}"; then
+		echo "  otel: disabled (LITELLM_DISABLE_OTEL=true)"
+	else
+		OTEL_SHOULD_INSTALL=true
+		echo "  otel: enabled"
+	fi
+fi
+
+# Provide OTEL defaults when OTEL callback is enabled
+if [[ "$OTEL_SHOULD_INSTALL" == true ]]; then
+	: "${OTEL_EXPORTER:=otlp_http}"
+	: "${OTEL_EXPORTER_OTLP_ENDPOINT:=http://localhost:4318}"
+	# Reduce Python OTEL SDK batch delay for faster trace visibility (default: 5000ms)
+	: "${OTEL_BSP_SCHEDULE_DELAY:=500}"
+	export OTEL_EXPORTER
+	export OTEL_EXPORTER_OTLP_ENDPOINT
+	export OTEL_BSP_SCHEDULE_DELAY
+fi
+
+# Check AgentOps configuration if callbacks include agentops
+if grep -q 'callbacks.*agentops' "$CONFIG_PATH" || grep -q 'callbacks:.*\[.*agentops' "$CONFIG_PATH"; then
+	AGENTOPS_CALLBACK_PRESENT=true
+	if normalize_bool "${LITELLM_DISABLE_AGENTOPS:-false}"; then
+		echo "  agentops: disabled (LITELLM_DISABLE_AGENTOPS=true)"
+	else
+		AGENTOPS_SHOULD_INSTALL=true
+		if [[ -z "${AGENTOPS_API_KEY:-}" ]]; then
+			echo ""
+			echo "⚠️  AgentOps callback is enabled but AGENTOPS_API_KEY is missing!" >&2
+			echo "   Set AGENTOPS_API_KEY in ${ENV_FILE} (or export it) before running the proxy." >&2
+			echo ""
+		else
+			echo "  agentops: enabled"
+		fi
+	fi
+fi
+
+if ! command -v uv >/dev/null 2>&1; then
+	echo "uv (https://docs.astral.sh/uv/) is required. Install with 'brew install uv' or follow the official instructions." >&2
+	exit 1
+fi
+
+# Default to Python 3.12 for deterministic dependency resolution (e.g. mcp.types support).
+LITELLM_PYTHON_VERSION="${LITELLM_PYTHON_VERSION:-3.12}"
+UV_ARGS=()
+if [[ -n "${LITELLM_PYTHON_VERSION:-}" ]]; then
+	UV_ARGS+=(--python "${LITELLM_PYTHON_VERSION}")
+fi
+
+LITELLM_PACKAGE_SOURCE="pypi"
+if [[ -n "${LITELLM_UV_WITH:-}" ]]; then
+	read -r -a UV_WITH_ARRAY <<<"${LITELLM_UV_WITH}"
+	LITELLM_PACKAGE_SOURCE="custom (LITELLM_UV_WITH)"
+elif [[ "$FROM_GIT_CLI" == true ]] || normalize_bool "${LITELLM_FROM_GIT:-false}"; then
+	UV_WITH_ARRAY=("litellm[proxy] @ git+https://github.com/BerriAI/litellm.git@${DEFAULT_LITELLM_VERSION}")
+	LITELLM_PACKAGE_SOURCE="git @ ${DEFAULT_LITELLM_VERSION}"
+else
+	UV_WITH_ARRAY=("litellm[proxy]==${DEFAULT_LITELLM_VERSION}")
+	LITELLM_PACKAGE_SOURCE="pypi ==${DEFAULT_LITELLM_VERSION}"
+fi
+
+if [[ "$LANGFUSE_SHOULD_INSTALL" == true ]]; then
+	LANGFUSE_SPEC="${LITELLM_LANGFUSE_SPEC:-langfuse>=2.60.10,<3.0.0}"
+	HAS_LANGFUSE_SPEC=false
+	for pkg in "${UV_WITH_ARRAY[@]}"; do
+		if [[ "$pkg" == langfuse* ]]; then
+			HAS_LANGFUSE_SPEC=true
+			break
+		fi
+	done
+	if [[ "$HAS_LANGFUSE_SPEC" == false ]]; then
+		UV_WITH_ARRAY+=("$LANGFUSE_SPEC")
+	fi
+fi
+
+# Install OpenTelemetry packages if otel callback is enabled
+# All OpenTelemetry packages must be at compatible versions to avoid import errors
+if [[ "$OTEL_SHOULD_INSTALL" == true ]] || [[ "$AGENTOPS_SHOULD_INSTALL" == true ]]; then
+	# Use compatible versions - all OpenTelemetry packages should be at the same version
+	OTEL_VERSION="${LITELLM_OTEL_VERSION:-1.25.0}"
+	OTEL_API_SPEC="${LITELLM_OTEL_API_SPEC:-opentelemetry-api>=${OTEL_VERSION},<2.0.0}"
+	OTEL_SDK_SPEC="${LITELLM_OTEL_SDK_SPEC:-opentelemetry-sdk>=${OTEL_VERSION},<2.0.0}"
+	OTEL_EXPORTER_OTLP_GRPC_SPEC="${LITELLM_OTEL_EXPORTER_OTLP_GRPC_SPEC:-opentelemetry-exporter-otlp-proto-grpc>=${OTEL_VERSION},<2.0.0}"
+	OTEL_EXPORTER_OTLP_HTTP_SPEC="${LITELLM_OTEL_EXPORTER_OTLP_HTTP_SPEC:-opentelemetry-exporter-otlp-proto-http>=${OTEL_VERSION},<2.0.0}"
+
+	HAS_OTEL_API=false
+	HAS_OTEL_SDK=false
+	HAS_OTEL_EXPORTER_GRPC=false
+	HAS_OTEL_EXPORTER_HTTP=false
+
+	for pkg in "${UV_WITH_ARRAY[@]}"; do
+		if [[ "$pkg" == opentelemetry-api* ]]; then
+			HAS_OTEL_API=true
+		fi
+		if [[ "$pkg" == opentelemetry-sdk* ]]; then
+			HAS_OTEL_SDK=true
+		fi
+		if [[ "$pkg" == opentelemetry-exporter-otlp-proto-grpc* ]]; then
+			HAS_OTEL_EXPORTER_GRPC=true
+		fi
+		if [[ "$pkg" == opentelemetry-exporter-otlp-proto-http* ]]; then
+			HAS_OTEL_EXPORTER_HTTP=true
+		fi
+	done
+
+	if [[ "$HAS_OTEL_API" == false ]]; then
+		UV_WITH_ARRAY+=("$OTEL_API_SPEC")
+	fi
+	if [[ "$HAS_OTEL_SDK" == false ]]; then
+		UV_WITH_ARRAY+=("$OTEL_SDK_SPEC")
+	fi
+	if [[ "$HAS_OTEL_EXPORTER_GRPC" == false ]]; then
+		UV_WITH_ARRAY+=("$OTEL_EXPORTER_OTLP_GRPC_SPEC")
+	fi
+	if [[ "$HAS_OTEL_EXPORTER_HTTP" == false ]]; then
+		UV_WITH_ARRAY+=("$OTEL_EXPORTER_OTLP_HTTP_SPEC")
+	fi
+fi
+
+if [[ "$AGENTOPS_SHOULD_INSTALL" == true ]]; then
+	AGENTOPS_SPEC="${LITELLM_AGENTOPS_SPEC:-agentops>=0.3.0}"
+	HAS_AGENTOPS_SPEC=false
+	for pkg in "${UV_WITH_ARRAY[@]}"; do
+		if [[ "$pkg" == agentops* ]]; then
+			HAS_AGENTOPS_SPEC=true
+			break
+		fi
+	done
+	if [[ "$HAS_AGENTOPS_SPEC" == false ]]; then
+		UV_WITH_ARRAY+=("$AGENTOPS_SPEC")
+	fi
+fi
+
+UV_WITH_DISPLAY="${UV_WITH_ARRAY[*]}"
+
+# Enable logging of prompts and responses (INFO level to avoid streaming chunk noise)
+export LITELLM_LOG="${LITELLM_LOG:-INFO}"
+export PYTHONIOENCODING="${PYTHONIOENCODING:-utf-8}"
+export PYTHONUTF8="${PYTHONUTF8:-1}"
+export AGENT_HOME_DIR="${CHILD_AGENT_HOME_DIR}"
+export LITELLM_CONFIG_PATH="${CHILD_CONFIG_PATH}"
+
+# Add scripts directory to PYTHONPATH so custom hooks can be imported.
+# Native Windows Python expects Windows-style paths and ';' separators.
+CHILD_PYTHONPATH="${CHILD_SCRIPT_DIR}${CHILD_PATH_SEP}${CHILD_AGENT_HOME_DIR}"
+if [[ -n "${PYTHONPATH:-}" ]]; then
+	CHILD_PYTHONPATH="${CHILD_PYTHONPATH}${CHILD_PATH_SEP}${PYTHONPATH}"
+fi
+export PYTHONPATH="${CHILD_PYTHONPATH}"
+
+# When uv runs while a conda env is active, it can pick the conda interpreter
+# instead of the resolved UV_PYTHON, leading to non-deterministic dependency resolution.
+strip_conda_activation() {
+	local conda_vars=(
+		CONDA_DEFAULT_ENV
+		CONDA_EXE
+		CONDA_PREFIX
+		CONDA_PROMPT_MODIFIER
+		CONDA_PYTHON_EXE
+		CONDA_SHLVL
+		_CONDA_EXE
+		_CONDA_ROOT
+		__CONDA_OPENSLL_CERT_FILE_SET
+		_CE_CONDA
+		_CE_M
+	)
+	local had_conda=false
+	for name in "${conda_vars[@]}"; do
+		if [[ -n "${!name:-}" ]]; then
+			had_conda=true
+			unset "$name"
+		fi
+	done
+	if [[ "$had_conda" == true ]]; then
+		echo "  env    : cleared active conda variables for deterministic uv Python selection"
+	fi
+}
+
+strip_conda_activation
+
+echo "Starting LiteLLM proxy on ${SCHEME}://${HOST}:${PORT}"
+echo "  config : ${CONFIG_PATH}"
+echo "  host   : ${HOST}"
+echo "  port   : ${PORT}"
+echo "  package: ${LITELLM_PACKAGE_SOURCE}"
+echo "  extras : ${EXTRA_ARGS[*]:-}"
+echo "  uv deps: ${UV_WITH_DISPLAY}"
+if [[ "$TLS_ENABLED" == true ]]; then
+	echo "  tls    : enabled (${TLS_CERT})"
+else
+	echo "  tls    : disabled (set LITELLM_ENABLE_TLS=true to enable)"
+fi
+echo "  logging: ${LITELLM_LOG} (set LITELLM_LOG=INFO to reduce verbosity)"
+
+UV_RUN_CMD=(uv run)
+if [[ ${#UV_ARGS[@]} -gt 0 ]]; then
+	UV_RUN_CMD+=("${UV_ARGS[@]}")
+fi
+LITELLM_ARGS=(--host "${HOST}" --port "${PORT}" --config "${CHILD_CONFIG_PATH}")
+if [[ "$TLS_ENABLED" == true ]]; then
+	LITELLM_ARGS+=(--ssl_certfile_path "${CHILD_TLS_CERT}" --ssl_keyfile_path "${CHILD_TLS_KEY}")
+fi
+for pkg in "${UV_WITH_ARRAY[@]}"; do
+	UV_RUN_CMD+=(--with "$pkg")
+done
+UV_RUN_CMD+=(-- litellm "${LITELLM_ARGS[@]}")
+
+# Start LiteLLM in the background so we can write a PID file with metadata.
+# Then wait on it to preserve foreground behavior.
+mkdir -p "$SHELL_AGENT_HOME_DIR"
+PID_FILE="${SHELL_AGENT_HOME_DIR}/litellm.pid"
+PREEXISTING_LISTENER_PID="$(get_windows_listener_pid "${PORT}" || true)"
+
+if [[ ${#EXTRA_ARGS[@]} -gt 0 ]]; then
+	"${UV_RUN_CMD[@]}" "${EXTRA_ARGS[@]}" &
+else
+	"${UV_RUN_CMD[@]}" &
+fi
+LITELLM_PID=$!
+PID_FILE_PID="$LITELLM_PID"
+if [[ -f "/proc/${LITELLM_PID}/winpid" ]]; then
+	WINPID=$(tr -d "\r\n" < "/proc/${LITELLM_PID}/winpid")
+	if [[ -n "$WINPID" ]]; then
+		PID_FILE_PID="$WINPID"
+	fi
+
+	for _ in {1..10}; do
+		LISTENER_PID="$(get_windows_listener_pid "${PORT}" || true)"
+		if [[ -n "$LISTENER_PID" && "$LISTENER_PID" != "$PREEXISTING_LISTENER_PID" ]]; then
+			PID_FILE_PID="$LISTENER_PID"
+			break
+		fi
+		sleep 1
+	done
+fi
+
+PID_LINES=("${PID_FILE_PID}")
+if [[ "$OTEL_SHOULD_INSTALL" == true ]] || [[ "$OTEL_CALLBACK_PRESENT" == true ]]; then
+	PID_LINES+=("otel")
+fi
+PID_LINES+=("url=${LITELLM_URL}")
+PID_LINES+=("config=${CHILD_CONFIG_PATH}")
+printf '%s\n' "${PID_LINES[@]}" > "$PID_FILE"
+
+cleanup() {
+	kill -TERM "$LITELLM_PID" 2>/dev/null || true
+}
+trap cleanup INT TERM
+
+wait "$LITELLM_PID"
+EXIT_CODE=$?
+rm -f "$PID_FILE" 2>/dev/null || true
+exit "$EXIT_CODE"