sa2kit 3.4.0 → 3.6.0

package/dist/types-CiqMQ-uu.d.mts

@@ -0,0 +1,166 @@
+/** 音频处理策略：native=chat 内嵌音频，stt=先转写再 chat，auto=按模型能力自动选择（失败时 STT 回退） */
+type AudioStrategy = 'native' | 'stt' | 'auto';
+/** 连接配置（调用方可显式传入，或与 env 合并） */
+interface AiConnectionSettings {
+    apiKey: string;
+    baseUrl: string;
+    model?: string;
+    textModel?: string;
+    visionModel?: string;
+    audioModel?: string;
+    audioStrategy?: AudioStrategy;
+    timeoutMs?: number;
+    maxImageBytes?: number;
+    maxAudioBytes?: number;
+}
+/** 客户端/请求可携带的 AI 连接配置（字段均可选，用于覆盖环境变量） */
+type AiClientSettings = Partial<AiConnectionSettings>;
+/** 解析后的完整连接配置 */
+interface AiConnectionConfig extends AiConnectionSettings {
+    textModel: string;
+    visionModel: string;
+    audioModel: string;
+    audioStrategy: AudioStrategy;
+    timeoutMs: number;
+    maxImageBytes: number;
+    maxAudioBytes: number;
+}
+/** 统一 AI 任务请求 */
+interface AiApiRunRequest<TInput = unknown> {
+    taskId: string;
+    input: TInput;
+    options?: AiTaskRunOptions;
+    clientSettings?: AiClientSettings;
+}
+interface AiTaskRunOptions {
+    model?: string;
+    temperature?: number;
+    maxTokens?: number;
+}
+/** 统一 AI 任务响应 */
+interface AiApiResponse<TData = unknown> {
+    success: boolean;
+    taskId: string;
+    data?: TData;
+    error?: AiApiErrorBody;
+    meta?: AiApiResponseMeta;
+}
+interface AiApiErrorBody {
+    code: AiApiErrorCode;
+    message: string;
+    details?: unknown;
+}
+type AiApiErrorCode = 'UNAUTHORIZED' | 'INVALID_INPUT' | 'TASK_NOT_FOUND' | 'AI_CONFIG_MISSING' | 'AI_REQUEST_FAILED' | 'AI_PARSE_FAILED' | 'PAYLOAD_TOO_LARGE' | 'UNSUPPORTED_MEDIA';
+interface AiApiResponseMeta {
+    model: string;
+    latencyMs: number;
+    provider?: string;
+    confidence?: number;
+    rawSummary?: string;
+}
+/** 多模态图片输入（base64） */
+interface AiImageInput {
+    base64: string;
+    mimeType: string;
+}
+/** 多模态音频输入（base64） */
+interface AiAudioInput {
+    base64: string;
+    mimeType: string;
+}
+type AiMediaKind = 'image' | 'audio';
+interface AiImageMediaInput extends AiImageInput {
+    kind: 'image';
+}
+interface AiAudioMediaInput extends AiAudioInput {
+    kind: 'audio';
+}
+type AiMediaInput = AiImageMediaInput | AiAudioMediaInput;
+/** 通用文本补全任务输入 */
+interface TextCompletionInput {
+    systemPrompt?: string;
+    userPrompt: string;
+    model?: string;
+    temperature?: number;
+    maxTokens?: number;
+    /** 显式连接配置，优先级高于 clientSettings / 环境变量 */
+    connection?: AiClientSettings;
+}
+/** 通用文本补全任务输出 */
+interface TextCompletionOutput {
+    content: string;
+    rawText: string;
+}
+/** 通用结构化多模态任务输入 */
+interface StructuredMultimodalInput {
+    systemPrompt: string;
+    userPrompt: string;
+    media?: AiMediaInput[];
+    jsonSchemaHint?: string;
+    model?: string;
+    temperature?: number;
+    maxTokens?: number;
+    audioStrategy?: AudioStrategy;
+    connection?: AiClientSettings;
+}
+/** 通用结构化多模态任务输出 */
+interface StructuredMultimodalOutput {
+    json: Record<string, unknown>;
+    rawText: string;
+}
+declare const CORE_LLM_COMPLETION_TASK_ID = "core.llmCompletion";
+declare const CORE_STRUCTURED_MULTIMODAL_TASK_ID = "core.structuredMultimodal";
+declare const CORE_CONNECTIVITY_TEST_TASK_ID = "core.connectivityTest";
+interface ConnectivityTestOutput {
+    ok: boolean;
+    reply: string;
+}
+interface AiModelsListRequest {
+    clientSettings?: AiClientSettings;
+}
+interface AiModelsListResponse {
+    success: boolean;
+    models: string[];
+    visionModels: string[];
+    suggestedVisionModel?: string;
+    error?: {
+        code: string;
+        message: string;
+    };
+}
+interface AiTaskContext {
+    requestId?: string;
+    userId?: string | number;
+    clientSettings?: AiClientSettings;
+}
+interface AiTaskDefinition<TInput = unknown, TOutput = unknown> {
+    id: string;
+    description?: string;
+    validateInput: (input: unknown) => TInput;
+    execute: (input: TInput, ctx: AiTaskContext) => Promise<{
+        data: TOutput;
+        meta?: Partial<AiApiResponseMeta>;
+    }>;
+}
+interface MultimodalChatParams {
+    systemPrompt: string;
+    userPrompt: string;
+    media?: AiMediaInput[];
+    model?: string;
+    temperature?: number;
+    maxTokens?: number;
+    jsonMode?: boolean;
+    audioStrategy?: AudioStrategy;
+    connection?: AiClientSettings;
+}
+interface MultimodalChatResult {
+    content: string;
+    model: string;
+    raw: unknown;
+    /** auto/native/stt 实际采用的音频处理方式 */
+    audioHandling?: 'none' | 'native' | 'stt';
+    /** STT 或 native 失败回退时的转写文本 */
+    transcriptions?: string[];
+}
+
+export { type AiClientSettings as A, type ConnectivityTestOutput as C, type MultimodalChatParams as M, type StructuredMultimodalInput as S, type TextCompletionInput as T, type AiApiResponse as a, type AiModelsListResponse as b, type AudioStrategy as c, type AiConnectionConfig as d, type MultimodalChatResult as e, type AiImageInput as f, type AiAudioInput as g, type AiMediaInput as h, type AiTaskDefinition as i, type AiTaskContext as j, type TextCompletionOutput as k, type StructuredMultimodalOutput as l, type AiConnectionSettings as m, type AiApiRunRequest as n, type AiTaskRunOptions as o, type AiApiErrorBody as p, type AiApiErrorCode as q, type AiApiResponseMeta as r, type AiMediaKind as s, type AiImageMediaInput as t, type AiAudioMediaInput as u, CORE_LLM_COMPLETION_TASK_ID as v, CORE_STRUCTURED_MULTIMODAL_TASK_ID as w, CORE_CONNECTIVITY_TEST_TASK_ID as x, type AiModelsListRequest as y };

package/dist/types-CiqMQ-uu.d.ts

@@ -0,0 +1,166 @@
+/** 音频处理策略：native=chat 内嵌音频，stt=先转写再 chat，auto=按模型能力自动选择（失败时 STT 回退） */
+type AudioStrategy = 'native' | 'stt' | 'auto';
+/** 连接配置（调用方可显式传入，或与 env 合并） */
+interface AiConnectionSettings {
+    apiKey: string;
+    baseUrl: string;
+    model?: string;
+    textModel?: string;
+    visionModel?: string;
+    audioModel?: string;
+    audioStrategy?: AudioStrategy;
+    timeoutMs?: number;
+    maxImageBytes?: number;
+    maxAudioBytes?: number;
+}
+/** 客户端/请求可携带的 AI 连接配置（字段均可选，用于覆盖环境变量） */
+type AiClientSettings = Partial<AiConnectionSettings>;
+/** 解析后的完整连接配置 */
+interface AiConnectionConfig extends AiConnectionSettings {
+    textModel: string;
+    visionModel: string;
+    audioModel: string;
+    audioStrategy: AudioStrategy;
+    timeoutMs: number;
+    maxImageBytes: number;
+    maxAudioBytes: number;
+}
+/** 统一 AI 任务请求 */
+interface AiApiRunRequest<TInput = unknown> {
+    taskId: string;
+    input: TInput;
+    options?: AiTaskRunOptions;
+    clientSettings?: AiClientSettings;
+}
+interface AiTaskRunOptions {
+    model?: string;
+    temperature?: number;
+    maxTokens?: number;
+}
+/** 统一 AI 任务响应 */
+interface AiApiResponse<TData = unknown> {
+    success: boolean;
+    taskId: string;
+    data?: TData;
+    error?: AiApiErrorBody;
+    meta?: AiApiResponseMeta;
+}
+interface AiApiErrorBody {
+    code: AiApiErrorCode;
+    message: string;
+    details?: unknown;
+}
+type AiApiErrorCode = 'UNAUTHORIZED' | 'INVALID_INPUT' | 'TASK_NOT_FOUND' | 'AI_CONFIG_MISSING' | 'AI_REQUEST_FAILED' | 'AI_PARSE_FAILED' | 'PAYLOAD_TOO_LARGE' | 'UNSUPPORTED_MEDIA';
+interface AiApiResponseMeta {
+    model: string;
+    latencyMs: number;
+    provider?: string;
+    confidence?: number;
+    rawSummary?: string;
+}
+/** 多模态图片输入（base64） */
+interface AiImageInput {
+    base64: string;
+    mimeType: string;
+}
+/** 多模态音频输入（base64） */
+interface AiAudioInput {
+    base64: string;
+    mimeType: string;
+}
+type AiMediaKind = 'image' | 'audio';
+interface AiImageMediaInput extends AiImageInput {
+    kind: 'image';
+}
+interface AiAudioMediaInput extends AiAudioInput {
+    kind: 'audio';
+}
+type AiMediaInput = AiImageMediaInput | AiAudioMediaInput;
+/** 通用文本补全任务输入 */
+interface TextCompletionInput {
+    systemPrompt?: string;
+    userPrompt: string;
+    model?: string;
+    temperature?: number;
+    maxTokens?: number;
+    /** 显式连接配置，优先级高于 clientSettings / 环境变量 */
+    connection?: AiClientSettings;
+}
+/** 通用文本补全任务输出 */
+interface TextCompletionOutput {
+    content: string;
+    rawText: string;
+}
+/** 通用结构化多模态任务输入 */
+interface StructuredMultimodalInput {
+    systemPrompt: string;
+    userPrompt: string;
+    media?: AiMediaInput[];
+    jsonSchemaHint?: string;
+    model?: string;
+    temperature?: number;
+    maxTokens?: number;
+    audioStrategy?: AudioStrategy;
+    connection?: AiClientSettings;
+}
+/** 通用结构化多模态任务输出 */
+interface StructuredMultimodalOutput {
+    json: Record<string, unknown>;
+    rawText: string;
+}
+declare const CORE_LLM_COMPLETION_TASK_ID = "core.llmCompletion";
+declare const CORE_STRUCTURED_MULTIMODAL_TASK_ID = "core.structuredMultimodal";
+declare const CORE_CONNECTIVITY_TEST_TASK_ID = "core.connectivityTest";
+interface ConnectivityTestOutput {
+    ok: boolean;
+    reply: string;
+}
+interface AiModelsListRequest {
+    clientSettings?: AiClientSettings;
+}
+interface AiModelsListResponse {
+    success: boolean;
+    models: string[];
+    visionModels: string[];
+    suggestedVisionModel?: string;
+    error?: {
+        code: string;
+        message: string;
+    };
+}
+interface AiTaskContext {
+    requestId?: string;
+    userId?: string | number;
+    clientSettings?: AiClientSettings;
+}
+interface AiTaskDefinition<TInput = unknown, TOutput = unknown> {
+    id: string;
+    description?: string;
+    validateInput: (input: unknown) => TInput;
+    execute: (input: TInput, ctx: AiTaskContext) => Promise<{
+        data: TOutput;
+        meta?: Partial<AiApiResponseMeta>;
+    }>;
+}
+interface MultimodalChatParams {
+    systemPrompt: string;
+    userPrompt: string;
+    media?: AiMediaInput[];
+    model?: string;
+    temperature?: number;
+    maxTokens?: number;
+    jsonMode?: boolean;
+    audioStrategy?: AudioStrategy;
+    connection?: AiClientSettings;
+}
+interface MultimodalChatResult {
+    content: string;
+    model: string;
+    raw: unknown;
+    /** auto/native/stt 实际采用的音频处理方式 */
+    audioHandling?: 'none' | 'native' | 'stt';
+    /** STT 或 native 失败回退时的转写文本 */
+    transcriptions?: string[];
+}
+
+export { type AiClientSettings as A, type ConnectivityTestOutput as C, type MultimodalChatParams as M, type StructuredMultimodalInput as S, type TextCompletionInput as T, type AiApiResponse as a, type AiModelsListResponse as b, type AudioStrategy as c, type AiConnectionConfig as d, type MultimodalChatResult as e, type AiImageInput as f, type AiAudioInput as g, type AiMediaInput as h, type AiTaskDefinition as i, type AiTaskContext as j, type TextCompletionOutput as k, type StructuredMultimodalOutput as l, type AiConnectionSettings as m, type AiApiRunRequest as n, type AiTaskRunOptions as o, type AiApiErrorBody as p, type AiApiErrorCode as q, type AiApiResponseMeta as r, type AiMediaKind as s, type AiImageMediaInput as t, type AiAudioMediaInput as u, CORE_LLM_COMPLETION_TASK_ID as v, CORE_STRUCTURED_MULTIMODAL_TASK_ID as w, CORE_CONNECTIVITY_TEST_TASK_ID as x, type AiModelsListRequest as y };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sa2kit",
-  "version": "3.4.0",
+  "version": "3.6.0",
   "description": "SA2Kit 2.0 — common API 稳定；business 实验田模块逐步迁出 profile-v1",
   "keywords": [
     "react",
@@ -288,55 +288,20 @@
       "import": "./dist/business/vocaloidBooth/web/index.mjs",
       "require": "./dist/business/vocaloidBooth/web/index.js"
     },
-    "./common/ai/llm/core": {
-      "types": "./dist/common/ai/llm/core/index.d.ts",
-      "import": "./dist/common/ai/llm/core/index.mjs",
-      "require": "./dist/common/ai/llm/core/index.js"
-    },
-    "./common/ai/llm/electron": {
-      "types": "./dist/common/ai/llm/electron/index.d.ts",
-      "import": "./dist/common/ai/llm/electron/index.mjs",
-      "require": "./dist/common/ai/llm/electron/index.js"
-    },
-    "./common/ai/llm": {
-      "types": "./dist/common/ai/llm/index.d.ts",
-      "import": "./dist/common/ai/llm/index.mjs",
-      "require": "./dist/common/ai/llm/index.js"
-    },
-    "./common/ai/llm/miniapp": {
-      "types": "./dist/common/ai/llm/miniapp/index.d.ts",
-      "import": "./dist/common/ai/llm/miniapp/index.mjs",
-      "require": "./dist/common/ai/llm/miniapp/index.js"
-    },
-    "./common/ai/llm/rn": {
-      "types": "./dist/common/ai/llm/rn/index.d.ts",
-      "import": "./dist/common/ai/llm/rn/index.mjs",
-      "require": "./dist/common/ai/llm/rn/index.js"
-    },
-    "./common/ai/llm/ui/electron": {
-      "types": "./dist/common/ai/llm/ui/electron/index.d.ts",
-      "import": "./dist/common/ai/llm/ui/electron/index.mjs",
-      "require": "./dist/common/ai/llm/ui/electron/index.js"
-    },
-    "./common/ai/llm/ui/miniapp": {
-      "types": "./dist/common/ai/llm/ui/miniapp/index.d.ts",
-      "import": "./dist/common/ai/llm/ui/miniapp/index.mjs",
-      "require": "./dist/common/ai/llm/ui/miniapp/index.js"
-    },
-    "./common/ai/llm/ui/rn": {
-      "types": "./dist/common/ai/llm/ui/rn/index.d.ts",
-      "import": "./dist/common/ai/llm/ui/rn/index.mjs",
-      "require": "./dist/common/ai/llm/ui/rn/index.js"
-    },
-    "./common/ai/llm/ui/web": {
-      "types": "./dist/common/ai/llm/ui/web/index.d.ts",
-      "import": "./dist/common/ai/llm/ui/web/index.mjs",
-      "require": "./dist/common/ai/llm/ui/web/index.js"
-    },
-    "./common/ai/llm/web": {
-      "types": "./dist/common/ai/llm/web/index.d.ts",
-      "import": "./dist/common/ai/llm/web/index.mjs",
-      "require": "./dist/common/ai/llm/web/index.js"
+    "./common/aiApi/client": {
+      "types": "./dist/common/aiApi/client/index.d.ts",
+      "import": "./dist/common/aiApi/client/index.mjs",
+      "require": "./dist/common/aiApi/client/index.js"
+    },
+    "./common/aiApi": {
+      "types": "./dist/common/aiApi/index.d.ts",
+      "import": "./dist/common/aiApi/index.mjs",
+      "require": "./dist/common/aiApi/index.js"
+    },
+    "./common/aiApi/server": {
+      "types": "./dist/common/aiApi/server/index.d.ts",
+      "import": "./dist/common/aiApi/server/index.mjs",
+      "require": "./dist/common/aiApi/server/index.js"
     },
     "./common/analytics/server": {
       "types": "./dist/common/analytics/server/index.d.ts",

package/dist/chunk-3R6JHA6D.js

@@ -1,120 +0,0 @@
-'use strict';
-
-var react = require('react');
-
-// src/common/ai/llm/prompt/variables.ts
-var normalizePromptVariables = (variables = {}) => {
-  const normalized = {};
-  Object.entries(variables).forEach(([key, value]) => {
-    if (value === null || value === void 0) {
-      normalized[key] = "";
-    } else {
-      normalized[key] = String(value);
-    }
-  });
-  return normalized;
-};
-
-// src/common/ai/llm/prompt/template.ts
-var applyPromptTemplate = (template, variables = {}, options = {}) => {
-  if (!template) {
-    return "";
-  }
-  const resolved = normalizePromptVariables(variables);
-  const missingValue = options.missingValue ?? "";
-  return template.replace(/\{\{\s*([a-zA-Z0-9_.-]+)\s*\}\}/g, (_match, key) => {
-    if (Object.prototype.hasOwnProperty.call(resolved, key)) {
-      return resolved[key] ?? "";
-    }
-    return options.preserveUnknown ? `{{${key}}}` : missingValue;
-  });
-};
-var buildBaseMessages = (systemPrompt, initialMessages) => {
-  const baseMessages = [];
-  if (systemPrompt) {
-    baseMessages.push({ role: "system", content: systemPrompt });
-  }
-  if (initialMessages?.length) {
-    baseMessages.push(...initialMessages);
-  }
-  return baseMessages;
-};
-var useAiChat = (options) => {
-  const systemPromptRef = react.useRef(options.systemPrompt);
-  const templateRef = react.useRef(options.template);
-  const [messages, setMessages] = react.useState(
-    () => buildBaseMessages(systemPromptRef.current, options.initialMessages)
-  );
-  const messagesRef = react.useRef(messages);
-  const [status, setStatus] = react.useState("idle");
-  const [error, setError] = react.useState(null);
-  const [lastResponse, setLastResponse] = react.useState(null);
-  const syncMessages = (nextMessages) => {
-    messagesRef.current = nextMessages;
-    setMessages(nextMessages);
-  };
-  const reset = react.useCallback(() => {
-    syncMessages(buildBaseMessages(systemPromptRef.current, options.initialMessages));
-    setStatus("idle");
-    setError(null);
-    setLastResponse(null);
-  }, [options.initialMessages]);
-  const setSystemPrompt = react.useCallback(
-    (prompt) => {
-      systemPromptRef.current = prompt;
-      reset();
-    },
-    [reset]
-  );
-  const sendMessage = react.useCallback(
-    async (input, requestOptions = {}) => {
-      const { template, variables, ...chatOptions } = requestOptions;
-      const activeTemplate = template ?? templateRef.current;
-      const mergedVariables = { input, ...variables ?? {} };
-      const content = activeTemplate ? applyPromptTemplate(activeTemplate, mergedVariables) : input;
-      const userMessage = { role: "user", content };
-      const nextMessages = [...messagesRef.current, userMessage];
-      syncMessages(nextMessages);
-      setStatus("loading");
-      setError(null);
-      try {
-        const response = await options.client.sendChat({
-          messages: nextMessages,
-          ...chatOptions
-        });
-        const assistantMessage = response.message ?? {
-          role: "assistant",
-          content: response.content,
-          toolCalls: response.toolCalls
-        };
-        const updatedMessages = [...nextMessages, assistantMessage];
-        syncMessages(updatedMessages);
-        setStatus("success");
-        setLastResponse(response);
-        return response;
-      } catch (err) {
-        const nextError = err instanceof Error ? err : new Error(String(err));
-        setStatus("error");
-        setError(nextError);
-        throw nextError;
-      }
-    },
-    [options.client]
-  );
-  return {
-    status,
-    isLoading: status === "loading",
-    error,
-    messages,
-    lastResponse,
-    sendMessage,
-    reset,
-    setSystemPrompt
-  };
-};
-
-exports.applyPromptTemplate = applyPromptTemplate;
-exports.normalizePromptVariables = normalizePromptVariables;
-exports.useAiChat = useAiChat;
-//# sourceMappingURL=chunk-3R6JHA6D.js.map
-//# sourceMappingURL=chunk-3R6JHA6D.js.map

package/dist/chunk-3R6JHA6D.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/common/ai/llm/prompt/variables.ts","../src/common/ai/llm/prompt/template.ts","../src/common/ai/llm/hooks/useAiChat.ts"],"names":["useRef","useState","useCallback"],"mappings":"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","file":"chunk-3R6JHA6D.js","sourcesContent":["export type PromptVariableValue = string | number | boolean | null | undefined;\n\nexport type PromptVariables = Record<string, PromptVariableValue>;\n\nexport const normalizePromptVariables = (\n  variables: PromptVariables = {}\n): Record<string, string> => {\n  const normalized: Record<string, string> = {};\n\n  Object.entries(variables).forEach(([key, value]) => {\n    if (value === null || value === undefined) {\n      normalized[key] = '';\n    } else {\n      normalized[key] = String(value);\n    }\n  });\n\n  return normalized;\n};\n","import { normalizePromptVariables, PromptVariables } from './variables';\n\nexport interface PromptTemplateOptions {\n  missingValue?: string;\n  preserveUnknown?: boolean;\n}\n\nexport const applyPromptTemplate = (\n  template: string,\n  variables: PromptVariables = {},\n  options: PromptTemplateOptions = {}\n): string => {\n  if (!template) {\n    return '';\n  }\n\n  const resolved = normalizePromptVariables(variables);\n  const missingValue = options.missingValue ?? '';\n\n  return template.replace(/\\{\\{\\s*([a-zA-Z0-9_.-]+)\\s*\\}\\}/g, (_match, key: string) => {\n    if (Object.prototype.hasOwnProperty.call(resolved, key)) {\n      return resolved[key] ?? '';\n    }\n\n    return options.preserveUnknown ? `{{${key}}}` : missingValue;\n  });\n};\n","import { useCallback, useRef, useState } from 'react';\nimport { applyPromptTemplate } from '../prompt/template';\nimport type {\n  AiChatInputOptions,\n  AiChatResponse,\n  AiChatStatus,\n  AiClient,\n  AiMessage,\n} from '../types';\n\nexport interface UseAiChatOptions {\n  client: AiClient;\n  systemPrompt?: string;\n  template?: string;\n  initialMessages?: AiMessage[];\n}\n\nconst buildBaseMessages = (systemPrompt?: string, initialMessages?: AiMessage[]): AiMessage[] => {\n  const baseMessages: AiMessage[] = [];\n  if (systemPrompt) {\n    baseMessages.push({ role: 'system', content: systemPrompt });\n  }\n  if (initialMessages?.length) {\n    baseMessages.push(...initialMessages);\n  }\n  return baseMessages;\n};\n\nexport const useAiChat = (options: UseAiChatOptions) => {\n  const systemPromptRef = useRef(options.systemPrompt);\n  const templateRef = useRef(options.template);\n  const [messages, setMessages] = useState<AiMessage[]>(() =>\n    buildBaseMessages(systemPromptRef.current, options.initialMessages)\n  );\n  const messagesRef = useRef(messages);\n  const [status, setStatus] = useState<AiChatStatus>('idle');\n  const [error, setError] = useState<Error | null>(null);\n  const [lastResponse, setLastResponse] = useState<AiChatResponse | null>(null);\n\n  const syncMessages = (nextMessages: AiMessage[]) => {\n    messagesRef.current = nextMessages;\n    setMessages(nextMessages);\n  };\n\n  const reset = useCallback(() => {\n    syncMessages(buildBaseMessages(systemPromptRef.current, options.initialMessages));\n    setStatus('idle');\n    setError(null);\n    setLastResponse(null);\n  }, [options.initialMessages]);\n\n  const setSystemPrompt = useCallback(\n    (prompt?: string) => {\n      systemPromptRef.current = prompt;\n      reset();\n    },\n    [reset]\n  );\n\n  const sendMessage = useCallback(\n    async (input: string, requestOptions: AiChatInputOptions = {}) => {\n      const { template, variables, ...chatOptions } = requestOptions;\n      const activeTemplate = template ?? templateRef.current;\n      const mergedVariables = { input, ...(variables ?? {}) };\n      const content = activeTemplate ? applyPromptTemplate(activeTemplate, mergedVariables) : input;\n\n      const userMessage: AiMessage = { role: 'user', content };\n      const nextMessages = [...messagesRef.current, userMessage];\n      syncMessages(nextMessages);\n      setStatus('loading');\n      setError(null);\n\n      try {\n        const response = await options.client.sendChat({\n          messages: nextMessages,\n          ...chatOptions,\n        });\n\n        const assistantMessage: AiMessage =\n          response.message ?? {\n            role: 'assistant',\n            content: response.content,\n            toolCalls: response.toolCalls,\n          };\n        const updatedMessages = [...nextMessages, assistantMessage];\n        syncMessages(updatedMessages);\n        setStatus('success');\n        setLastResponse(response);\n        return response;\n      } catch (err) {\n        const nextError = err instanceof Error ? err : new Error(String(err));\n        setStatus('error');\n        setError(nextError);\n        throw nextError;\n      }\n    },\n    [options.client]\n  );\n\n  return {\n    status,\n    isLoading: status === 'loading',\n    error,\n    messages,\n    lastResponse,\n    sendMessage,\n    reset,\n    setSystemPrompt,\n  };\n};\n"]}

package/dist/chunk-4PJM4752.js

@@ -1,4 +0,0 @@
-'use strict';
-
-//# sourceMappingURL=chunk-4PJM4752.js.map
-//# sourceMappingURL=chunk-4PJM4752.js.map

package/dist/chunk-4PJM4752.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":[],"names":[],"mappings":"","file":"chunk-4PJM4752.js"}