@opentiny/tiny-robot-kit 0.4.0 → 0.4.1-alpha.0

package/dist/types-CePh-Jcx.d.mts

@@ -0,0 +1,212 @@
+/**
+ * 模型Provider基类
+ */
+declare abstract class BaseModelProvider {
+    protected config: AIModelConfig;
+    /**
+     * @param config AI模型配置
+     */
+    constructor(config: AIModelConfig);
+    /**
+     * 发送聊天请求并获取响应
+     * @param request 聊天请求参数
+     * @returns 聊天响应
+     */
+    abstract chat(request: ChatCompletionRequest): Promise<ChatCompletionResponse>;
+    /**
+     * 发送流式聊天请求并通过处理器处理响应
+     * @param request 聊天请求参数
+     * @param handler 流式响应处理器
+     */
+    abstract chatStream(request: ChatCompletionRequest, handler: StreamHandler): Promise<void>;
+    /**
+     * 更新配置
+     * @param config 新的AI模型配置
+     */
+    updateConfig(config: AIModelConfig): void;
+    /**
+     * 获取当前配置
+     * @returns AI模型配置
+     */
+    getConfig(): AIModelConfig;
+    /**
+     * 验证请求参数
+     * @param request 聊天请求参数
+     */
+    protected validateRequest(request: ChatCompletionRequest): void;
+}
+
+type MaybePromise<T> = T | Promise<T>;
+/**
+ * 消息角色类型
+ */
+type MessageRole = 'system' | 'user' | 'assistant';
+interface ToolCall {
+    index: number;
+    id: string;
+    type: 'function';
+    function: {
+        name: string;
+        arguments: string;
+        result?: string;
+    };
+}
+interface MessageMetadata {
+    createdAt?: number;
+    updatedAt?: number;
+    id?: string;
+    model?: string;
+    [key: string]: any;
+}
+/**
+ * 聊天消息接口
+ */
+interface ChatMessage {
+    role: string;
+    content: string;
+    reasoning_content?: string;
+    metadata?: MessageMetadata;
+    tool_calls?: ToolCall[];
+    tool_call_id?: string;
+    [key: string]: any;
+    [key: symbol]: any;
+}
+/**
+ * 聊天历史记录
+ */
+type ChatHistory = ChatMessage[];
+/**
+ * 聊天完成请求选项
+ */
+interface ChatCompletionOptions {
+    model?: string;
+    temperature?: number;
+    top_p?: number;
+    n?: number;
+    stream?: boolean;
+    max_tokens?: number;
+    signal?: AbortSignal;
+}
+/**
+ * 聊天完成请求参数
+ */
+interface ChatCompletionRequest {
+    messages: ChatMessage[];
+    options?: ChatCompletionOptions;
+}
+/**
+ * 聊天完成响应消息
+ */
+interface ChatCompletionResponseMessage {
+    role: MessageRole;
+    content: string;
+    [x: string]: unknown;
+}
+/**
+ * 聊天完成响应选择
+ */
+interface ChatCompletionResponseChoice {
+    index: number;
+    message: ChatCompletionResponseMessage;
+    finish_reason: string;
+}
+/**
+ * 聊天完成响应使用情况
+ */
+interface ChatCompletionResponseUsage {
+    prompt_tokens: number;
+    completion_tokens: number;
+    total_tokens: number;
+}
+/**
+ * 聊天完成响应
+ */
+interface ChatCompletionResponse {
+    id: string;
+    object: string;
+    created: number;
+    model: string;
+    choices: ChatCompletionResponseChoice[];
+    usage: ChatCompletionResponseUsage;
+}
+/**
+ * 流式聊天完成响应增量
+ */
+interface ChatCompletionStreamResponseDelta {
+    content?: string;
+    role?: MessageRole;
+    [x: string]: unknown;
+}
+/**
+ * 流式聊天完成响应选择
+ */
+interface ChatCompletionStreamResponseChoice {
+    index: number;
+    delta: ChatCompletionStreamResponseDelta;
+    finish_reason: string | null;
+}
+/**
+ * 流式聊天完成响应
+ */
+interface ChatCompletionStreamResponse {
+    id: string;
+    object: string;
+    created: number;
+    model: string;
+    choices: ChatCompletionStreamResponseChoice[];
+}
+/**
+ * AI模型提供商类型
+ */
+type AIProvider = 'openai' | 'deepseek' | 'custom';
+/**
+ * AI模型配置接口
+ */
+interface AIModelConfig {
+    provider: AIProvider;
+    providerImplementation?: BaseModelProvider;
+    apiKey?: string;
+    apiUrl?: string;
+    apiVersion?: string;
+    defaultModel?: string;
+    defaultOptions?: ChatCompletionOptions;
+}
+/**
+ * 错误类型
+ */
+declare enum ErrorType {
+    NETWORK_ERROR = "network_error",
+    AUTHENTICATION_ERROR = "authentication_error",
+    RATE_LIMIT_ERROR = "rate_limit_error",
+    SERVER_ERROR = "server_error",
+    MODEL_ERROR = "model_error",
+    TIMEOUT_ERROR = "timeout_error",
+    UNKNOWN_ERROR = "unknown_error"
+}
+/**
+ * AI适配器错误
+ */
+interface AIAdapterError {
+    type: ErrorType;
+    message: string;
+    statusCode?: number;
+    originalError?: object;
+}
+/**
+ * 流式响应事件类型
+ */
+declare enum StreamEventType {
+    DATA = "data",
+    ERROR = "error",
+    DONE = "done"
+}
+/**
+ * 流式响应处理器
+ */
+interface StreamHandler {
+    onData: (data: ChatCompletionStreamResponse) => void;
+    onError: (error: AIAdapterError) => void;
+    onDone: (finishReason?: string) => void;
+}
+
+export { type AIAdapterError as A, BaseModelProvider as B, type ChatCompletionOptions as C, ErrorType as E, type MaybePromise as M, StreamEventType as S, type ToolCall as T, type AIModelConfig as a, type AIProvider as b, type ChatCompletionRequest as c, type ChatCompletionResponse as d, type ChatCompletionResponseChoice as e, type ChatCompletionResponseMessage as f, type ChatCompletionResponseUsage as g, type ChatCompletionStreamResponse as h, type ChatCompletionStreamResponseChoice as i, type ChatCompletionStreamResponseDelta as j, type ChatHistory as k, type ChatMessage as l, type MessageMetadata as m, type MessageRole as n, type StreamHandler as o };

package/dist/types-CePh-Jcx.d.ts

@@ -0,0 +1,212 @@
+/**
+ * 模型Provider基类
+ */
+declare abstract class BaseModelProvider {
+    protected config: AIModelConfig;
+    /**
+     * @param config AI模型配置
+     */
+    constructor(config: AIModelConfig);
+    /**
+     * 发送聊天请求并获取响应
+     * @param request 聊天请求参数
+     * @returns 聊天响应
+     */
+    abstract chat(request: ChatCompletionRequest): Promise<ChatCompletionResponse>;
+    /**
+     * 发送流式聊天请求并通过处理器处理响应
+     * @param request 聊天请求参数
+     * @param handler 流式响应处理器
+     */
+    abstract chatStream(request: ChatCompletionRequest, handler: StreamHandler): Promise<void>;
+    /**
+     * 更新配置
+     * @param config 新的AI模型配置
+     */
+    updateConfig(config: AIModelConfig): void;
+    /**
+     * 获取当前配置
+     * @returns AI模型配置
+     */
+    getConfig(): AIModelConfig;
+    /**
+     * 验证请求参数
+     * @param request 聊天请求参数
+     */
+    protected validateRequest(request: ChatCompletionRequest): void;
+}
+
+type MaybePromise<T> = T | Promise<T>;
+/**
+ * 消息角色类型
+ */
+type MessageRole = 'system' | 'user' | 'assistant';
+interface ToolCall {
+    index: number;
+    id: string;
+    type: 'function';
+    function: {
+        name: string;
+        arguments: string;
+        result?: string;
+    };
+}
+interface MessageMetadata {
+    createdAt?: number;
+    updatedAt?: number;
+    id?: string;
+    model?: string;
+    [key: string]: any;
+}
+/**
+ * 聊天消息接口
+ */
+interface ChatMessage {
+    role: string;
+    content: string;
+    reasoning_content?: string;
+    metadata?: MessageMetadata;
+    tool_calls?: ToolCall[];
+    tool_call_id?: string;
+    [key: string]: any;
+    [key: symbol]: any;
+}
+/**
+ * 聊天历史记录
+ */
+type ChatHistory = ChatMessage[];
+/**
+ * 聊天完成请求选项
+ */
+interface ChatCompletionOptions {
+    model?: string;
+    temperature?: number;
+    top_p?: number;
+    n?: number;
+    stream?: boolean;
+    max_tokens?: number;
+    signal?: AbortSignal;
+}
+/**
+ * 聊天完成请求参数
+ */
+interface ChatCompletionRequest {
+    messages: ChatMessage[];
+    options?: ChatCompletionOptions;
+}
+/**
+ * 聊天完成响应消息
+ */
+interface ChatCompletionResponseMessage {
+    role: MessageRole;
+    content: string;
+    [x: string]: unknown;
+}
+/**
+ * 聊天完成响应选择
+ */
+interface ChatCompletionResponseChoice {
+    index: number;
+    message: ChatCompletionResponseMessage;
+    finish_reason: string;
+}
+/**
+ * 聊天完成响应使用情况
+ */
+interface ChatCompletionResponseUsage {
+    prompt_tokens: number;
+    completion_tokens: number;
+    total_tokens: number;
+}
+/**
+ * 聊天完成响应
+ */
+interface ChatCompletionResponse {
+    id: string;
+    object: string;
+    created: number;
+    model: string;
+    choices: ChatCompletionResponseChoice[];
+    usage: ChatCompletionResponseUsage;
+}
+/**
+ * 流式聊天完成响应增量
+ */
+interface ChatCompletionStreamResponseDelta {
+    content?: string;
+    role?: MessageRole;
+    [x: string]: unknown;
+}
+/**
+ * 流式聊天完成响应选择
+ */
+interface ChatCompletionStreamResponseChoice {
+    index: number;
+    delta: ChatCompletionStreamResponseDelta;
+    finish_reason: string | null;
+}
+/**
+ * 流式聊天完成响应
+ */
+interface ChatCompletionStreamResponse {
+    id: string;
+    object: string;
+    created: number;
+    model: string;
+    choices: ChatCompletionStreamResponseChoice[];
+}
+/**
+ * AI模型提供商类型
+ */
+type AIProvider = 'openai' | 'deepseek' | 'custom';
+/**
+ * AI模型配置接口
+ */
+interface AIModelConfig {
+    provider: AIProvider;
+    providerImplementation?: BaseModelProvider;
+    apiKey?: string;
+    apiUrl?: string;
+    apiVersion?: string;
+    defaultModel?: string;
+    defaultOptions?: ChatCompletionOptions;
+}
+/**
+ * 错误类型
+ */
+declare enum ErrorType {
+    NETWORK_ERROR = "network_error",
+    AUTHENTICATION_ERROR = "authentication_error",
+    RATE_LIMIT_ERROR = "rate_limit_error",
+    SERVER_ERROR = "server_error",
+    MODEL_ERROR = "model_error",
+    TIMEOUT_ERROR = "timeout_error",
+    UNKNOWN_ERROR = "unknown_error"
+}
+/**
+ * AI适配器错误
+ */
+interface AIAdapterError {
+    type: ErrorType;
+    message: string;
+    statusCode?: number;
+    originalError?: object;
+}
+/**
+ * 流式响应事件类型
+ */
+declare enum StreamEventType {
+    DATA = "data",
+    ERROR = "error",
+    DONE = "done"
+}
+/**
+ * 流式响应处理器
+ */
+interface StreamHandler {
+    onData: (data: ChatCompletionStreamResponse) => void;
+    onError: (error: AIAdapterError) => void;
+    onDone: (finishReason?: string) => void;
+}
+
+export { type AIAdapterError as A, BaseModelProvider as B, type ChatCompletionOptions as C, ErrorType as E, type MaybePromise as M, StreamEventType as S, type ToolCall as T, type AIModelConfig as a, type AIProvider as b, type ChatCompletionRequest as c, type ChatCompletionResponse as d, type ChatCompletionResponseChoice as e, type ChatCompletionResponseMessage as f, type ChatCompletionResponseUsage as g, type ChatCompletionStreamResponse as h, type ChatCompletionStreamResponseChoice as i, type ChatCompletionStreamResponseDelta as j, type ChatHistory as k, type ChatMessage as l, type MessageMetadata as m, type MessageRole as n, type StreamHandler as o };

package/package.json

@@ -1,27 +1,69 @@
 {
   "name": "@opentiny/tiny-robot-kit",
-  "version": "0.4.0",
+  "version": "0.4.1-alpha.0",
+  "homepage": "https://docs.opentiny.design/tiny-robot/",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/opentiny/tiny-robot.git"
+  },
+  "bugs": {
+    "url": "https://github.com/opentiny/tiny-robot/issues"
+  },
   "publishConfig": {
     "access": "public"
   },
   "description": "AI大模型请求与数据处理工具包",
+  "keywords": [
+    "vue",
+    "vue3",
+    "ai",
+    "ai-client",
+    "ai-sdk",
+    "chat",
+    "chatbot",
+    "llm",
+    "openai",
+    "assistant",
+    "streaming",
+    "composables",
+    "conversation",
+    "model-provider",
+    "tiny-robot",
+    "opentiny"
+  ],
   "main": "dist/index.js",
   "module": "dist/index.mjs",
   "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js"
+    },
+    "./core": {
+      "types": "./dist/core.d.ts",
+      "import": "./dist/core.mjs",
+      "require": "./dist/core.js"
+    }
+  },
   "files": [
     "dist"
   ],
   "sideEffects": false,
   "scripts": {
-    "build": "tsup src/index.ts --format cjs,esm --dts --minify",
-    "dev": "tsup src/index.ts --format cjs,esm --dts --watch"
+    "build": "tsup src/index.ts src/core.ts --format cjs,esm --dts --minify",
+    "dev": "tsup src/index.ts src/core.ts --format cjs,esm --dts --watch",
+    "test": "vitest run",
+    "test:watch": "vitest"
   },
   "author": "",
   "license": "MIT",
   "devDependencies": {
     "@types/node": "^22.13.17",
+    "openai": "^6.34.0",
     "tsup": "^8.0.1",
-    "typescript": "^5.8.2"
+    "typescript": "^5.8.2",
+    "vitest": "^4.1.4"
   },
   "peerDependencies": {
     "vue": ">=3.0.0"
@@ -29,5 +71,5 @@
   "dependencies": {
     "idb": "^8.0.3"
   },
-  "gitHead": "558095a424930d99e079e6e1cf4fe8929d48c7b2"
+  "gitHead": "22cb4503b47f2e1d2134d4a90d02b5643672ef6c"
 }