hydro-ai-helper 1.8.5

package/src/services/versionService.ts

@@ -0,0 +1,351 @@
+/**
+ * Version Service - 版本检测服务
+ *
+ * 提供插件版本检测功能：
+ * - 获取当前安装版本
+ * - 同时从 Gitee 和 GitHub 仓库检查最新版本
+ * - 取两个仓库中更新的版本为准
+ * - 语义化版本比较
+ * - 24 小时缓存机制
+ */
+
+import axios from 'axios';
+import { VersionCacheModel, type VersionCache, VERSION_CACHE_TTL_MS } from '../models/versionCache';
+
+/**
+ * 仓库配置（按优先级排序）
+ */
+const REPO_CONFIGS = [
+  {
+    name: 'Gitee',
+    owner: 'alture',
+    repo: 'hydro-ai-helper',
+    branch: 'main',
+    packageJsonUrl: 'https://gitee.com/alture/hydro-ai-helper/raw/main/package.json',
+    releasesUrl: 'https://gitee.com/alture/hydro-ai-helper/releases'
+  },
+  {
+    name: 'GitHub',
+    owner: 'AltureT',
+    repo: 'hydro-ai-helper',
+    branch: 'main',
+    packageJsonUrl: 'https://raw.githubusercontent.com/AltureT/hydro-ai-helper/main/package.json',
+    releasesUrl: 'https://github.com/AltureT/hydro-ai-helper/releases'
+  }
+];
+
+/**
+ * 单个仓库的版本信息
+ */
+interface RepoVersionInfo {
+  name: string;
+  version: string;
+  releasesUrl: string;
+  latency: number;
+}
+
+/**
+ * 版本检查结果接口
+ */
+export interface VersionCheckResult {
+  currentVersion: string;
+  latestVersion: string;
+  hasUpdate: boolean;
+  releaseUrl: string;
+  releaseNotes?: string;
+  checkedAt: Date;
+  fromCache: boolean;
+  source?: string;  // 版本来源（Gitee/GitHub）
+}
+
+/**
+ * 版本服务类
+ */
+export class VersionService {
+  private versionCacheModel: VersionCacheModel;
+  private currentVersion: string;
+  private static CACHE_KEY = 'latest_version';
+
+  constructor(versionCacheModel: VersionCacheModel) {
+    this.versionCacheModel = versionCacheModel;
+    // 从 package.json 读取当前版本（编译时嵌入）
+    this.currentVersion = this.readCurrentVersion();
+  }
+
+  /**
+   * T047: 获取当前安装版本
+   * @returns 当前版本号字符串
+   */
+  getCurrentVersion(): string {
+    return this.currentVersion;
+  }
+
+  /**
+   * 从 package.json 读取当前版本
+   * 在运行时使用 require 读取
+   */
+  private readCurrentVersion(): string {
+    try {
+      // 尝试从插件���录读取 package.json
+      // eslint-disable-next-line @typescript-eslint/no-var-requires
+      const pkg = require('../../package.json');
+      return pkg.version || '0.0.0';
+    } catch (err) {
+      console.error('[VersionService] Failed to read package.json:', err);
+      return '0.0.0';
+    }
+  }
+
+  /**
+   * 从单个仓库获取版本信息
+   * @param config 仓库配置
+   * @returns 版本信息或 null（失败时）
+   */
+  private async fetchVersionFromRepo(config: typeof REPO_CONFIGS[0]): Promise<RepoVersionInfo | null> {
+    const startTime = Date.now();
+    try {
+      const response = await axios.get(config.packageJsonUrl, {
+        timeout: 10000,
+        headers: {
+          'Accept': 'application/json'
+        }
+      });
+
+      const latency = Date.now() - startTime;
+      const packageJson = response.data;
+
+      let version: string;
+      if (typeof packageJson === 'object' && packageJson.version) {
+        version = packageJson.version;
+      } else if (typeof packageJson === 'string') {
+        const parsed = JSON.parse(packageJson);
+        version = parsed.version || '0.0.0';
+      } else {
+        return null;
+      }
+
+      return {
+        name: config.name,
+        version,
+        releasesUrl: config.releasesUrl,
+        latency
+      };
+    } catch (err) {
+      console.error(`[VersionService] Failed to fetch from ${config.name}:`, err);
+      return null;
+    }
+  }
+
+  /**
+   * 从所有仓库获取版本，取最新的
+   * @returns 最新版本信息
+   */
+  private async fetchLatestVersionFromAllRepos(): Promise<{
+    version: string;
+    source: string;
+    releasesUrl: string;
+  }> {
+    console.log('[VersionService] Checking versions from all repositories...');
+
+    // 并行获取所有仓库的版本
+    const results = await Promise.all(
+      REPO_CONFIGS.map(config => this.fetchVersionFromRepo(config))
+    );
+
+    // 过滤掉失败的结果
+    const validResults = results.filter((r): r is RepoVersionInfo => r !== null);
+
+    if (validResults.length === 0) {
+      throw new Error('All repositories failed to respond');
+    }
+
+    // 打印获取到的版本
+    for (const result of validResults) {
+      console.log(`[VersionService] ${result.name}: v${result.version} (${result.latency}ms)`);
+    }
+
+    // 找出最新版本
+    let latest = validResults[0];
+    for (let i = 1; i < validResults.length; i++) {
+      if (this.isNewerVersion(validResults[i].version, latest.version)) {
+        latest = validResults[i];
+      }
+    }
+
+    console.log(`[VersionService] Latest version: v${latest.version} from ${latest.name}`);
+
+    return {
+      version: latest.version,
+      source: latest.name,
+      releasesUrl: latest.releasesUrl
+    };
+  }
+
+  /**
+   * T048: 从仓库检查最新版本
+   * @param forceRefresh 是否强制刷新（忽略缓存）
+   * @returns 版本检查结果
+   */
+  async checkForUpdates(forceRefresh = false): Promise<VersionCheckResult> {
+    // T050: 检查缓存
+    if (!forceRefresh) {
+      const cached = await this.getCachedVersion();
+      if (cached) {
+        return {
+          currentVersion: this.currentVersion,
+          latestVersion: cached.latestVersion,
+          hasUpdate: cached.hasUpdate,
+          releaseUrl: cached.releaseUrl || REPO_CONFIGS[0].releasesUrl,
+          releaseNotes: cached.releaseNotes,
+          checkedAt: cached.checkedAt,
+          fromCache: true,
+          source: (cached as any).source
+        };
+      }
+    }
+
+    // 从所有仓库获取最新版本
+    try {
+      const { version: latestVersion, source, releasesUrl } = await this.fetchLatestVersionFromAllRepos();
+      const hasUpdate = this.isNewerVersion(latestVersion, this.currentVersion);
+
+      // 更新缓存
+      await this.updateCache({
+        currentVersion: this.currentVersion,
+        latestVersion,
+        hasUpdate,
+        releaseUrl: releasesUrl,
+        source
+      });
+
+      return {
+        currentVersion: this.currentVersion,
+        latestVersion,
+        hasUpdate,
+        releaseUrl: releasesUrl,
+        checkedAt: new Date(),
+        fromCache: false,
+        source
+      };
+    } catch (err) {
+      console.error('[VersionService] Failed to check for updates:', err);
+
+      // 如果请求失败，尝试返回过期的缓存数据
+      const expiredCache = await this.versionCacheModel.get(VersionService.CACHE_KEY);
+      if (expiredCache) {
+        return {
+          currentVersion: this.currentVersion,
+          latestVersion: expiredCache.latestVersion,
+          hasUpdate: expiredCache.hasUpdate,
+          releaseUrl: expiredCache.releaseUrl || REPO_CONFIGS[0].releasesUrl,
+          checkedAt: expiredCache.checkedAt,
+          fromCache: true,
+          source: (expiredCache as any).source
+        };
+      }
+
+      // 完全失败时返回无更新
+      return {
+        currentVersion: this.currentVersion,
+        latestVersion: this.currentVersion,
+        hasUpdate: false,
+        releaseUrl: REPO_CONFIGS[0].releasesUrl,
+        checkedAt: new Date(),
+        fromCache: false
+      };
+    }
+  }
+
+  /**
+   * T049: 语义化版本比较
+   * 判断 version1 是否比 version2 新
+   * @param version1 待比较版本
+   * @param version2 基准版本
+   * @returns true 如果 version1 > version2
+   */
+  isNewerVersion(version1: string, version2: string): boolean {
+    const v1Parts = this.parseVersion(version1);
+    const v2Parts = this.parseVersion(version2);
+
+    for (let i = 0; i < 3; i++) {
+      if (v1Parts[i] > v2Parts[i]) return true;
+      if (v1Parts[i] < v2Parts[i]) return false;
+    }
+
+    return false;  // 版本相同
+  }
+
+  /**
+   * 解析版本号为数字数组
+   * @param version 版本字符串（如 "1.2.3"）
+   * @returns [major, minor, patch]
+   */
+  private parseVersion(version: string): [number, number, number] {
+    // 移除前缀 v 或 V
+    const clean = version.replace(/^[vV]/, '');
+
+    // 移除预发布标签（如 -beta.1）
+    const base = clean.split('-')[0];
+
+    // 解析主版本号
+    const parts = base.split('.').map(p => parseInt(p, 10) || 0);
+
+    return [
+      parts[0] || 0,
+      parts[1] || 0,
+      parts[2] || 0
+    ];
+  }
+
+  /**
+   * T050: 获取缓存的版本信息（24小时有效）
+   * @returns 缓存数据或 null
+   */
+  private async getCachedVersion(): Promise<VersionCache | null> {
+    const cache = await this.versionCacheModel.get(VersionService.CACHE_KEY);
+
+    if (!cache) {
+      return null;
+    }
+
+    // 检查缓存是否在 TTL 内
+    const now = new Date().getTime();
+    const checkedAt = new Date(cache.checkedAt).getTime();
+
+    if (now - checkedAt > VERSION_CACHE_TTL_MS) {
+      return null;  // 缓存过期
+    }
+
+    return cache;
+  }
+
+  /**
+   * 更新版本缓存
+   * @param data 版本数据
+   */
+  private async updateCache(data: {
+    currentVersion: string;
+    latestVersion: string;
+    hasUpdate: boolean;
+    releaseUrl?: string;
+    releaseNotes?: string;
+    source?: string;
+  }): Promise<void> {
+    await this.versionCacheModel.set({
+      key: VersionService.CACHE_KEY,
+      currentVersion: data.currentVersion,
+      latestVersion: data.latestVersion,
+      hasUpdate: data.hasUpdate,
+      releaseUrl: data.releaseUrl,
+      releaseNotes: data.releaseNotes,
+      checkedAt: new Date()
+    });
+  }
+
+  /**
+   * 清除版本缓存（用于测试或强制刷新）
+   */
+  async clearCache(): Promise<void> {
+    await this.versionCacheModel.delete(VersionService.CACHE_KEY);
+  }
+}

package/src/types/hydrooj-extensions.d.ts

@@ -0,0 +1,55 @@
+/**
+ * HydroOJ 扩展类型定义
+ * 补充 hydrooj 包中未完整导出的类型
+ */
+
+declare module 'hydrooj' {
+  /**
+   * 题目文档接口（简化版）
+   */
+  export interface ProblemDoc {
+    _id: import('mongodb').ObjectId;
+    docType: 10;
+    docId: number;
+    pid: string;
+    domainId: string;
+    title: string;
+    content: string | Record<string, string>;
+    owner: number;
+    nSubmit?: number;
+    nAccept?: number;
+    difficulty?: number;
+    tag?: string[];
+    hidden?: boolean;
+    html?: boolean;
+  }
+
+  /**
+   * ProblemModel 类型定义
+   */
+  export const ProblemModel: {
+    /**
+     * 获取题目
+     * @param domainId 域 ID
+     * @param pid 题目 ID（数字或字符串）
+     * @param projection 投影字段（可选）
+     */
+    get(
+      domainId: string,
+      pid: string | number,
+      projection?: (keyof ProblemDoc)[]
+    ): Promise<ProblemDoc | null>;
+
+    /**
+     * 检查用户是否可以查看题目
+     */
+    canViewBy(pdoc: ProblemDoc, user: { _id: number }): boolean;
+
+    /** 公开字段投影 */
+    PROJECTION_PUBLIC: (keyof ProblemDoc)[];
+    /** 列表字段投影 */
+    PROJECTION_LIST: (keyof ProblemDoc)[];
+    /** 基础字段投影 */
+    PROJECTION_BASE: (keyof ProblemDoc)[];
+  };
+}

package/src/types/hydrooj.ts

@@ -0,0 +1,38 @@
+/**
+ * HydroOJ 扩展类型定义
+ * 用于补充 HydroOJ 未导出的内部类型
+ */
+
+import type { Handler } from 'hydrooj';
+
+/**
+ * HydroOJ Problem 文档接口
+ */
+export interface ProblemDocument {
+  docId: number;
+  domainId: string;
+  docType: number;
+  title?: string;
+}
+
+/**
+ * HydroOJ User 文档接口
+ */
+export interface UserDocument {
+  _id: number;
+  uname?: string;
+}
+
+/**
+ * Handler 的 domain 上下文接口
+ */
+export interface DomainContext {
+  _id: string;
+}
+
+/**
+ * 带有 domain 上下文的 Handler 类型
+ */
+export interface HandlerWithDomain extends Handler {
+  domain?: DomainContext;
+}

package/src/types/mongo.ts

@@ -0,0 +1,23 @@
+/**
+ * MongoDB 查询类型定义
+ * 为 MongoDB 查询和更新操作提供更精确的类型
+ */
+
+import type { Filter, UpdateFilter } from 'mongodb';
+
+/**
+ * MongoDB 查询条件类型
+ * 用于动态构建查询条件
+ */
+export type MongoQuery<T> = Filter<T>;
+
+/**
+ * MongoDB 更新操作类型
+ * 用于动态构建更新操作
+ */
+export type MongoUpdate<T> = UpdateFilter<T>;
+
+/**
+ * MongoDB 聚合管道阶段类型
+ */
+export type MongoPipelineStage = Record<string, unknown>;

package/src/utils/domainHelper.ts

@@ -0,0 +1,16 @@
+/**
+ * 域辅助工具函数
+ */
+
+import type { Handler } from 'hydrooj';
+import type { HandlerWithDomain } from '../types/hydrooj';
+
+/**
+ * 从 Handler 获取当前域 ID
+ * @param handler Handler 实例
+ * @returns 域 ID，默认为 'system'
+ */
+export function getDomainId(handler: Handler): string {
+  const h = handler as HandlerWithDomain;
+  return handler.args?.domainId || h.domain?._id || 'system';
+}

package/src/utils/mongo.ts

@@ -0,0 +1,15 @@
+/**
+ * MongoDB helpers
+ *
+ * Use the same mongodb/bson version that HydroOJ runtime is using to avoid
+ * BSON major-version mismatches when converting ids.
+ */
+import { createRequire } from 'module';
+
+// Resolve modules relative to the HydroOJ installation (the host runtime),
+// so we always share the same mongodb / bson implementation.
+const requireFromHydro = createRequire(require.resolve('hydrooj'));
+const mongodb = requireFromHydro('mongodb') as typeof import('mongodb');
+
+export const ObjectId = mongodb.ObjectId;
+export type ObjectIdType = import('mongodb').ObjectId;

package/templates/ai-helper/admin_config.html

@@ -0,0 +1,8 @@
+{% extends "layout/basic.html" %}
+
+{% block content %}
+<div class="container">
+  <!-- React 配置页面组件挂载点 -->
+  <div id="ai-helper-admin-config-root"></div>
+</div>
+{% endblock %}

package/templates/ai-helper/analytics.html

@@ -0,0 +1,8 @@
+{% extends "layout/basic.html" %}
+
+{% block content %}
+<div class="container">
+  <!-- React 统计页面组件挂载点 -->
+  <div id="ai-helper-analytics-root"></div>
+</div>
+{% endblock %}

package/templates/ai-helper/dashboard.html

@@ -0,0 +1,8 @@
+{% extends "layout/basic.html" %}
+
+{% block content %}
+<div class="container">
+  <!-- AI 助手统一入口 React 组件挂载点 -->
+  <div id="ai-helper-dashboard-root"></div>
+</div>
+{% endblock %}

package/templates/ai-helper/teacher_conversation_detail.html

@@ -0,0 +1,8 @@
+{% extends "layout/basic.html" %}
+
+{% block content %}
+<div class="container">
+  <!-- React 详情组件挂载点 -->
+  <div id="ai-helper-conversation-detail-root"></div>
+</div>
+{% endblock %}

package/templates/ai-helper/teacher_conversations.html

@@ -0,0 +1,8 @@
+{% extends "layout/basic.html" %}
+
+{% block content %}
+<div class="container">
+  <!-- React 列表组件挂载点 -->
+  <div id="ai-helper-conversations-root"></div>
+</div>
+{% endblock %}

package/tests/integration/README.md

@@ -0,0 +1,86 @@
+HydroOJ AI Helper 集成测试说明
+========================
+
+本文件提供一套基于 `curl` 的接口级测试脚本，覆盖「管理员配置 → 学生提问 → 数据持久化 → 教师查看/导出/统计」核心链路，无需额外测试框架。
+
+前置条件
+--------
+- HydroOJ 已安装并运行，且已加载本插件并执行 `npm run build`。
+- 通过环境变量或 `.env` 配置了 `ENCRYPTION_KEY`（用于保存 AI Key）。
+- 至少有一个具备 `PRIV.PRIV_EDIT_SYSTEM` 的管理员账号（教师端接口当前也要求此权限）。
+- 准备若干题目与测试用户（学生/教师）。账号需已登录，以便获取 Cookie。
+- 可用的 AI 配置（真实或假 API Key + 可用的 base URL/mock 服务）。请勿将真实 Key 写入仓库。
+- 本地具备 `curl` 和 `python3`（仅用于解析 JSON 并保存 `conversationId`）。
+
+获取登录 Cookie
+---------------
+1. 使用浏览器登录 HydroOJ，对应账号分别获取 `sid=...` Cookie（管理员/教师/学生）。
+2. 在浏览器开发者工具的 Application/Storage 中复制 Cookie；或在请求头里复制整段 `Cookie: sid=xxxxx`。
+3. 后续脚本通过环境变量读取这些 Cookie。
+
+快速开始
+--------
+在仓库根目录执行：
+
+```bash
+cd tests/integration/curl
+chmod +x *.sh
+
+# 必需环境变量
+export HYDRO_BASE_URL="http://127.0.0.1"
+export HYDRO_ADMIN_COOKIE="sid=admin-cookie"
+# 教师端接口目前同样需要系统权限，如无单独教师账号可复用管理员 Cookie
+export HYDRO_TEACHER_COOKIE="sid=teacher-cookie"
+export HYDRO_STUDENT_COOKIE="sid=student-cookie"
+
+# 可选：AI 配置占位值
+export HYDRO_AI_API_BASE_URL="https://api.openai.com/v1"
+export HYDRO_AI_MODEL_NAME="gpt-3.5-turbo"
+export HYDRO_AI_API_KEY="sk-REPLACE-ME"
+export HYDRO_AI_RATE_LIMIT=5
+export HYDRO_AI_TIMEOUT=30
+
+# 学生端默认频率限制为每分钟 5 次，跑示例时可在脚本间留出时间或临时调高
+# `HYDRO_AI_RATE_LIMIT` 配置，以避免意外触发 429。
+
+# 依次执行核心链路
+./01-admin-config-set.sh
+./02-student-chat.sh
+./03-teacher-list.sh
+./04-teacher-detail.sh
+./05-export.sh
+./06-analytics.sh
+```
+
+- `02-student-chat.sh` 会把最新的 `conversationId` 写入 `.conversation_id`，供后续脚本复用；也可通过 `HYDRO_CONVERSATION_ID` 覆盖。
+- 如需重新获取 Cookie 或更换 base URL，请重新导出环境变量后再运行脚本。
+
+测试脚本一览
+------------
+
+脚本 | 场景 | 涉及接口 | 预期结果
+---- | ---- | -------- | -------
+01-admin-config-set.sh | 管理员设置 AI 配置并测试连接 | PUT /ai-helper/admin/config；POST /ai-helper/admin/test-connection | 200，返回配置摘要；测试连接返回 `success: true/false` 消息
+02-student-chat.sh | 学生发起对话（含 questionType 与可选代码） | POST /ai-helper/chat | 200，返回 `conversationId` 与 `message.content`；写入 `.conversation_id`
+03-teacher-list.sh | 教师查看对话列表，验证筛选参数 | GET /ai-helper/conversations | 200，包含列表与分页信息，可看到刚创建的会话；错误日期格式应返回 400
+04-teacher-detail.sh | 教师查看对话详情 | GET /ai-helper/conversations/{id} | 200，返回会话元数据与消息数组
+05-export.sh | 导出 CSV | GET /ai-helper/export | 200，`Content-Type: text/csv`，生成的 CSV 文件非空
+06-analytics.sh | 查看统计数据 | GET /ai-helper/analytics | 200，返回 `dimension` 对应的统计结构；非法 dimension 返回 400
+
+判定通过/失败
+-------------
+- HTTP 状态码：脚本中默认要求 200（部分错误场景除外），否则退出并打印响应体。
+- 核心字段检查：
+  - 配置：返回体含 `config` 字段；`test-connection` 返回 `success` 与 `message`。
+  - 学生对话：返回 `conversationId`、`message.content` 非空；若触发频率限制会返回 429（可作为附加验证）。
+  - 列表/详情：列表返回 `conversations` 数组、`total`；详情返回 `conversation` 与 `messages` 数组。
+  - 导出：输出文件非空且首行包含 CSV 头；若 `format` 非 `csv` 应返回 400。
+  - 统计：返回 `dimension` 与 `items` 数组；若缺失 `dimension` 参数（且请求 Accept JSON），应返回 400。
+- 权限异常：不带 Cookie 或使用学生 Cookie 访问教师/管理员接口应返回 403/401（可手动去掉 Cookie 重试验证）。
+- 时间范围参数：传入明显非法日期（示例见 03/05/06 脚本中的 `INVALID_DATE` 示例）应返回 400。
+
+附加说明
+--------
+- 真实测试时请替换 `HYDRO_AI_API_KEY` 为有效 Key 或指向可用的 mock 服务；切勿将真实 Key 保存在仓库。
+- 如果已存在历史会话，可设置 `HYDRO_CONVERSATION_ID` 跳过新建对话。
+- 默认频率限制（学生端）为每分钟 5 次，建议控制调用节奏或调高测试环境限额，避免出现 429。

package/tests/integration/curl/01-admin-config-set.sh

@@ -0,0 +1,56 @@
+#!/usr/bin/env bash
+# 管理员配置 AI 服务并执行连接测试
+set -euo pipefail
+
+BASE_URL="${HYDRO_BASE_URL:-http://127.0.0.1}"
+COOKIE="${HYDRO_ADMIN_COOKIE:?HYDRO_ADMIN_COOKIE not set. Please export HYDRO_ADMIN_COOKIE=\"sid=...\"}"
+
+API_BASE_URL="${HYDRO_AI_API_BASE_URL:-https://api.openai.com/v1}"
+MODEL_NAME="${HYDRO_AI_MODEL_NAME:-gpt-3.5-turbo}"
+API_KEY="${HYDRO_AI_API_KEY:-sk-REPLACE-ME}"
+RATE_LIMIT="${HYDRO_AI_RATE_LIMIT:-5}"
+TIMEOUT="${HYDRO_AI_TIMEOUT:-30}"
+SYSTEM_PROMPT="${HYDRO_AI_SYSTEM_PROMPT:-You are a helpful teaching assistant.}"
+
+echo "[T026] 01-admin-config-set: set config & test connection"
+echo "Using BASE_URL=${BASE_URL}"
+
+CONFIG_PAYLOAD=$(cat <<EOF
+{
+  "apiBaseUrl": "$API_BASE_URL",
+  "modelName": "$MODEL_NAME",
+  "apiKey": "$API_KEY",
+  "rateLimitPerMinute": $RATE_LIMIT,
+  "timeoutSeconds": $TIMEOUT,
+  "systemPromptTemplate": "$SYSTEM_PROMPT"
+}
+EOF
+)
+
+echo "--- Updating config ---"
+response=$(curl -sS -w "\nHTTP_STATUS:%{http_code}" -X PUT "$BASE_URL/ai-helper/admin/config" \
+  -H "Cookie: $COOKIE" \
+  -H "Content-Type: application/json" \
+  -d "$CONFIG_PAYLOAD")
+
+body=$(printf "%s" "$response" | sed '/HTTP_STATUS:/d')
+status=$(printf "%s" "$response" | sed -n 's/.*HTTP_STATUS://p')
+echo "$body"
+if [ "$status" != "200" ]; then
+  echo "Unexpected status while updating config: $status" >&2
+  exit 1
+fi
+
+echo "--- Test connection ---"
+test_resp=$(curl -sS -w "\nHTTP_STATUS:%{http_code}" -X POST "$BASE_URL/ai-helper/admin/test-connection" \
+  -H "Cookie: $COOKIE")
+
+test_body=$(printf "%s" "$test_resp" | sed '/HTTP_STATUS:/d')
+test_status=$(printf "%s" "$test_resp" | sed -n 's/.*HTTP_STATUS://p')
+echo "$test_body"
+if [ "$test_status" != "200" ]; then
+  echo "Unexpected status while testing connection: $test_status" >&2
+  exit 1
+fi
+
+echo "[Done] admin config updated and connection tested."