ai-client-sdk 3.0.9 → 4.0.0

package/dist/index.d.ts

@@ -14,22 +14,31 @@
  * 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';
+import { tools } from './utils/tools';
+import { Agent, type Message, type StreamResult, type AssistantMessage } from './utils/agent';
+export interface PanelElement extends HTMLElement {
+    ready(): Promise<void>;
+    pushMessage(message: Message): Promise<void>;
+    pushMessages(messages: Message[]): Promise<void>;
+    pushLoadingMessage(): Promise<void>;
+    updateLoadingMessageReasoningContent(content: string): Promise<void>;
+    updateLoadingMessageContent(content: string): Promise<void>;
+}
 interface Config {
     container: HTMLElement | null;
 }
 export declare class AIChatPanel {
     on: <T extends "send" | "create">(type: T, listener: (...args: {
-        send: [message: import(".").Message];
+        send: [message: 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;
-    setUserInputValue: (value: string) => void;
+    private readonly panelElement;
     constructor(config: Config);
+    ready(): Promise<void>;
+    pushMessage(message: Message): Promise<void>;
+    pushMessages(messages: Message[]): Promise<void>;
+    pushLoadingMessage(): Promise<void>;
+    updateLoadingMessageReasoningContent(content: string): Promise<void>;
+    updateLoadingMessageContent(content: string): Promise<void>;
 }
+export { tools, Agent, type Message, type StreamResult, type AssistantMessage };

package/dist/utils/agent.d.ts

@@ -15,6 +15,7 @@
  * limitations under the License.
  */
 import Ajv from 'ajv';
+import { type PanelElement } from '../index';
 declare function abort(): void;
 interface StringParameter {
     type: 'string';
@@ -128,16 +129,19 @@ type ToolCall = {
     };
 };
 interface SimpleMessage {
+    id: string;
     role: 'system' | 'user';
     content: string;
 }
 interface AssistantMessage {
+    id: string;
     role: 'assistant';
     content: string;
     reasoning_content?: string;
     tool_calls?: ToolCall[] | null;
 }
 interface ToolMessage {
+    id: string;
     role: 'tool';
     content: string;
     tool_call_id: string;
@@ -146,6 +150,7 @@ type Message = SimpleMessage | AssistantMessage | ToolMessage;
 interface Params {
     tools?: string[];
     roundsLeft?: number;
+    panel?: Pick<PanelElement, 'pushLoadingMessage' | 'updateLoadingMessageContent'>;
 }
 interface Chunk {
     choices: Array<{

package/dist/view/App.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Copyright 2026 shichzh
+ *
+ * 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';
+export interface AppRef {
+    pushMessage: (message: Message) => void;
+    pushMessages: (messages: Message[]) => void;
+    pushLoadingMessage: () => void;
+    updateLoadingMessageReasoningContent: (content: string) => void;
+    updateLoadingMessageContent: (content: string) => void;
+}
+interface AppProps {
+    onReady: () => void;
+}
+declare const App: import("react").ForwardRefExoticComponent<AppProps & import("react").RefAttributes<AppRef>>;
+export default App;

package/dist/view/{template.d.ts → components/MessageItem.d.ts}

@@ -1,5 +1,4 @@
 /**
- * Copyright 2025 Hughe5
  * Copyright 2026 shichzh
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
@@ -14,5 +13,9 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
-declare const template: HTMLTemplateElement;
-export { template };
+import { type Message } from '../../utils/agent';
+interface MessageItemProps {
+    message: Message;
+}
+declare const MessageItem: import("react").ForwardRefExoticComponent<MessageItemProps & import("react").RefAttributes<HTMLDivElement>>;
+export default MessageItem;

package/dist/view/event.d.ts

@@ -15,7 +15,6 @@
  * limitations under the License.
  */
 import { type Message } from '../utils/agent';
-declare function bindEvents(): void;
 type EventType = 'send' | 'create';
 type EventParams = {
     send: [message: Message];
@@ -28,4 +27,4 @@ declare class EventManager {
     emit: <T extends EventType>(type: T, ...args: EventParams[T]) => Promise<void>;
 }
 declare const eventManager: EventManager;
-export { bindEvents, eventManager };
+export { eventManager };

package/dist/view/index.d.ts

@@ -1,5 +1,5 @@
 /**
- * Copyright 2025 Hughe5
+ * Copyright 2026 shichzh
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -13,4 +13,12 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
-export declare const init: (root: ShadowRoot) => void;
+import { RefObject } from 'react';
+import { AppRef } from './App';
+interface Params {
+    domNode: ShadowRoot;
+    onReady: () => void;
+}
+type Result = RefObject<AppRef | null>;
+declare const init: ({ domNode, onReady }: Params) => Result;
+export { init, type Result };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ai-client-sdk",
-  "version": "3.0.9",
+  "version": "4.0.0",
   "description": "用于开发 AI 应用，适配任意前端框架，兼容多种大模型，提供对话界面、Function Calling、Agent、工作流等",
   "author": {
     "name": "Hughe5",
@@ -44,7 +44,7 @@
     "test": "vitest",
     "test:run": "vitest run",
     "test:coverage": "vitest run --coverage",
-    "check-license": "addlicense -check -c \"Hughe5\" -l apache \"examples\" \"src\""
+    "check-license": "addlicense -check -c \"Copyright\" -l apache \"examples\" \"src\""
   },
   "keywords": [
     "ai",
@@ -67,11 +67,15 @@
     "pure-javascript"
   ],
   "dependencies": {
+    "@ant-design/cssinjs": "^2.1.2",
     "ajv": "^8.17.1",
+    "antd": "^6.3.7",
     "chrono-node": "^2.8.3",
     "dayjs": "^1.11.13",
     "dompurify": "^3.2.7",
     "lodash-es": "^4.17.21",
+    "react": "^19.2.5",
+    "react-dom": "^19.2.5",
     "rehype-stringify": "^10.0.1",
     "remark-gfm": "^4.0.1",
     "remark-parse": "^11.0.0",
@@ -80,6 +84,8 @@
   },
   "devDependencies": {
     "@types/lodash-es": "^4.17.12",
+    "@types/react": "^19.2.14",
+    "@types/react-dom": "^19.2.3",
     "@vitest/coverage-v8": "^3.2.4",
     "eslint": "^9.30.1",
     "globals": "^16.3.0",

package/dist/view/dom.d.ts

@@ -1,57 +0,0 @@
-/**
- * Copyright 2025 Hughe5
- * Copyright 2026 shichzh
- *
- * 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: {
-    readonly value: string;
-    setValue(value: string): void;
-    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, };