@amaster.ai/copilot-client 1.1.0-beta.42 → 1.1.0-beta.44

package/dist/index.d.cts

@@ -1,444 +1,5 @@
-import { CancelTaskResponse, GetTaskResponse } from '@a2a-js/sdk';
-import { ClientResult, HttpClient } from '@amaster.ai/http-client';
-
-/**
- * A2UI Types - Inlined from @a2ui/lit for Taro compatibility
- *
- * This file contains the minimal A2UI type definitions needed by copilot-client.
- * We inline these types instead of importing from @a2ui/lit because @a2ui/lit
- * uses ES2025 `import ... with { type: "json" }` syntax which is not supported
- * by Taro's Vite/esbuild version.
- */
-interface StringValue {
-    /** A data binding reference to a location in the data model (e.g., '/user/name'). */
-    path?: string;
-    /** A fixed, hardcoded string value. */
-    literalString?: string;
-    /** A fixed, hardcoded string value. */
-    literal?: string;
-}
-interface NumberValue {
-    /** A data binding reference to a location in the data model (e.g., '/user/name'). */
-    path?: string;
-    /** A fixed, hardcoded number value. */
-    literalNumber?: number;
-    /** A fixed, hardcoded number value. */
-    literal?: number;
-}
-interface BooleanValue {
-    /** A data binding reference to a location in the data model (e.g., '/user/name'). */
-    path?: string;
-    /** A fixed, hardcoded boolean value. */
-    literalBoolean?: boolean;
-    /** A fixed, hardcoded boolean value. */
-    literal?: boolean;
-}
-interface Action {
-    /** A unique name identifying the action (e.g., 'submitForm'). */
-    name: string;
-    /** A key-value map of data bindings to be resolved when the action is triggered. */
-    context?: {
-        key: string;
-        /** The dynamic value. Define EXACTLY ONE of the nested properties. */
-        value: {
-            /** A data binding reference to a location in the data model (e.g., '/user/name'). */
-            path?: string;
-            /** A fixed, hardcoded string value. */
-            literalString?: string;
-            literalNumber?: number;
-            literalBoolean?: boolean;
-        };
-    }[];
-}
-interface Text {
-    text: StringValue;
-    usageHint: "h1" | "h2" | "h3" | "h4" | "h5" | "caption" | "body";
-}
-interface Image {
-    url: StringValue;
-    usageHint: "icon" | "avatar" | "smallFeature" | "mediumFeature" | "largeFeature" | "header";
-    fit?: "contain" | "cover" | "fill" | "none" | "scale-down";
-}
-interface Icon {
-    name: StringValue;
-}
-interface Video {
-    url: StringValue;
-}
-interface AudioPlayer {
-    url: StringValue;
-    /** A label, title, or placeholder text. */
-    description?: StringValue;
-}
-interface Tabs {
-    /** A list of tabs, each with a title and a child component ID. */
-    tabItems: {
-        /** The title of the tab. */
-        title: {
-            /** A data binding reference to a location in the data model (e.g., '/user/name'). */
-            path?: string;
-            /** A fixed, hardcoded string value. */
-            literalString?: string;
-        };
-        /** A reference to a component instance by its unique ID. */
-        child: string;
-    }[];
-}
-interface Divider {
-    /** The orientation. */
-    axis?: "horizontal" | "vertical";
-    /** The color of the divider (e.g., hex code or semantic name). */
-    color?: string;
-    /** The thickness of the divider. */
-    thickness?: number;
-}
-interface Modal {
-    /** The ID of the component (e.g., a button) that triggers the modal. */
-    entryPointChild: string;
-    /** The ID of the component to display as the modal's content. */
-    contentChild: string;
-}
-interface Button {
-    /** The ID of the component to display as the button's content. */
-    child: string;
-    /** Represents a user-initiated action. */
-    action: Action;
-}
-interface Checkbox {
-    label: StringValue;
-    value: {
-        /** A data binding reference to a location in the data model (e.g., '/user/name'). */
-        path?: string;
-        literalBoolean?: boolean;
-    };
-}
-interface TextField {
-    text?: StringValue;
-    /** A label, title, or placeholder text. */
-    label: StringValue;
-    type?: "shortText" | "number" | "date" | "longText";
-    /** A regex string to validate the input. */
-    validationRegexp?: string;
-}
-interface DateTimeInput {
-    value: StringValue;
-    enableDate?: boolean;
-    enableTime?: boolean;
-    /** The string format for the output (e.g., 'YYYY-MM-DD'). */
-    outputFormat?: string;
-}
-interface MultipleChoice {
-    selections: {
-        /** A data binding reference to a location in the data model (e.g., '/user/name'). */
-        path?: string;
-        literalArray?: string[];
-    };
-    options?: {
-        label: {
-            /** A data binding reference to a location in the data model (e.g., '/user/name'). */
-            path?: string;
-            /** A fixed, hardcoded string value. */
-            literalString?: string;
-        };
-        value: string;
-    }[];
-    maxAllowedSelections?: number;
-}
-interface Slider {
-    value: {
-        /** A data binding reference to a location in the data model (e.g., '/user/name'). */
-        path?: string;
-        literalNumber?: number;
-    };
-    minValue?: number;
-    maxValue?: number;
-}
-/** A recursive type for any valid JSON-like value in the data model. */
-type DataValue = string | number | boolean | null | DataMap | DataObject | DataArray;
-type DataObject = {
-    [key: string]: DataValue;
-};
-type DataMap = Map<string, DataValue>;
-type DataArray = DataValue[];
-/** A template for creating components from a list in the data model. */
-interface ComponentArrayTemplate {
-    componentId: string;
-    dataBinding: string;
-}
-/** Defines a list of child components, either explicitly or via a template. */
-interface ComponentArrayReference {
-    explicitList?: string[];
-    template?: ComponentArrayTemplate;
-}
-/** Represents the general shape of a component's properties. */
-type ComponentProperties = {
-    children?: ComponentArrayReference;
-    child?: string;
-    [k: string]: unknown;
-};
-/** A raw component instance from a SurfaceUpdate message. */
-interface ComponentInstance {
-    id: string;
-    weight?: number;
-    component?: ComponentProperties;
-}
-type ValueMap = DataObject & {
-    key: string;
-    /** May be JSON */
-    valueString?: string;
-    valueNumber?: number;
-    valueBoolean?: boolean;
-    valueMap?: ValueMap[];
-};
-interface BeginRenderingMessage {
-    surfaceId: string;
-    root: string;
-    styles?: Record<string, string>;
-}
-interface SurfaceUpdateMessage {
-    surfaceId: string;
-    components: ComponentInstance[];
-}
-interface DataModelUpdate {
-    surfaceId: string;
-    path?: string;
-    contents: ValueMap[];
-}
-interface DeleteSurfaceMessage {
-    surfaceId: string;
-}
-interface ServerToClientMessage {
-    beginRendering?: BeginRenderingMessage;
-    surfaceUpdate?: SurfaceUpdateMessage;
-    dataModelUpdate?: DataModelUpdate;
-    deleteSurface?: DeleteSurfaceMessage;
-}
-/** A recursive type for any value that can appear within a resolved component tree. */
-type ResolvedValue = string | number | boolean | null | AnyComponentNode | ResolvedMap | ResolvedArray;
-/** A generic map where each value has been recursively resolved. */
-type ResolvedMap = {
-    [key: string]: ResolvedValue;
-};
-/** A generic array where each item has been recursively resolved. */
-type ResolvedArray = ResolvedValue[];
-/** A base interface that all component nodes share. */
-interface BaseComponentNode {
-    id: string;
-    weight?: number;
-    dataContextPath?: string;
-    slotName?: string;
-}
-interface TextNode extends BaseComponentNode {
-    type: "Text";
-    properties: Text;
-}
-interface ImageNode extends BaseComponentNode {
-    type: "Image";
-    properties: Image;
-}
-interface IconNode extends BaseComponentNode {
-    type: "Icon";
-    properties: Icon;
-}
-interface VideoNode extends BaseComponentNode {
-    type: "Video";
-    properties: Video;
-}
-interface AudioPlayerNode extends BaseComponentNode {
-    type: "AudioPlayer";
-    properties: AudioPlayer;
-}
-interface RowNode extends BaseComponentNode {
-    type: "Row";
-    properties: ResolvedRow;
-}
-interface ColumnNode extends BaseComponentNode {
-    type: "Column";
-    properties: ResolvedColumn;
-}
-interface ListNode extends BaseComponentNode {
-    type: "List";
-    properties: ResolvedList;
-}
-interface CardNode extends BaseComponentNode {
-    type: "Card";
-    properties: ResolvedCard;
-}
-interface TabsNode extends BaseComponentNode {
-    type: "Tabs";
-    properties: ResolvedTabs;
-}
-interface DividerNode extends BaseComponentNode {
-    type: "Divider";
-    properties: Divider;
-}
-interface ModalNode extends BaseComponentNode {
-    type: "Modal";
-    properties: ResolvedModal;
-}
-interface ButtonNode extends BaseComponentNode {
-    type: "Button";
-    properties: ResolvedButton;
-}
-interface CheckboxNode extends BaseComponentNode {
-    type: "CheckBox";
-    properties: Checkbox;
-}
-interface TextFieldNode extends BaseComponentNode {
-    type: "TextField";
-    properties: TextField;
-}
-interface DateTimeInputNode extends BaseComponentNode {
-    type: "DateTimeInput";
-    properties: DateTimeInput;
-}
-interface MultipleChoiceNode extends BaseComponentNode {
-    type: "MultipleChoice";
-    properties: MultipleChoice;
-}
-interface SliderNode extends BaseComponentNode {
-    type: "Slider";
-    properties: Slider;
-}
-interface CustomNode extends BaseComponentNode {
-    type: string;
-    properties: CustomNodeProperties;
-}
-/**
- * The complete discriminated union of all possible resolved component nodes.
- * A renderer would use this type for any given node in the component tree.
- */
-type AnyComponentNode = TextNode | IconNode | ImageNode | VideoNode | AudioPlayerNode | RowNode | ColumnNode | ListNode | CardNode | TabsNode | DividerNode | ModalNode | ButtonNode | CheckboxNode | TextFieldNode | DateTimeInputNode | MultipleChoiceNode | SliderNode | CustomNode;
-interface ResolvedRow {
-    children: AnyComponentNode[];
-    distribution?: "start" | "center" | "end" | "spaceBetween" | "spaceAround" | "spaceEvenly";
-    alignment?: "start" | "center" | "end" | "stretch";
-}
-interface ResolvedColumn {
-    children: AnyComponentNode[];
-    distribution?: "start" | "center" | "end" | "spaceBetween" | "spaceAround" | "spaceEvenly";
-    alignment?: "start" | "center" | "end" | "stretch";
-}
-interface ResolvedButton {
-    child: AnyComponentNode;
-    action: Button["action"];
-}
-interface ResolvedList {
-    children: AnyComponentNode[];
-    direction?: "vertical" | "horizontal";
-    alignment?: "start" | "center" | "end" | "stretch";
-}
-interface ResolvedCard {
-    child: AnyComponentNode;
-    children: AnyComponentNode[];
-}
-interface ResolvedTabItem {
-    title: StringValue;
-    child: AnyComponentNode;
-}
-interface ResolvedTabs {
-    tabItems: ResolvedTabItem[];
-}
-interface ResolvedModal {
-    entryPointChild: AnyComponentNode;
-    contentChild: AnyComponentNode;
-}
-interface CustomNodeProperties {
-    [k: string]: ResolvedValue;
-}
-type SurfaceID = string;
-/** The complete state of a single UI surface. */
-interface Surface {
-    rootComponentId: string | null;
-    componentTree: AnyComponentNode | null;
-    dataModel: DataMap;
-    components: Map<string, ComponentInstance>;
-    styles: Record<string, string>;
-}
-interface MessageProcessor {
-    getSurfaces(): ReadonlyMap<string, Surface>;
-    clearSurfaces(): void;
-    processMessages(messages: ServerToClientMessage[]): void;
-    /**
-     * Retrieves the data for a given component node and a relative path string.
-     * This correctly handles the special `.` path, which refers to the node's
-     * own data context.
-     */
-    getData(node: AnyComponentNode, relativePath: string, surfaceId: string): DataValue | null;
-    setData(node: AnyComponentNode | null, relativePath: string, value: DataValue, surfaceId: string): void;
-    resolvePath(path: string, dataContextPath?: string): string;
-}
-
-type a2uiTypes_Action = Action;
-type a2uiTypes_AnyComponentNode = AnyComponentNode;
-type a2uiTypes_AudioPlayer = AudioPlayer;
-type a2uiTypes_AudioPlayerNode = AudioPlayerNode;
-type a2uiTypes_BeginRenderingMessage = BeginRenderingMessage;
-type a2uiTypes_BooleanValue = BooleanValue;
-type a2uiTypes_Button = Button;
-type a2uiTypes_ButtonNode = ButtonNode;
-type a2uiTypes_CardNode = CardNode;
-type a2uiTypes_Checkbox = Checkbox;
-type a2uiTypes_CheckboxNode = CheckboxNode;
-type a2uiTypes_ColumnNode = ColumnNode;
-type a2uiTypes_ComponentArrayReference = ComponentArrayReference;
-type a2uiTypes_ComponentArrayTemplate = ComponentArrayTemplate;
-type a2uiTypes_ComponentInstance = ComponentInstance;
-type a2uiTypes_ComponentProperties = ComponentProperties;
-type a2uiTypes_CustomNode = CustomNode;
-type a2uiTypes_CustomNodeProperties = CustomNodeProperties;
-type a2uiTypes_DataArray = DataArray;
-type a2uiTypes_DataMap = DataMap;
-type a2uiTypes_DataModelUpdate = DataModelUpdate;
-type a2uiTypes_DataObject = DataObject;
-type a2uiTypes_DataValue = DataValue;
-type a2uiTypes_DateTimeInput = DateTimeInput;
-type a2uiTypes_DateTimeInputNode = DateTimeInputNode;
-type a2uiTypes_DeleteSurfaceMessage = DeleteSurfaceMessage;
-type a2uiTypes_Divider = Divider;
-type a2uiTypes_DividerNode = DividerNode;
-type a2uiTypes_Icon = Icon;
-type a2uiTypes_IconNode = IconNode;
-type a2uiTypes_Image = Image;
-type a2uiTypes_ImageNode = ImageNode;
-type a2uiTypes_ListNode = ListNode;
-type a2uiTypes_MessageProcessor = MessageProcessor;
-type a2uiTypes_Modal = Modal;
-type a2uiTypes_ModalNode = ModalNode;
-type a2uiTypes_MultipleChoice = MultipleChoice;
-type a2uiTypes_MultipleChoiceNode = MultipleChoiceNode;
-type a2uiTypes_NumberValue = NumberValue;
-type a2uiTypes_ResolvedArray = ResolvedArray;
-type a2uiTypes_ResolvedButton = ResolvedButton;
-type a2uiTypes_ResolvedCard = ResolvedCard;
-type a2uiTypes_ResolvedColumn = ResolvedColumn;
-type a2uiTypes_ResolvedList = ResolvedList;
-type a2uiTypes_ResolvedMap = ResolvedMap;
-type a2uiTypes_ResolvedModal = ResolvedModal;
-type a2uiTypes_ResolvedRow = ResolvedRow;
-type a2uiTypes_ResolvedTabItem = ResolvedTabItem;
-type a2uiTypes_ResolvedTabs = ResolvedTabs;
-type a2uiTypes_ResolvedValue = ResolvedValue;
-type a2uiTypes_RowNode = RowNode;
-type a2uiTypes_ServerToClientMessage = ServerToClientMessage;
-type a2uiTypes_Slider = Slider;
-type a2uiTypes_SliderNode = SliderNode;
-type a2uiTypes_StringValue = StringValue;
-type a2uiTypes_Surface = Surface;
-type a2uiTypes_SurfaceID = SurfaceID;
-type a2uiTypes_SurfaceUpdateMessage = SurfaceUpdateMessage;
-type a2uiTypes_Tabs = Tabs;
-type a2uiTypes_TabsNode = TabsNode;
-type a2uiTypes_Text = Text;
-type a2uiTypes_TextField = TextField;
-type a2uiTypes_TextFieldNode = TextFieldNode;
-type a2uiTypes_TextNode = TextNode;
-type a2uiTypes_ValueMap = ValueMap;
-type a2uiTypes_Video = Video;
-type a2uiTypes_VideoNode = VideoNode;
-declare namespace a2uiTypes {
-  export type { a2uiTypes_Action as Action, a2uiTypes_AnyComponentNode as AnyComponentNode, a2uiTypes_AudioPlayer as AudioPlayer, a2uiTypes_AudioPlayerNode as AudioPlayerNode, a2uiTypes_BeginRenderingMessage as BeginRenderingMessage, a2uiTypes_BooleanValue as BooleanValue, a2uiTypes_Button as Button, a2uiTypes_ButtonNode as ButtonNode, a2uiTypes_CardNode as CardNode, a2uiTypes_Checkbox as Checkbox, a2uiTypes_CheckboxNode as CheckboxNode, a2uiTypes_ColumnNode as ColumnNode, a2uiTypes_ComponentArrayReference as ComponentArrayReference, a2uiTypes_ComponentArrayTemplate as ComponentArrayTemplate, a2uiTypes_ComponentInstance as ComponentInstance, a2uiTypes_ComponentProperties as ComponentProperties, a2uiTypes_CustomNode as CustomNode, a2uiTypes_CustomNodeProperties as CustomNodeProperties, a2uiTypes_DataArray as DataArray, a2uiTypes_DataMap as DataMap, a2uiTypes_DataModelUpdate as DataModelUpdate, a2uiTypes_DataObject as DataObject, a2uiTypes_DataValue as DataValue, a2uiTypes_DateTimeInput as DateTimeInput, a2uiTypes_DateTimeInputNode as DateTimeInputNode, a2uiTypes_DeleteSurfaceMessage as DeleteSurfaceMessage, a2uiTypes_Divider as Divider, a2uiTypes_DividerNode as DividerNode, a2uiTypes_Icon as Icon, a2uiTypes_IconNode as IconNode, a2uiTypes_Image as Image, a2uiTypes_ImageNode as ImageNode, a2uiTypes_ListNode as ListNode, a2uiTypes_MessageProcessor as MessageProcessor, a2uiTypes_Modal as Modal, a2uiTypes_ModalNode as ModalNode, a2uiTypes_MultipleChoice as MultipleChoice, a2uiTypes_MultipleChoiceNode as MultipleChoiceNode, a2uiTypes_NumberValue as NumberValue, a2uiTypes_ResolvedArray as ResolvedArray, a2uiTypes_ResolvedButton as ResolvedButton, a2uiTypes_ResolvedCard as ResolvedCard, a2uiTypes_ResolvedColumn as ResolvedColumn, a2uiTypes_ResolvedList as ResolvedList, a2uiTypes_ResolvedMap as ResolvedMap, a2uiTypes_ResolvedModal as ResolvedModal, a2uiTypes_ResolvedRow as ResolvedRow, a2uiTypes_ResolvedTabItem as ResolvedTabItem, a2uiTypes_ResolvedTabs as ResolvedTabs, a2uiTypes_ResolvedValue as ResolvedValue, a2uiTypes_RowNode as RowNode, a2uiTypes_ServerToClientMessage as ServerToClientMessage, a2uiTypes_Slider as Slider, a2uiTypes_SliderNode as SliderNode, a2uiTypes_StringValue as StringValue, a2uiTypes_Surface as Surface, a2uiTypes_SurfaceID as SurfaceID, a2uiTypes_SurfaceUpdateMessage as SurfaceUpdateMessage, a2uiTypes_Tabs as Tabs, a2uiTypes_TabsNode as TabsNode, a2uiTypes_Text as Text, a2uiTypes_TextField as TextField, a2uiTypes_TextFieldNode as TextFieldNode, a2uiTypes_TextNode as TextNode, a2uiTypes_ValueMap as ValueMap, a2uiTypes_Video as Video, a2uiTypes_VideoNode as VideoNode };
-}
+import { SendStreamingMessageResponse, CancelTaskResponse, GetTaskResponse } from '@a2a-js/sdk';
+import { HttpClient, ClientResult } from '@amaster.ai/http-client';
 
 interface TextContent {
     type: "text";
@@ -465,31 +26,30 @@ interface ChatMessage {
 interface ChatOptions {
     taskId?: string;
 }
-type CopilotA2UIClient = {
+type CopilotClient = {
     /**
-     * Stream A2UI messages from Copilot Agent.
+     * Stream messages from Copilot Agent.
      *
      * @example
      * ```typescript
-     * import { createCopilotA2UIClient, Data } from "@amaster.ai/copilot-client";
+     * import { createCopilotClient, Data } from "@amaster.ai/copilot-client";
      *
-     * const client = createCopilotA2UIClient();
-     * const processor = Data.createSignalA2uiMessageProcessor();
+     * const client = createCopilotClient();
      *
-     * for await (const messages of client.chat([{ role: "user", content: "Hello" }])) {
-     *   processor.processMessages(messages);
+     * for await (const response of client.chat([{ role: "user", content: "Hello" }])) {
+     *   // deal response
      * }
      * ```
      */
-    chat(messages: ChatMessage[], options?: ChatOptions): AsyncGenerator<ServerToClientMessage[], void, unknown>;
+    chat(messages: ChatMessage[], options?: ChatOptions): AsyncGenerator<SendStreamingMessageResponse, void, unknown>;
     cancelChat(taskId: string): Promise<ClientResult<CancelTaskResponse>>;
     getChatStatus(taskId: string): Promise<ClientResult<GetTaskResponse>>;
 };
 /**
- * Create Copilot A2UI client
+ * Create Copilot client
  *
  * Auto-detects runtime environment (Browser/Vite/Taro H5/Taro Mini-program)
  */
-declare function createCopilotA2UIClient(http?: HttpClient, baseUrl?: string, getAccessToken?: () => string | null): CopilotA2UIClient;
+declare function createCopilotClient(http?: HttpClient, baseUrl?: string, getAccessToken?: () => string | null): CopilotClient;
 
-export { a2uiTypes as A2UITypes, type ChatMessage, type ChatOptions, type CopilotA2UIClient, type FileContent, type ImageContent, type MessageContent, type MessageProcessor, type ServerToClientMessage, type Surface, type TextContent, createCopilotA2UIClient };
+export { type ChatMessage, type ChatOptions, type CopilotClient, type FileContent, type ImageContent, type MessageContent, type TextContent, createCopilotClient };