@xsai/shared-chat 0.3.5 → 0.4.0-beta.2

package/dist/index.d.ts

@@ -2,74 +2,78 @@ import { CommonRequestOptions } from '@xsai/shared';
 
 type FinishReason = 'content_filter' | 'error' | 'length' | 'other' | 'stop' | 'tool-calls' | (string & {});
 
-interface AudioBase64 {
-    /**
-     * Base64 encoded audio data.
-     */
-    data: string;
-    format: 'mp3' | 'wav';
-}
-interface AudioPart extends CommonPart<'input_audio'> {
-    input_audio: AudioBase64;
-}
-interface CommonPart<T extends string> {
-    type: T;
+interface AudioContentPart {
+    input_audio: {
+        data: string;
+        format: 'mp3' | 'wav';
+    };
+    type: 'input_audio';
 }
-interface ImagePart extends CommonPart<'image_url'> {
-    image_url: ImageURLorBase64;
+/** @internal */
+type CommonContentPart = AudioContentPart | FileContentPart | ImageContentPart | TextContentPart;
+interface FileContentPart {
+    file: {
+        file_data?: string;
+        file_id?: string;
+        filename?: string;
+    };
+    type: 'file';
 }
-interface ImageURLorBase64 {
-    /**
-     * Specifies the detail level of the image.
-     */
-    detail?: 'auto' | 'high' | 'low';
-    /**
-     * Either a URL of the image or the base64 encoded image data.
-     */
-    url: string;
+interface ImageContentPart {
+    image_url: {
+        detail?: 'auto' | 'high' | 'low';
+        url: string;
+    };
+    type: 'image_url';
 }
-type Part = AudioPart | ImagePart | RefusalPart | TextPart;
-interface RefusalPart extends CommonPart<'refusal'> {
+interface RefusalContentPart {
     refusal: string;
+    type: 'refusal';
 }
-interface TextPart extends CommonPart<'text'> {
+interface TextContentPart {
     text: string;
+    type: 'text';
 }
 
-interface AssistantMessage extends Optional<CommonMessage<'assistant', AssistantMessagePart>, 'content'> {
-    refusal?: null | string;
-    tool_calls?: ToolCall[];
-}
-type AssistantMessagePart = RefusalPart | TextPart;
-interface AssistantMessageResponse extends Omit<AssistantMessage, 'content'> {
-    content?: string;
-}
-interface CommonMessage<T extends string, P extends Part> {
-    content: Array<P> | string;
-    name?: string;
-    role: T;
-}
-type Message = AssistantMessage | SystemMessage | ToolMessage | UserMessage;
-interface SystemMessage extends CommonMessage<'system', SystemMessagePart> {
-}
-type SystemMessagePart = TextPart;
 interface ToolCall {
     function: {
         arguments: string;
         name: string;
     };
     id: string;
-    index: number;
     type: 'function';
 }
-interface ToolMessage extends Omit<CommonMessage<'tool', ToolMessagePart>, 'name'> {
+
+interface AssistantMessage {
+    content?: (RefusalContentPart | TextContentPart)[] | string;
+    name?: string;
+    refusal?: string;
+    role: 'assistant';
+    tool_calls?: ToolCall[];
+}
+interface DeveloperMessage {
+    content: string | TextContentPart[];
+    name?: string;
+    /** @remarks Before using, confirm that your model supports this. */
+    role: 'developer';
+}
+type Message = AssistantMessage | DeveloperMessage | SystemMessage | ToolMessage | UserMessage;
+interface SystemMessage {
+    content: string | TextContentPart[];
+    name?: string;
+    role: 'system';
+}
+interface ToolMessage {
+    /** @remarks considering the support of ecosystems (such as MCP), we have relaxed this type. */
+    content: CommonContentPart[] | string;
+    role: 'tool';
     tool_call_id: string;
 }
-type ToolMessagePart = AudioPart | ImagePart | TextPart;
-interface UserMessage extends CommonMessage<'user', UserMessagePart> {
+interface UserMessage {
+    content: CommonContentPart[] | string;
+    name?: string;
+    role: 'user';
 }
-type UserMessagePart = AudioPart | ImagePart | TextPart;
-type Optional<T, K extends keyof T> = Omit<T, K> & Pick<Partial<T>, K>;
 
 interface CompletionToolCall {
     args: string;
@@ -79,7 +83,7 @@ interface CompletionToolCall {
 }
 interface CompletionToolResult {
     args: Record<string, unknown>;
-    result: string | ToolMessagePart[];
+    result: ToolMessage['content'];
     toolCallId: string;
     toolName: string;
 }
@@ -119,12 +123,19 @@ type CompletionStep<T extends boolean = false> = (T extends true ? {
 };
 type CompletionStepType = 'continue' | 'done' | 'initial' | 'tool-result';
 
-type ToolChoice = 'auto' | 'none' | 'required' | {
+type ToolChoice = AllowedTools | ToolChoiceMode | ToolChoiceTool;
+interface AllowedTools {
+    mode: 'auto' | 'required';
+    tools: ToolChoiceTool[];
+    type: 'allowed_tools';
+}
+type ToolChoiceMode = 'auto' | 'none' | 'required';
+interface ToolChoiceTool {
     function: {
         name: string;
     };
     type: 'function';
-};
+}
 
 /** @see {@link https://platform.openai.com/docs/api-reference/chat/create} */
 interface ChatOptions extends CommonRequestOptions {
@@ -177,4 +188,4 @@ interface ExecuteToolResult {
 }
 declare const executeTool: ({ abortSignal, messages, toolCall, tools }: ExecuteToolOptions) => Promise<ExecuteToolResult>;
 
-export { type AssistantMessage, type AssistantMessagePart, type AssistantMessageResponse, type AudioBase64, type AudioPart, type ChatOptions, type CommonMessage, type CommonPart, type CompletionStep, type CompletionStepType, type CompletionToolCall, type CompletionToolResult, type DetermineStepTypeOptions, type ExecuteToolOptions, type ExecuteToolResult, type FinishReason, type ImagePart, type ImageURLorBase64, type Message, type Part, type RefusalPart, type SystemMessage, type SystemMessagePart, type TextPart, type Tool, type ToolCall, type ToolChoice, type ToolExecuteOptions, type ToolExecuteResult, type ToolMessage, type ToolMessagePart, type Usage, type UserMessage, type UserMessagePart, chat, determineStepType, executeTool };
+export { type AssistantMessage, type AudioContentPart, type ChatOptions, type CommonContentPart, type CompletionStep, type CompletionStepType, type CompletionToolCall, type CompletionToolResult, type DetermineStepTypeOptions, type DeveloperMessage, type ExecuteToolOptions, type ExecuteToolResult, type FileContentPart, type FinishReason, type ImageContentPart, type Message, type RefusalContentPart, type SystemMessage, type TextContentPart, type Tool, type ToolCall, type ToolChoice, type ToolExecuteOptions, type ToolExecuteResult, type ToolMessage, type Usage, type UserMessage, chat, determineStepType, executeTool };

package/dist/index.js

@@ -35,7 +35,7 @@ const wrapToolResult = (result) => {
   if (typeof result === "string")
     return result;
   if (Array.isArray(result)) {
-    if (result.every((item) => !!(typeof item === "object" && "type" in item && ["audio", "image", "text"].includes(item.type)))) {
+    if (result.every((item) => !!(typeof item === "object" && "type" in item && ["file", "image_url", "input_audio", "text"].includes(item.type)))) {
       return result;
     }
   }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@xsai/shared-chat",
   "type": "module",
-  "version": "0.3.5",
+  "version": "0.4.0-beta.2",
   "description": "extra-small AI SDK.",
   "author": "Moeru AI",
   "license": "MIT",
@@ -29,7 +29,7 @@
     "dist"
   ],
   "dependencies": {
-    "@xsai/shared": "~0.3.5"
+    "@xsai/shared": "~0.4.0-beta.2"
   },
   "scripts": {
     "build": "pkgroll"