sa2kit 3.4.0 → 3.7.0

package/dist/common/aiApi/client/index.mjs

@@ -0,0 +1,151 @@
+import '../../../chunk-MAI35PU6.mjs';
+import { useState, useCallback } from 'react';
+
+// src/common/aiApi/client/settingsCore.ts
+var DEFAULT_AI_API_SETTINGS = {
+  apiKey: "",
+  baseUrl: "https://api.openai.com/v1",
+  visionModel: "gpt-4o-mini",
+  textModel: "gpt-4o-mini",
+  audioModel: "whisper-1",
+  audioStrategy: "auto"
+};
+var AI_API_SETTINGS_STORAGE_KEY = "ai-api-settings";
+function loadAiApiSettings(storageKey = AI_API_SETTINGS_STORAGE_KEY) {
+  if (typeof window === "undefined") return DEFAULT_AI_API_SETTINGS;
+  try {
+    const raw = localStorage.getItem(storageKey);
+    if (!raw) return DEFAULT_AI_API_SETTINGS;
+    return { ...DEFAULT_AI_API_SETTINGS, ...JSON.parse(raw) };
+  } catch {
+    return DEFAULT_AI_API_SETTINGS;
+  }
+}
+function saveAiApiSettings(settings, storageKey = AI_API_SETTINGS_STORAGE_KEY) {
+  if (typeof window === "undefined") return;
+  localStorage.setItem(storageKey, JSON.stringify(settings));
+}
+function toClientSettings(settings) {
+  const client = {};
+  if (settings.apiKey.trim()) client.apiKey = settings.apiKey.trim();
+  if (settings.baseUrl.trim()) client.baseUrl = settings.baseUrl.trim();
+  const visionModel = settings.visionModel.trim();
+  const textModel = settings.textModel?.trim() || visionModel;
+  const audioModel = settings.audioModel?.trim();
+  if (visionModel) client.visionModel = visionModel;
+  if (textModel) client.textModel = textModel;
+  if (audioModel) client.audioModel = audioModel;
+  if (settings.audioStrategy) client.audioStrategy = settings.audioStrategy;
+  return Object.keys(client).length > 0 ? client : void 0;
+}
+function pickClientSettingsFromStorage(storageKey = AI_API_SETTINGS_STORAGE_KEY) {
+  return toClientSettings(loadAiApiSettings(storageKey));
+}
+
+// src/common/aiApi/client/aiApiClient.ts
+var AiApiClientError = class extends Error {
+  constructor(message, code, response) {
+    super(message);
+    this.code = code;
+    this.response = response;
+    this.name = "AiApiClientError";
+  }
+};
+async function runAiTask(taskId, input, options) {
+  const fetchFn = options?.fetchImpl ?? fetch;
+  const endpoint = options?.runEndpoint ?? "/api/ai/run";
+  const clientSettings = options?.clientSettings ?? pickClientSettingsFromStorage();
+  const payload = {
+    taskId,
+    input,
+    ...clientSettings ? { clientSettings } : {}
+  };
+  const response = await fetchFn(endpoint, {
+    method: "POST",
+    credentials: "include",
+    headers: { "Content-Type": "application/json" },
+    body: JSON.stringify(payload),
+    signal: options?.signal
+  });
+  const data = await response.json();
+  return data;
+}
+async function runAiTaskOrThrow(taskId, input, options) {
+  const result = await runAiTask(taskId, input, options);
+  if (!result.success || result.data === void 0) {
+    throw new AiApiClientError(
+      result.error?.message ?? "AI \u4EFB\u52A1\u5931\u8D25",
+      result.error?.code,
+      result
+    );
+  }
+  return result.data;
+}
+function createAiTaskRunner(taskId, options) {
+  return (input, runOptions) => runAiTaskOrThrow(taskId, input, {
+    ...runOptions,
+    runEndpoint: options?.runEndpoint,
+    fetchImpl: options?.fetchImpl
+  });
+}
+var aiApiClient = {
+  run: runAiTask,
+  runOrThrow: runAiTaskOrThrow,
+  createRunner: createAiTaskRunner
+};
+
+// src/common/aiApi/client/fetchModels.ts
+async function fetchAiModels(clientSettings, options) {
+  const fetchFn = options?.fetchImpl ?? fetch;
+  const endpoint = options?.modelsEndpoint ?? "/api/ai/models";
+  const response = await fetchFn(endpoint, {
+    method: "POST",
+    credentials: "include",
+    headers: { "Content-Type": "application/json" },
+    body: JSON.stringify({ clientSettings }),
+    signal: options?.signal
+  });
+  return await response.json();
+}
+function useAiTask(taskId) {
+  const [loading, setLoading] = useState(false);
+  const [error, setError] = useState(null);
+  const [result, setResult] = useState(null);
+  const execute = useCallback(
+    async (input, options) => {
+      setLoading(true);
+      setError(null);
+      try {
+        const response = await runAiTask(taskId, input, options);
+        setResult(response);
+        if (!response.success) {
+          setError(response.error?.message ?? "AI \u4EFB\u52A1\u5931\u8D25");
+        }
+        return response;
+      } catch (err) {
+        const message = err instanceof Error ? err.message : "AI \u4EFB\u52A1\u5931\u8D25";
+        setError(message);
+        const failed = {
+          success: false,
+          taskId,
+          error: { code: "AI_REQUEST_FAILED", message }
+        };
+        setResult(failed);
+        return failed;
+      } finally {
+        setLoading(false);
+      }
+    },
+    [taskId]
+  );
+  const reset = useCallback(() => {
+    setLoading(false);
+    setError(null);
+    setResult(null);
+  }, []);
+  return { execute, loading, error, result, reset };
+}
+
+export { AI_API_SETTINGS_STORAGE_KEY, AiApiClientError, DEFAULT_AI_API_SETTINGS, aiApiClient, createAiTaskRunner, fetchAiModels, loadAiApiSettings, pickClientSettingsFromStorage, runAiTask, runAiTaskOrThrow, saveAiApiSettings, toClientSettings, useAiTask };
+//# sourceMappingURL=index.mjs.map
+//# sourceMappingURL=index.mjs.map

package/dist/common/aiApi/client/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/common/aiApi/client/settingsCore.ts","../../../../src/common/aiApi/client/aiApiClient.ts","../../../../src/common/aiApi/client/fetchModels.ts","../../../../src/common/aiApi/client/hooks/useAiTask.ts"],"names":[],"mappings":"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","file":"index.mjs","sourcesContent":["import type { AiClientSettings, AudioStrategy } from '../types';\n\nexport interface AiApiSettings {\n  apiKey: string;\n  baseUrl: string;\n  visionModel: string;\n  textModel?: string;\n  audioModel?: string;\n  audioStrategy?: AudioStrategy;\n}\n\nexport const DEFAULT_AI_API_SETTINGS: AiApiSettings = {\n  apiKey: '',\n  baseUrl: 'https://api.openai.com/v1',\n  visionModel: 'gpt-4o-mini',\n  textModel: 'gpt-4o-mini',\n  audioModel: 'whisper-1',\n  audioStrategy: 'auto',\n};\n\nexport const AI_API_SETTINGS_STORAGE_KEY = 'ai-api-settings';\n\nexport function loadAiApiSettings(storageKey = AI_API_SETTINGS_STORAGE_KEY): AiApiSettings {\n  if (typeof window === 'undefined') return DEFAULT_AI_API_SETTINGS;\n  try {\n    const raw = localStorage.getItem(storageKey);\n    if (!raw) return DEFAULT_AI_API_SETTINGS;\n    return { ...DEFAULT_AI_API_SETTINGS, ...JSON.parse(raw) };\n  } catch {\n    return DEFAULT_AI_API_SETTINGS;\n  }\n}\n\nexport function saveAiApiSettings(\n  settings: AiApiSettings,\n  storageKey = AI_API_SETTINGS_STORAGE_KEY\n): void {\n  if (typeof window === 'undefined') return;\n  localStorage.setItem(storageKey, JSON.stringify(settings));\n}\n\nexport function toClientSettings(settings: AiApiSettings): AiClientSettings | undefined {\n  const client: AiClientSettings = {};\n  if (settings.apiKey.trim()) client.apiKey = settings.apiKey.trim();\n  if (settings.baseUrl.trim()) client.baseUrl = settings.baseUrl.trim();\n  const visionModel = settings.visionModel.trim();\n  const textModel = settings.textModel?.trim() || visionModel;\n  const audioModel = settings.audioModel?.trim();\n  if (visionModel) client.visionModel = visionModel;\n  if (textModel) client.textModel = textModel;\n  if (audioModel) client.audioModel = audioModel;\n  if (settings.audioStrategy) client.audioStrategy = settings.audioStrategy;\n  return Object.keys(client).length > 0 ? client : undefined;\n}\n\nexport function pickClientSettingsFromStorage(\n  storageKey = AI_API_SETTINGS_STORAGE_KEY\n): AiClientSettings | undefined {\n  return toClientSettings(loadAiApiSettings(storageKey));\n}\n","import type { AiApiResponse, AiApiRunRequest, AiClientSettings } from '../types';\nimport { pickClientSettingsFromStorage } from './settingsCore';\n\nexport class AiApiClientError extends Error {\n  constructor(\n    message: string,\n    public readonly code?: string,\n    public readonly response?: AiApiResponse\n  ) {\n    super(message);\n    this.name = 'AiApiClientError';\n  }\n}\n\nexport interface AiApiClientOptions {\n  /** 默认 POST /api/ai/run，宿主应用可覆盖 */\n  runEndpoint?: string;\n  fetchImpl?: typeof fetch;\n}\n\n/**\n * 通过 HTTP 调用宿主暴露的 AI 任务入口（如 Next.js route）。\n * 连接配置可通过请求体 clientSettings 传入，或从 localStorage 读取。\n */\nexport async function runAiTask<TInput, TOutput>(\n  taskId: string,\n  input: TInput,\n  options?: {\n    signal?: AbortSignal;\n    clientSettings?: AiClientSettings;\n    runEndpoint?: string;\n    fetchImpl?: typeof fetch;\n  }\n): Promise<AiApiResponse<TOutput>> {\n  const fetchFn = options?.fetchImpl ?? fetch;\n  const endpoint = options?.runEndpoint ?? '/api/ai/run';\n  const clientSettings = options?.clientSettings ?? pickClientSettingsFromStorage();\n\n  const payload: AiApiRunRequest<TInput> = {\n    taskId,\n    input,\n    ...(clientSettings ? { clientSettings } : {}),\n  };\n\n  const response = await fetchFn(endpoint, {\n    method: 'POST',\n    credentials: 'include',\n    headers: { 'Content-Type': 'application/json' },\n    body: JSON.stringify(payload),\n    signal: options?.signal,\n  });\n\n  const data = (await response.json()) as AiApiResponse<TOutput>;\n  return data;\n}\n\nexport async function runAiTaskOrThrow<TInput, TOutput>(\n  taskId: string,\n  input: TInput,\n  options?: {\n    signal?: AbortSignal;\n    clientSettings?: AiClientSettings;\n    runEndpoint?: string;\n    fetchImpl?: typeof fetch;\n  }\n): Promise<TOutput> {\n  const result = await runAiTask<TInput, TOutput>(taskId, input, options);\n  if (!result.success || result.data === undefined) {\n    throw new AiApiClientError(\n      result.error?.message ?? 'AI 任务失败',\n      result.error?.code,\n      result\n    );\n  }\n  return result.data;\n}\n\nexport function createAiTaskRunner<TInput, TOutput>(\n  taskId: string,\n  options?: AiApiClientOptions\n) {\n  return (\n    input: TInput,\n    runOptions?: { signal?: AbortSignal; clientSettings?: AiClientSettings }\n  ) =>\n    runAiTaskOrThrow<TInput, TOutput>(taskId, input, {\n      ...runOptions,\n      runEndpoint: options?.runEndpoint,\n      fetchImpl: options?.fetchImpl,\n    });\n}\n\nexport const aiApiClient = {\n  run: runAiTask,\n  runOrThrow: runAiTaskOrThrow,\n  createRunner: createAiTaskRunner,\n};\n","import type { AiClientSettings, AiModelsListResponse } from '../types';\n\nexport async function fetchAiModels(\n  clientSettings?: AiClientSettings,\n  options?: { signal?: AbortSignal; modelsEndpoint?: string; fetchImpl?: typeof fetch }\n): Promise<AiModelsListResponse> {\n  const fetchFn = options?.fetchImpl ?? fetch;\n  const endpoint = options?.modelsEndpoint ?? '/api/ai/models';\n\n  const response = await fetchFn(endpoint, {\n    method: 'POST',\n    credentials: 'include',\n    headers: { 'Content-Type': 'application/json' },\n    body: JSON.stringify({ clientSettings }),\n    signal: options?.signal,\n  });\n\n  return (await response.json()) as AiModelsListResponse;\n}\n","'use client';\n\nimport { useCallback, useState } from 'react';\nimport type { AiClientSettings, AiApiResponse } from '../../types';\nimport { runAiTask } from '../aiApiClient';\n\nexport function useAiTask<TInput, TOutput>(taskId: string) {\n  const [loading, setLoading] = useState(false);\n  const [error, setError] = useState<string | null>(null);\n  const [result, setResult] = useState<AiApiResponse<TOutput> | null>(null);\n\n  const execute = useCallback(\n    async (\n      input: TInput,\n      options?: { signal?: AbortSignal; clientSettings?: AiClientSettings }\n    ) => {\n      setLoading(true);\n      setError(null);\n      try {\n        const response = await runAiTask<TInput, TOutput>(taskId, input, options);\n        setResult(response);\n        if (!response.success) {\n          setError(response.error?.message ?? 'AI 任务失败');\n        }\n        return response;\n      } catch (err) {\n        const message = err instanceof Error ? err.message : 'AI 任务失败';\n        setError(message);\n        const failed: AiApiResponse<TOutput> = {\n          success: false,\n          taskId,\n          error: { code: 'AI_REQUEST_FAILED', message },\n        };\n        setResult(failed);\n        return failed;\n      } finally {\n        setLoading(false);\n      }\n    },\n    [taskId]\n  );\n\n  const reset = useCallback(() => {\n    setLoading(false);\n    setError(null);\n    setResult(null);\n  }, []);\n\n  return { execute, loading, error, result, reset };\n}\n"]}

package/dist/common/aiApi/index.d.mts

@@ -0,0 +1,184 @@
+import { A as AiClientSettings, d as AiConnectionConfig, M as MultimodalChatParams, e as MultimodalChatResult, f as AiImageInput, g as AiAudioInput, h as AiMediaInput, c as AudioStrategy, i as AiTaskDefinition, j as AiTaskContext, a as AiApiResponse, T as TextCompletionInput, k as TextCompletionOutput, S as StructuredMultimodalInput, l as StructuredMultimodalOutput, C as ConnectivityTestOutput } from '../../types-CiqMQ-uu.mjs';
+export { p as AiApiErrorBody, q as AiApiErrorCode, r as AiApiResponseMeta, n as AiApiRunRequest, u as AiAudioMediaInput, m as AiConnectionSettings, t as AiImageMediaInput, s as AiMediaKind, y as AiModelsListRequest, b as AiModelsListResponse, o as AiTaskRunOptions, x as CORE_CONNECTIVITY_TEST_TASK_ID, v as CORE_LLM_COMPLETION_TASK_ID, w as CORE_STRUCTURED_MULTIMODAL_TASK_ID } from '../../types-CiqMQ-uu.mjs';
+import { R as RequestAdapter } from '../../types-CbTsi9CZ.mjs';
+
+/**
+ * 合并连接配置：显式 connection > clientSettings > 环境变量。
+ * 缺少 apiKey 时返回 null。
+ */
+declare function resolveAiConnectionConfig(...sources: Array<AiClientSettings | undefined>): AiConnectionConfig | null;
+declare function requireAiConnectionConfig(...sources: Array<AiClientSettings | undefined>): AiConnectionConfig;
+
+type JsonRequestOptions = {
+    url: string;
+    method?: 'GET' | 'POST' | 'PUT' | 'DELETE' | 'PATCH';
+    headers?: Record<string, string>;
+    body?: unknown;
+    timeoutMs?: number;
+    requestAdapter?: RequestAdapter;
+};
+declare function requestJson<T>(options: JsonRequestOptions): Promise<T>;
+
+declare const DEFAULT_OPENAI_BASE_URL = "https://api.openai.com/v1";
+declare const DEFAULT_TEXT_MODEL = "gpt-4o-mini";
+type ChatRole = 'system' | 'user' | 'assistant';
+interface ChatMessage {
+    role: ChatRole;
+    content: string;
+}
+interface CallChatOptions {
+    /** OpenAI 兼容 API Base URL */
+    baseUrl: string;
+    /** API Key */
+    apiKey: string;
+    model?: string;
+    systemPrompt?: string;
+    userPrompt?: string;
+    messages?: ChatMessage[];
+    temperature?: number;
+    maxTokens?: number;
+    topP?: number;
+    stop?: string | string[];
+    timeoutMs?: number;
+    requestAdapter?: RequestAdapter;
+}
+interface ChatUsage {
+    promptTokens?: number;
+    completionTokens?: number;
+    totalTokens?: number;
+}
+interface CallChatResult {
+    content: string;
+    model: string;
+    usage?: ChatUsage;
+    raw?: unknown;
+}
+/**
+ * OpenAI 兼容文本对话：外部传入 URL、Key、提示词，返回模型生成内容。
+ */
+declare function callChat(options: CallChatOptions): Promise<CallChatResult>;
+
+interface CallCompletionParams {
+    systemPrompt?: string;
+    userPrompt: string;
+    model?: string;
+    temperature?: number;
+    maxTokens?: number;
+    connection?: AiClientSettings;
+}
+interface CallCompletionResult {
+    content: string;
+    model: string;
+    raw?: unknown;
+}
+/**
+ * 文本补全：连接信息与提示词均由调用方传入（或通过 connection 合并 env）。
+ */
+declare function callCompletion(params: CallCompletionParams, clientSettings?: AiClientSettings): Promise<CallCompletionResult>;
+
+/**
+ * OpenAI 兼容多模态对话：文本 + 可选图片/语音。
+ * audioStrategy=auto 时：优先 chat 内嵌音频（native），失败或未支持则 STT 转写后走文本 chat。
+ */
+declare function callMultimodalChat(params: MultimodalChatParams, clientSettings?: AiClientSettings): Promise<MultimodalChatResult>;
+
+declare function extractJsonObject(text: string): Record<string, unknown>;
+
+declare function assertValidImageInput(image: AiImageInput, maxImageBytes?: number): void;
+declare function fileToAiImageInput(file: File): Promise<AiImageInput>;
+
+declare function mimeToAudioFormat(mimeType: string): string;
+declare function assertValidAudioInput(audio: AiAudioInput, maxAudioBytes?: number): void;
+declare function fileToAiAudioInput(file: File): Promise<AiAudioInput>;
+declare function base64ToBlob(base64: string, mimeType: string): Blob;
+
+declare function splitMediaByKind(media: AiMediaInput[]): {
+    images: AiMediaInput[];
+    audios: AiMediaInput[];
+};
+declare function assertValidMultimodalMedia(media: AiMediaInput[] | undefined, limits: {
+    maxImageBytes: number;
+    maxAudioBytes: number;
+    maxImages?: number;
+    maxAudios?: number;
+}): AiMediaInput[];
+
+type ResolvedAudioHandling = 'none' | 'native' | 'stt';
+declare function resolveAudioHandling(options: {
+    hasAudio: boolean;
+    strategy: AudioStrategy;
+    model: string;
+    baseUrl: string;
+}): ResolvedAudioHandling;
+declare function isAudioInputError(message: string): boolean;
+declare function appendTranscriptionsToPrompt(userPrompt: string, transcriptions: string[]): string;
+
+interface TranscribeAudioOptions {
+    audio: AiAudioInput;
+    config: AiConnectionConfig;
+    model?: string;
+    language?: string;
+}
+declare function transcribeAudio(options: TranscribeAudioOptions): Promise<string>;
+declare function transcribeAudios(audios: AiAudioInput[], config: AiConnectionConfig, model?: string): Promise<string[]>;
+
+declare function isLikelyNativeAudioChatModel(id: string): boolean;
+declare function isLikelySttModel(id: string): boolean;
+declare function filterSttModels(modelIds: string[]): string[];
+declare function pickDefaultSttModel(modelIds: string[], current?: string): string | undefined;
+declare function isLikelyVisionModel(id: string): boolean;
+declare function isKnownTextOnlyModel(id: string): boolean;
+declare function filterChatModels(modelIds: string[]): string[];
+declare function filterVisionModels(modelIds: string[]): string[];
+/** 从可用模型中挑选默认视觉模型 */
+declare function pickDefaultVisionModel(modelIds: string[], current?: string): string | undefined;
+
+type VisionMessageFormat = 'openai' | 'ollama';
+declare function detectVisionMessageFormat(baseUrl: string): VisionMessageFormat;
+declare function assertVisionCapableModel(modelId: string, options?: {
+    baseUrl?: string;
+    hasImages?: boolean;
+}): void;
+declare function isImageUrlVariantError(message: string): boolean;
+declare function toVisionApiErrorMessage(rawMessage: string, modelId: string): string;
+
+declare function buildMultimodalMessages(options: {
+    systemPrompt: string;
+    userPrompt: string;
+    images: AiMediaInput[];
+    nativeAudios: AiMediaInput[];
+    format: VisionMessageFormat;
+}): Array<Record<string, unknown>>;
+declare function assertMultimodalCapableModel(modelId: string, options: {
+    baseUrl?: string;
+    hasImages?: boolean;
+    hasNativeAudio?: boolean;
+}): void;
+
+interface ListModelsResult {
+    models: string[];
+    visionModels: string[];
+    suggestedVisionModel?: string;
+}
+declare function listOpenAiCompatibleModels(clientSettings?: AiClientSettings, currentVisionModel?: string): Promise<ListModelsResult>;
+
+declare function registerAiTask<TInput, TOutput>(task: AiTaskDefinition<TInput, TOutput>): void;
+declare function getAiTask(taskId: string): AiTaskDefinition | undefined;
+declare function listAiTasks(): string[];
+declare function clearAiTasksForTest(): void;
+
+declare function runAiTask<TData = unknown>(taskId: string, input: unknown, ctx?: AiTaskContext): Promise<AiApiResponse<TData>>;
+
+/** 注册内置通用 AI 任务（幂等） */
+declare function registerCoreAiTasks(): void;
+/** 别名：确保 core 任务已注册 */
+declare const ensureCoreAiTasksRegistered: typeof registerCoreAiTasks;
+declare function resetCoreAiTasksForTest(): void;
+
+declare const coreLlmCompletionTask: AiTaskDefinition<TextCompletionInput, TextCompletionOutput>;
+
+declare const coreStructuredMultimodalTask: AiTaskDefinition<StructuredMultimodalInput, StructuredMultimodalOutput>;
+
+declare const coreConnectivityTestTask: AiTaskDefinition<Record<string, never>, ConnectivityTestOutput>;
+
+export { AiApiResponse, AiAudioInput, AiClientSettings, AiConnectionConfig, AiImageInput, AiMediaInput, AiTaskContext, AiTaskDefinition, AudioStrategy, type CallChatOptions, type CallChatResult, type CallCompletionParams, type CallCompletionResult, type ChatMessage, type ChatRole, type ChatUsage, ConnectivityTestOutput, DEFAULT_OPENAI_BASE_URL, DEFAULT_TEXT_MODEL, type JsonRequestOptions, type ListModelsResult, MultimodalChatParams, MultimodalChatResult, type ResolvedAudioHandling, StructuredMultimodalInput, StructuredMultimodalOutput, TextCompletionInput, TextCompletionOutput, type TranscribeAudioOptions, type VisionMessageFormat, appendTranscriptionsToPrompt, assertMultimodalCapableModel, assertValidAudioInput, assertValidImageInput, assertValidMultimodalMedia, assertVisionCapableModel, base64ToBlob, buildMultimodalMessages, callChat, callCompletion, callMultimodalChat, clearAiTasksForTest, coreConnectivityTestTask, coreLlmCompletionTask, coreStructuredMultimodalTask, detectVisionMessageFormat, ensureCoreAiTasksRegistered, extractJsonObject, fileToAiAudioInput, fileToAiImageInput, filterChatModels, filterSttModels, filterVisionModels, getAiTask, isAudioInputError, isImageUrlVariantError, isKnownTextOnlyModel, isLikelyNativeAudioChatModel, isLikelySttModel, isLikelyVisionModel, listAiTasks, listOpenAiCompatibleModels, mimeToAudioFormat, pickDefaultSttModel, pickDefaultVisionModel, registerAiTask, registerCoreAiTasks, requestJson, requireAiConnectionConfig, resetCoreAiTasksForTest, resolveAiConnectionConfig, resolveAudioHandling, runAiTask, splitMediaByKind, toVisionApiErrorMessage, transcribeAudio, transcribeAudios };

package/dist/common/aiApi/index.d.ts

@@ -0,0 +1,184 @@
+import { A as AiClientSettings, d as AiConnectionConfig, M as MultimodalChatParams, e as MultimodalChatResult, f as AiImageInput, g as AiAudioInput, h as AiMediaInput, c as AudioStrategy, i as AiTaskDefinition, j as AiTaskContext, a as AiApiResponse, T as TextCompletionInput, k as TextCompletionOutput, S as StructuredMultimodalInput, l as StructuredMultimodalOutput, C as ConnectivityTestOutput } from '../../types-CiqMQ-uu.js';
+export { p as AiApiErrorBody, q as AiApiErrorCode, r as AiApiResponseMeta, n as AiApiRunRequest, u as AiAudioMediaInput, m as AiConnectionSettings, t as AiImageMediaInput, s as AiMediaKind, y as AiModelsListRequest, b as AiModelsListResponse, o as AiTaskRunOptions, x as CORE_CONNECTIVITY_TEST_TASK_ID, v as CORE_LLM_COMPLETION_TASK_ID, w as CORE_STRUCTURED_MULTIMODAL_TASK_ID } from '../../types-CiqMQ-uu.js';
+import { R as RequestAdapter } from '../../types-CbTsi9CZ.js';
+
+/**
+ * 合并连接配置：显式 connection > clientSettings > 环境变量。
+ * 缺少 apiKey 时返回 null。
+ */
+declare function resolveAiConnectionConfig(...sources: Array<AiClientSettings | undefined>): AiConnectionConfig | null;
+declare function requireAiConnectionConfig(...sources: Array<AiClientSettings | undefined>): AiConnectionConfig;
+
+type JsonRequestOptions = {
+    url: string;
+    method?: 'GET' | 'POST' | 'PUT' | 'DELETE' | 'PATCH';
+    headers?: Record<string, string>;
+    body?: unknown;
+    timeoutMs?: number;
+    requestAdapter?: RequestAdapter;
+};
+declare function requestJson<T>(options: JsonRequestOptions): Promise<T>;
+
+declare const DEFAULT_OPENAI_BASE_URL = "https://api.openai.com/v1";
+declare const DEFAULT_TEXT_MODEL = "gpt-4o-mini";
+type ChatRole = 'system' | 'user' | 'assistant';
+interface ChatMessage {
+    role: ChatRole;
+    content: string;
+}
+interface CallChatOptions {
+    /** OpenAI 兼容 API Base URL */
+    baseUrl: string;
+    /** API Key */
+    apiKey: string;
+    model?: string;
+    systemPrompt?: string;
+    userPrompt?: string;
+    messages?: ChatMessage[];
+    temperature?: number;
+    maxTokens?: number;
+    topP?: number;
+    stop?: string | string[];
+    timeoutMs?: number;
+    requestAdapter?: RequestAdapter;
+}
+interface ChatUsage {
+    promptTokens?: number;
+    completionTokens?: number;
+    totalTokens?: number;
+}
+interface CallChatResult {
+    content: string;
+    model: string;
+    usage?: ChatUsage;
+    raw?: unknown;
+}
+/**
+ * OpenAI 兼容文本对话：外部传入 URL、Key、提示词，返回模型生成内容。
+ */
+declare function callChat(options: CallChatOptions): Promise<CallChatResult>;
+
+interface CallCompletionParams {
+    systemPrompt?: string;
+    userPrompt: string;
+    model?: string;
+    temperature?: number;
+    maxTokens?: number;
+    connection?: AiClientSettings;
+}
+interface CallCompletionResult {
+    content: string;
+    model: string;
+    raw?: unknown;
+}
+/**
+ * 文本补全：连接信息与提示词均由调用方传入（或通过 connection 合并 env）。
+ */
+declare function callCompletion(params: CallCompletionParams, clientSettings?: AiClientSettings): Promise<CallCompletionResult>;
+
+/**
+ * OpenAI 兼容多模态对话：文本 + 可选图片/语音。
+ * audioStrategy=auto 时：优先 chat 内嵌音频（native），失败或未支持则 STT 转写后走文本 chat。
+ */
+declare function callMultimodalChat(params: MultimodalChatParams, clientSettings?: AiClientSettings): Promise<MultimodalChatResult>;
+
+declare function extractJsonObject(text: string): Record<string, unknown>;
+
+declare function assertValidImageInput(image: AiImageInput, maxImageBytes?: number): void;
+declare function fileToAiImageInput(file: File): Promise<AiImageInput>;
+
+declare function mimeToAudioFormat(mimeType: string): string;
+declare function assertValidAudioInput(audio: AiAudioInput, maxAudioBytes?: number): void;
+declare function fileToAiAudioInput(file: File): Promise<AiAudioInput>;
+declare function base64ToBlob(base64: string, mimeType: string): Blob;
+
+declare function splitMediaByKind(media: AiMediaInput[]): {
+    images: AiMediaInput[];
+    audios: AiMediaInput[];
+};
+declare function assertValidMultimodalMedia(media: AiMediaInput[] | undefined, limits: {
+    maxImageBytes: number;
+    maxAudioBytes: number;
+    maxImages?: number;
+    maxAudios?: number;
+}): AiMediaInput[];
+
+type ResolvedAudioHandling = 'none' | 'native' | 'stt';
+declare function resolveAudioHandling(options: {
+    hasAudio: boolean;
+    strategy: AudioStrategy;
+    model: string;
+    baseUrl: string;
+}): ResolvedAudioHandling;
+declare function isAudioInputError(message: string): boolean;
+declare function appendTranscriptionsToPrompt(userPrompt: string, transcriptions: string[]): string;
+
+interface TranscribeAudioOptions {
+    audio: AiAudioInput;
+    config: AiConnectionConfig;
+    model?: string;
+    language?: string;
+}
+declare function transcribeAudio(options: TranscribeAudioOptions): Promise<string>;
+declare function transcribeAudios(audios: AiAudioInput[], config: AiConnectionConfig, model?: string): Promise<string[]>;
+
+declare function isLikelyNativeAudioChatModel(id: string): boolean;
+declare function isLikelySttModel(id: string): boolean;
+declare function filterSttModels(modelIds: string[]): string[];
+declare function pickDefaultSttModel(modelIds: string[], current?: string): string | undefined;
+declare function isLikelyVisionModel(id: string): boolean;
+declare function isKnownTextOnlyModel(id: string): boolean;
+declare function filterChatModels(modelIds: string[]): string[];
+declare function filterVisionModels(modelIds: string[]): string[];
+/** 从可用模型中挑选默认视觉模型 */
+declare function pickDefaultVisionModel(modelIds: string[], current?: string): string | undefined;
+
+type VisionMessageFormat = 'openai' | 'ollama';
+declare function detectVisionMessageFormat(baseUrl: string): VisionMessageFormat;
+declare function assertVisionCapableModel(modelId: string, options?: {
+    baseUrl?: string;
+    hasImages?: boolean;
+}): void;
+declare function isImageUrlVariantError(message: string): boolean;
+declare function toVisionApiErrorMessage(rawMessage: string, modelId: string): string;
+
+declare function buildMultimodalMessages(options: {
+    systemPrompt: string;
+    userPrompt: string;
+    images: AiMediaInput[];
+    nativeAudios: AiMediaInput[];
+    format: VisionMessageFormat;
+}): Array<Record<string, unknown>>;
+declare function assertMultimodalCapableModel(modelId: string, options: {
+    baseUrl?: string;
+    hasImages?: boolean;
+    hasNativeAudio?: boolean;
+}): void;
+
+interface ListModelsResult {
+    models: string[];
+    visionModels: string[];
+    suggestedVisionModel?: string;
+}
+declare function listOpenAiCompatibleModels(clientSettings?: AiClientSettings, currentVisionModel?: string): Promise<ListModelsResult>;
+
+declare function registerAiTask<TInput, TOutput>(task: AiTaskDefinition<TInput, TOutput>): void;
+declare function getAiTask(taskId: string): AiTaskDefinition | undefined;
+declare function listAiTasks(): string[];
+declare function clearAiTasksForTest(): void;
+
+declare function runAiTask<TData = unknown>(taskId: string, input: unknown, ctx?: AiTaskContext): Promise<AiApiResponse<TData>>;
+
+/** 注册内置通用 AI 任务（幂等） */
+declare function registerCoreAiTasks(): void;
+/** 别名：确保 core 任务已注册 */
+declare const ensureCoreAiTasksRegistered: typeof registerCoreAiTasks;
+declare function resetCoreAiTasksForTest(): void;
+
+declare const coreLlmCompletionTask: AiTaskDefinition<TextCompletionInput, TextCompletionOutput>;
+
+declare const coreStructuredMultimodalTask: AiTaskDefinition<StructuredMultimodalInput, StructuredMultimodalOutput>;
+
+declare const coreConnectivityTestTask: AiTaskDefinition<Record<string, never>, ConnectivityTestOutput>;
+
+export { AiApiResponse, AiAudioInput, AiClientSettings, AiConnectionConfig, AiImageInput, AiMediaInput, AiTaskContext, AiTaskDefinition, AudioStrategy, type CallChatOptions, type CallChatResult, type CallCompletionParams, type CallCompletionResult, type ChatMessage, type ChatRole, type ChatUsage, ConnectivityTestOutput, DEFAULT_OPENAI_BASE_URL, DEFAULT_TEXT_MODEL, type JsonRequestOptions, type ListModelsResult, MultimodalChatParams, MultimodalChatResult, type ResolvedAudioHandling, StructuredMultimodalInput, StructuredMultimodalOutput, TextCompletionInput, TextCompletionOutput, type TranscribeAudioOptions, type VisionMessageFormat, appendTranscriptionsToPrompt, assertMultimodalCapableModel, assertValidAudioInput, assertValidImageInput, assertValidMultimodalMedia, assertVisionCapableModel, base64ToBlob, buildMultimodalMessages, callChat, callCompletion, callMultimodalChat, clearAiTasksForTest, coreConnectivityTestTask, coreLlmCompletionTask, coreStructuredMultimodalTask, detectVisionMessageFormat, ensureCoreAiTasksRegistered, extractJsonObject, fileToAiAudioInput, fileToAiImageInput, filterChatModels, filterSttModels, filterVisionModels, getAiTask, isAudioInputError, isImageUrlVariantError, isKnownTextOnlyModel, isLikelyNativeAudioChatModel, isLikelySttModel, isLikelyVisionModel, listAiTasks, listOpenAiCompatibleModels, mimeToAudioFormat, pickDefaultSttModel, pickDefaultVisionModel, registerAiTask, registerCoreAiTasks, requestJson, requireAiConnectionConfig, resetCoreAiTasksForTest, resolveAiConnectionConfig, resolveAudioHandling, runAiTask, splitMediaByKind, toVisionApiErrorMessage, transcribeAudio, transcribeAudios };