ai-client-sdk 3.0.0

package/dist/index.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Copyright 2025 Hughe5
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+export { tools } from './utils/tools';
+export { Agent, type Message, type StreamResult, type AssistantMessage } from './utils/agent';
+interface Config {
+    container: HTMLElement | null;
+}
+export declare class AIChatPanel {
+    on: <T extends "send" | "create">(type: T, listener: (...args: {
+        send: [message: import(".").Message];
+        create: [];
+    }[T]) => void | Promise<void>) => void;
+    pushMessage: (message: import(".").Message | undefined) => void;
+    pushMessages: (messages: import(".").Message[]) => void;
+    pushLoadingMessage: () => void;
+    updateLoadingMessageReasoningContent: (content: string) => void;
+    updateLoadingMessageContent: (content: string) => void;
+    finishLoadingMessage: () => void;
+    constructor(config: Config);
+}

package/dist/utils/agent.d.ts

@@ -0,0 +1,168 @@
+/**
+ * Copyright 2025 Hughe5
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import Ajv from 'ajv';
+declare function abort(): void;
+interface StringParameter {
+    type: 'string';
+    description?: string;
+    enum?: string[];
+    pattern?: string;
+    format?: string;
+    default?: string;
+    minLength?: number;
+    maxLength?: number;
+}
+interface NumberParameter {
+    type: 'number' | 'integer';
+    description?: string;
+    enum?: number[];
+    minimum?: number;
+    maximum?: number;
+    default?: number;
+    exclusiveMinimum?: number;
+    exclusiveMaximum?: number;
+    multipleOf?: number;
+}
+interface BooleanParameter {
+    type: 'boolean';
+    description?: string;
+    default?: boolean;
+}
+interface ArrayParameter {
+    type: 'array';
+    description?: string;
+    items: Parameters;
+    minItems?: number;
+    maxItems?: number;
+    uniqueItems?: boolean;
+    default?: unknown[];
+}
+interface ObjectParameter {
+    type: 'object';
+    description?: string;
+    properties: Record<string, Parameters>;
+    required?: string[];
+    default?: Record<string, unknown>;
+    additionalProperties?: boolean;
+}
+type Parameters = StringParameter | NumberParameter | BooleanParameter | ArrayParameter | ObjectParameter;
+type DefinitionType = 'function';
+interface Definition {
+    type: DefinitionType;
+    function: {
+        name: string;
+        description: string;
+        parameters: Extract<Parameters, {
+            type: 'object';
+        }>;
+    };
+}
+type ParamType<T extends Parameters> = T extends {
+    type: 'string';
+} ? string : T extends {
+    type: 'number' | 'integer';
+} ? number : T extends {
+    type: 'boolean';
+} ? boolean : T extends {
+    type: 'array';
+    items: infer I;
+} ? I extends Parameters ? ParamType<I>[] : never : T extends {
+    type: 'object';
+    properties: infer P;
+    required?: infer R;
+} ? RequiredKeys<P extends Record<string, Parameters> ? P : never, R extends readonly string[] | undefined ? R : undefined> : never;
+type RequiredKeysWithRequired<P extends Record<string, Parameters>, R extends string[]> = {
+    [K in Extract<keyof P, R[number]>]: ParamType<P[K]>;
+} & {
+    [K in Exclude<keyof P, R[number]>]?: ParamType<P[K]>;
+};
+type RequiredKeysNoRequired<P extends Record<string, Parameters>> = {
+    [K in keyof P]?: ParamType<P[K]>;
+};
+type RequiredKeys<P extends Record<string, Parameters>, R extends readonly string[] | undefined> = R extends string[] ? RequiredKeysWithRequired<P, R> : RequiredKeysNoRequired<P>;
+type Args<T extends Definition> = ParamType<T['function']['parameters']>;
+type Handler<T extends Definition> = (args: Args<T>) => string | Promise<string>;
+type Tool<T extends Definition = Definition> = {
+    def: T;
+    handler: Handler<T>;
+};
+declare class ToolManager {
+    protected tools: Record<string, Tool>;
+    protected ajv: Ajv;
+    private validatorCache;
+    register<T extends Definition>(def: T, handler: Handler<T>): void;
+    getDefinition(name: string): Definition;
+    getHandler(name: string): Handler<Definition>;
+    remove(name: string): void;
+    get definitions(): Definition[];
+    getDefinitions(names: string[]): Definition[];
+    private getValidator;
+    validate(name: string, args: unknown): boolean;
+    call<T extends Definition>(name: string, args: Args<T>): Promise<string>;
+}
+interface Config {
+    model: string;
+    url: string;
+    systemMessageContent?: string;
+    maxRounds?: number;
+}
+type ToolCall = {
+    id: string;
+    function: {
+        name: string;
+        arguments: string;
+    };
+};
+interface SimpleMessage {
+    role: 'system' | 'user';
+    content: string;
+}
+interface AssistantMessage {
+    role: 'assistant';
+    content: string;
+    reasoning_content?: string;
+    tool_calls?: ToolCall[] | null;
+}
+interface ToolMessage {
+    role: 'tool';
+    content: string;
+    tool_call_id: string;
+}
+type Message = SimpleMessage | AssistantMessage | ToolMessage;
+interface Params {
+    tools?: string[];
+    roundsLeft?: number;
+}
+interface Chunk {
+    choices: Array<{
+        delta: AssistantMessage;
+    }>;
+}
+type StreamResult = AsyncGenerator<Chunk, AssistantMessage | StreamResult | undefined, void>;
+declare class Agent extends ToolManager {
+    model: string;
+    url: string;
+    messages: Message[];
+    maxRounds: number;
+    defaultParams: Params;
+    constructor(config: Config);
+    pushMessage(message: Message): void;
+    pushMessages(messages: Message[]): void;
+    merge<T extends object, S extends object>(target: T | null, source: S, fieldsToConcat?: (keyof (T & S))[]): T & S;
+    invoke(params?: Params): Promise<AssistantMessage | undefined>;
+    invokeStream(params?: Params): StreamResult;
+}
+export { type Parameters, type Definition, type Args, type Handler, type Message, type AssistantMessage, type StreamResult, abort, ToolManager, Agent, };

package/dist/utils/time.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Copyright 2025 Hughe5
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+export declare function parseRelativeDate(text: string): string;

package/dist/utils/tools.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Copyright 2025 Hughe5
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+export declare const tools: {
+    parse_relative_date: {
+        def: {
+            type: "function";
+            function: {
+                name: string;
+                description: string;
+                parameters: {
+                    type: "object";
+                    properties: {
+                        input: {
+                            type: "string";
+                            description: string;
+                        };
+                    };
+                    required: string[];
+                };
+            };
+        };
+        handler: (params: {
+            input: string;
+        }) => string;
+    };
+};

package/dist/view/dom.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Copyright 2025 Hughe5
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import type { Message } from '../utils/agent';
+interface Elements {
+    root: ShadowRoot;
+    userInputContainer: HTMLElement;
+    userInput: HTMLTextAreaElement;
+    submitIcon: HTMLButtonElement;
+    stopIcon: HTMLButtonElement;
+    messagesContainer: HTMLElement;
+    createButton: HTMLButtonElement;
+}
+declare function cacheElements(root: ShadowRoot): Elements;
+declare function getElements(): Elements;
+declare class MessagesContainerRender {
+    #private;
+    createCopyButton(message: Message): Element | null;
+    createMessage(message: Message): HTMLDivElement;
+    updateMessageContent(messageElement: Element, content: string): void;
+    pushMessage: (message: Message | undefined) => void;
+    pushMessages: (messages: Message[]) => void;
+    pushLoadingMessage: () => void;
+    finishLoadingMessage: () => void;
+    updateLoadingMessageContent: (content: string) => void;
+    updateLoadingMessageReasoningContent: (content: string) => void;
+    clear(): void;
+    setPaddingBottom(): void;
+}
+declare const userInputRender: {
+    value: string;
+    clear(): void;
+    focus(): void;
+};
+declare const buttonRender: {
+    default(): void;
+    chatting(): void;
+};
+declare const alertRender: {
+    show(text: string): void;
+};
+declare const messagesContainerRender: MessagesContainerRender;
+export { cacheElements, getElements, messagesContainerRender, userInputRender, buttonRender, alertRender, };

package/dist/view/event.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Copyright 2025 Hughe5
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import { type Message } from '../utils/agent';
+declare function bindEvents(): void;
+type EventType = 'send' | 'create';
+type EventParams = {
+    send: [message: Message];
+    create: [];
+};
+type EventListener<T extends EventType> = (...args: EventParams[T]) => void | Promise<void>;
+declare class EventManager {
+    private events;
+    on: <T extends EventType>(type: T, listener: EventListener<T>) => void;
+    emit: <T extends EventType>(type: T, ...args: EventParams[T]) => Promise<void>;
+}
+declare const eventManager: EventManager;
+export { bindEvents, eventManager };

package/dist/view/index.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Copyright 2025 Hughe5
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+export declare const init: (root: ShadowRoot) => void;

package/dist/view/template.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Copyright 2025 Hughe5
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+declare const template: HTMLTemplateElement;
+export { template };

package/package.json

@@ -0,0 +1,94 @@
+{
+  "name": "ai-client-sdk",
+  "version": "3.0.0",
+  "description": "一款 AI 集成套件，适配任意前端框架，兼容多种大模型、聊天面板、Function Calling、Agent、工作流等。",
+  "author": {
+    "name": "Hughe5",
+    "email": "2100921003@qq.com",
+    "url": "https://github.com/Hughe5"
+  },
+  "contributors": [
+    {
+      "name": "shichzh",
+      "email": "1767604480@qq.com",
+      "url": "https://github.com/shichzh"
+    }
+  ],
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/shichzh/ai-client-sdk.git"
+  },
+  "types": "dist/index.d.ts",
+  "main": "./dist/ai-client-sdk.umd.js",
+  "module": "./dist/ai-client-sdk.mjs",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/ai-client-sdk.mjs",
+      "require": "./dist/ai-client-sdk.umd.js"
+    }
+  },
+  "files": [
+    "dist",
+    "LICENSE",
+    "README.md"
+  ],
+  "scripts": {
+    "dev": "vite",
+    "build": "vite build && tsc -p tsconfig.build.json",
+    "lint": "eslint . --ext .js,.mjs,.cjs,.ts,.tsx --fix",
+    "lint:check": "eslint . --ext .js,.mjs,.cjs,.ts,.tsx",
+    "format": "prettier . --write",
+    "format:check": "prettier . --check",
+    "test": "vitest",
+    "test:run": "vitest run",
+    "test:coverage": "vitest run --coverage",
+    "check-license": "addlicense -check -c \"Hughe5\" -l apache \"examples\" \"src\""
+  },
+  "keywords": [
+    "ai",
+    "artificial-intelligence",
+    "ai-sdk",
+    "ai-integration",
+    "function-calling",
+    "chatbot",
+    "multi-model",
+    "frontend",
+    "frontend-sdk",
+    "web-sdk",
+    "llm",
+    "large-language-model",
+    "openai-compatible",
+    "ai-client",
+    "chat",
+    "ai-chat",
+    "ai-tools",
+    "pure-javascript"
+  ],
+  "dependencies": {
+    "ajv": "^8.17.1",
+    "chrono-node": "^2.8.3",
+    "dayjs": "^1.11.13",
+    "dompurify": "^3.2.7",
+    "lodash-es": "^4.17.21",
+    "prettier": "^3.6.2",
+    "rehype-stringify": "^10.0.1",
+    "remark-gfm": "^4.0.1",
+    "remark-parse": "^11.0.0",
+    "remark-rehype": "^11.1.2",
+    "unified": "^11.0.5",
+    "unist-util-visit": "^5.0.0"
+  },
+  "devDependencies": {
+    "@types/lodash-es": "^4.17.12",
+    "@vitest/coverage-v8": "^3.2.4",
+    "eslint": "^9.30.1",
+    "globals": "^16.3.0",
+    "jiti": "^2.5.1",
+    "typescript": "^5.8.3",
+    "typescript-eslint": "^8.41.0",
+    "vite": "^7.1.12",
+    "vitest": "^3.2.4"
+  }
+}