@nextclaw/server 0.5.21 → 0.5.22

package/dist/index.d.ts

@@ -27,6 +27,16 @@ type ProviderConfigUpdate = {
     extraHeaders?: Record<string, string> | null;
     wireApi?: "auto" | "chat" | "responses" | null;
 };
+type ProviderConnectionTestRequest = ProviderConfigUpdate & {
+    model?: string | null;
+};
+type ProviderConnectionTestResult = {
+    success: boolean;
+    provider: string;
+    model?: string;
+    latencyMs: number;
+    message: string;
+};
 type AgentProfileView = {
     id: string;
     default?: boolean;
@@ -578,6 +588,7 @@ declare function updateModel(configPath: string, patch: {
     maxTokens?: number;
 }): ConfigView;
 declare function updateProvider(configPath: string, providerName: string, patch: ProviderConfigUpdate): ProviderConfigView | null;
+declare function testProviderConnection(configPath: string, providerName: string, patch: ProviderConnectionTestRequest): Promise<ProviderConnectionTestResult | null>;
 declare function updateChannel(configPath: string, channelName: string, patch: Record<string, unknown>): Record<string, unknown> | null;
 declare function listSessions(configPath: string, query?: {
     q?: string;
@@ -590,4 +601,4 @@ declare function deleteSession(configPath: string, key: string): boolean;
 declare function updateRuntime(configPath: string, patch: RuntimeConfigUpdate): Pick<ConfigView, "agents" | "bindings" | "session">;
 declare function updateSecrets(configPath: string, patch: SecretsConfigUpdate): SecretsView;
 
-export { type AgentBindingView, type AgentProfileView, type ApiError, type ApiResponse, type BindingPeerView, type ChannelSpecView, type ChatTurnRequest, type ChatTurnResult, type ChatTurnStreamEvent, type ChatTurnView, type ConfigActionExecuteRequest, type ConfigActionExecuteResult, type ConfigActionManifest, type ConfigActionType, type ConfigMetaView, type ConfigSchemaResponse, type ConfigUiHint, type ConfigUiHints, type ConfigView, type CronActionResult, type CronEnableRequest, type CronJobStateView, type CronJobView, type CronListView, type CronPayloadView, type CronRunRequest, type CronScheduleView, type MarketplaceApiConfig, type MarketplaceInstallKind, type MarketplaceInstallSkillParams, type MarketplaceInstallSpec, type MarketplaceInstalledRecord, type MarketplaceInstalledView, type MarketplaceInstaller, type MarketplaceItemSummary, type MarketplaceItemType, type MarketplaceItemView, type MarketplaceListView, type MarketplacePluginInstallRequest, type MarketplacePluginInstallResult, type MarketplacePluginManageAction, type MarketplacePluginManageRequest, type MarketplacePluginManageResult, type MarketplaceRecommendationView, type MarketplaceSkillInstallRequest, type MarketplaceSkillInstallResult, type MarketplaceSkillManageAction, type MarketplaceSkillManageRequest, type MarketplaceSkillManageResult, type MarketplaceSort, type ProviderConfigUpdate, type ProviderConfigView, type ProviderSpecView, type RuntimeConfigUpdate, type SecretProviderEnvView, type SecretProviderExecView, type SecretProviderFileView, type SecretProviderView, type SecretRefView, type SecretSourceView, type SecretsConfigUpdate, type SecretsView, type SessionConfigView, type SessionEntryView, type SessionEventView, type SessionHistoryView, type SessionMessageView, type SessionPatchUpdate, type SessionsListView, type UiChatRuntime, type UiServerEvent, type UiServerHandle, type UiServerOptions, buildConfigMeta, buildConfigSchemaView, buildConfigView, createUiRouter, deleteSession, executeConfigAction, getSessionHistory, listSessions, loadConfigOrDefault, patchSession, startUiServer, updateChannel, updateModel, updateProvider, updateRuntime, updateSecrets };
+export { type AgentBindingView, type AgentProfileView, type ApiError, type ApiResponse, type BindingPeerView, type ChannelSpecView, type ChatTurnRequest, type ChatTurnResult, type ChatTurnStreamEvent, type ChatTurnView, type ConfigActionExecuteRequest, type ConfigActionExecuteResult, type ConfigActionManifest, type ConfigActionType, type ConfigMetaView, type ConfigSchemaResponse, type ConfigUiHint, type ConfigUiHints, type ConfigView, type CronActionResult, type CronEnableRequest, type CronJobStateView, type CronJobView, type CronListView, type CronPayloadView, type CronRunRequest, type CronScheduleView, type MarketplaceApiConfig, type MarketplaceInstallKind, type MarketplaceInstallSkillParams, type MarketplaceInstallSpec, type MarketplaceInstalledRecord, type MarketplaceInstalledView, type MarketplaceInstaller, type MarketplaceItemSummary, type MarketplaceItemType, type MarketplaceItemView, type MarketplaceListView, type MarketplacePluginInstallRequest, type MarketplacePluginInstallResult, type MarketplacePluginManageAction, type MarketplacePluginManageRequest, type MarketplacePluginManageResult, type MarketplaceRecommendationView, type MarketplaceSkillInstallRequest, type MarketplaceSkillInstallResult, type MarketplaceSkillManageAction, type MarketplaceSkillManageRequest, type MarketplaceSkillManageResult, type MarketplaceSort, type ProviderConfigUpdate, type ProviderConfigView, type ProviderConnectionTestRequest, type ProviderConnectionTestResult, type ProviderSpecView, type RuntimeConfigUpdate, type SecretProviderEnvView, type SecretProviderExecView, type SecretProviderFileView, type SecretProviderView, type SecretRefView, type SecretSourceView, type SecretsConfigUpdate, type SecretsView, type SessionConfigView, type SessionEntryView, type SessionEventView, type SessionHistoryView, type SessionMessageView, type SessionPatchUpdate, type SessionsListView, type UiChatRuntime, type UiServerEvent, type UiServerHandle, type UiServerOptions, buildConfigMeta, buildConfigSchemaView, buildConfigView, createUiRouter, deleteSession, executeConfigAction, getSessionHistory, listSessions, loadConfigOrDefault, patchSession, startUiServer, testProviderConnection, updateChannel, updateModel, updateProvider, updateRuntime, updateSecrets };

package/dist/index.js

@@ -19,9 +19,11 @@ import {
   saveConfig,
   ConfigSchema,
   probeFeishu,
+  LiteLLMProvider,
   PROVIDERS,
   buildConfigSchema,
   findProviderByName,
+  getProviderName,
   getPackageVersion,
   hasSecretRef,
   isSensitiveConfigPath,
@@ -30,6 +32,19 @@ import {
 } from "@nextclaw/core";
 var MASK_MIN_LENGTH = 8;
 var EXTRA_SENSITIVE_PATH_PATTERNS = [/authorization/i, /cookie/i, /session/i, /bearer/i];
+var PROVIDER_TEST_MODEL_FALLBACKS = {
+  openai: "gpt-4o-mini",
+  deepseek: "deepseek-chat",
+  gemini: "gemini-2.0-flash",
+  zhipu: "glm-4-flash",
+  dashscope: "qwen-plus",
+  moonshot: "moonshot-v1-8k",
+  minimax: "minimax-text-01",
+  groq: "llama-3.1-8b-instant",
+  openrouter: "openai/gpt-4o-mini",
+  aihubmix: "gpt-4o-mini",
+  anthropic: "claude-3-5-haiku-latest"
+};
 function matchesExtraSensitivePath(path) {
   if (path === "session" || path.startsWith("session.")) {
     return false;
@@ -400,6 +415,108 @@ function updateProvider(configPath, providerName, patch) {
   const updated = next.providers[providerName];
   return toProviderView(next, updated, providerName, uiHints, spec ?? void 0);
 }
+function normalizeOptionalString(value) {
+  if (typeof value !== "string") {
+    return null;
+  }
+  const trimmed = value.trim();
+  return trimmed.length > 0 ? trimmed : null;
+}
+function normalizeHeaders(input) {
+  if (!input) {
+    return null;
+  }
+  const entries = Object.entries(input).map(([key, value]) => [key.trim(), String(value ?? "").trim()]).filter(([key, value]) => key.length > 0 && value.length > 0);
+  if (entries.length === 0) {
+    return null;
+  }
+  return Object.fromEntries(entries);
+}
+function resolveTestModel(config, providerName, requestedModel) {
+  if (requestedModel) {
+    return requestedModel;
+  }
+  const defaultModel = normalizeOptionalString(config.agents.defaults.model);
+  if (defaultModel) {
+    const routedProvider = getProviderName(config, defaultModel);
+    if (!routedProvider || routedProvider === providerName) {
+      return defaultModel;
+    }
+  }
+  return PROVIDER_TEST_MODEL_FALLBACKS[providerName] ?? defaultModel ?? null;
+}
+function stringifyError(error) {
+  const raw = error instanceof Error ? error.message : String(error);
+  return raw.replace(/\s+/g, " ").trim();
+}
+async function testProviderConnection(configPath, providerName, patch) {
+  const config = loadConfigOrDefault(configPath);
+  const provider = config.providers[providerName];
+  if (!provider) {
+    return null;
+  }
+  const spec = findProviderByName(providerName);
+  const hasApiKeyPatch = Object.prototype.hasOwnProperty.call(patch, "apiKey");
+  const providedApiKey = normalizeOptionalString(patch.apiKey);
+  const currentApiKey = normalizeOptionalString(provider.apiKey);
+  const apiKey = hasApiKeyPatch ? providedApiKey : currentApiKey;
+  const hasApiBasePatch = Object.prototype.hasOwnProperty.call(patch, "apiBase");
+  const patchedApiBase = normalizeOptionalString(patch.apiBase);
+  const currentApiBase = normalizeOptionalString(provider.apiBase);
+  const apiBase = hasApiBasePatch ? patchedApiBase ?? spec?.defaultApiBase ?? null : currentApiBase ?? spec?.defaultApiBase ?? null;
+  const hasHeadersPatch = Object.prototype.hasOwnProperty.call(patch, "extraHeaders");
+  const extraHeaders = hasHeadersPatch ? normalizeHeaders(patch.extraHeaders ?? null) : normalizeHeaders(provider.extraHeaders ?? null);
+  const wireApi = spec?.supportsWireApi ? patch.wireApi ?? provider.wireApi ?? spec.defaultWireApi ?? "auto" : null;
+  if (!apiKey && !spec?.isLocal) {
+    return {
+      success: false,
+      provider: providerName,
+      latencyMs: 0,
+      message: "API key is required before testing the connection."
+    };
+  }
+  const requestedModel = normalizeOptionalString(patch.model);
+  const model = resolveTestModel(config, providerName, requestedModel);
+  if (!model) {
+    return {
+      success: false,
+      provider: providerName,
+      latencyMs: 0,
+      message: "No test model found. Set a default model first, then try again."
+    };
+  }
+  const probe = new LiteLLMProvider({
+    apiKey,
+    apiBase,
+    defaultModel: model,
+    extraHeaders,
+    providerName,
+    wireApi
+  });
+  const startedAtMs = Date.now();
+  try {
+    await probe.chat({
+      model,
+      messages: [{ role: "user", content: "ping" }],
+      maxTokens: 8
+    });
+    return {
+      success: true,
+      provider: providerName,
+      model,
+      latencyMs: Date.now() - startedAtMs,
+      message: "Connection test passed."
+    };
+  } catch (error) {
+    return {
+      success: false,
+      provider: providerName,
+      model,
+      latencyMs: Date.now() - startedAtMs,
+      message: stringifyError(error) || "Connection test failed."
+    };
+  }
+}
 function updateChannel(configPath, channelName, patch) {
   const config = loadConfigOrDefault(configPath);
   const channel = config.channels[channelName];
@@ -1594,6 +1711,22 @@ function createUiRouter(options) {
     options.publish({ type: "config.updated", payload: { path: `providers.${provider}` } });
     return c.json(ok(result));
   });
+  app.post("/api/config/providers/:provider/test", async (c) => {
+    const provider = c.req.param("provider");
+    const body = await readJson(c.req.raw);
+    if (!body.ok) {
+      return c.json(err("INVALID_BODY", "invalid json body"), 400);
+    }
+    const result = await testProviderConnection(
+      options.configPath,
+      provider,
+      body.data
+    );
+    if (!result) {
+      return c.json(err("NOT_FOUND", `unknown provider: ${provider}`), 404);
+    }
+    return c.json(ok(result));
+  });
   app.put("/api/config/channels/:channel", async (c) => {
     const channel = c.req.param("channel");
     const body = await readJson(c.req.raw);
@@ -2014,6 +2147,7 @@ export {
   loadConfigOrDefault,
   patchSession,
   startUiServer,
+  testProviderConnection,
   updateChannel,
   updateModel,
   updateProvider,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nextclaw/server",
-  "version": "0.5.21",
+  "version": "0.5.22",
   "private": false,
   "description": "Nextclaw UI/API server.",
   "type": "module",