@amaster.ai/client 1.0.0-alpha.2 → 1.0.0-beta.72

package/types/bpm.d.ts

@@ -228,6 +228,46 @@ export interface TaskCount {
   count: number;
 }
 
+/**
+ * Task form field metadata
+ */
+export interface TaskFormField {
+  id: string;
+  label?: string;
+  type?: string;
+  defaultValue?: CamundaVariableValue;
+  properties?: Record<string, unknown>;
+  validationConstraints?: Array<{
+    name: string;
+    config?: unknown;
+  }>;
+  [key: string]: unknown;
+}
+
+/**
+ * Task form schema metadata
+ */
+export interface TaskFormSchema {
+  key?: string;
+  contextPath?: string;
+  fields?: TaskFormField[];
+  [key: string]: unknown;
+}
+
+/**
+ * Task form variable value
+ */
+export interface TaskFormVariable {
+  type: string;
+  value: CamundaVariableValue;
+  valueInfo?: Record<string, unknown>;
+}
+
+/**
+ * Task form variables keyed by variable name
+ */
+export type TaskFormVariables = Record<string, TaskFormVariable>;
+
 /**
  * Historical task information
  */
@@ -502,6 +542,19 @@ export interface BpmClientAPI {
    */
   getTask(taskId: string): Promise<ClientResult<Task>>;
 
+  /**
+   * Get task form schema metadata
+   */
+  getTaskFormSchema(
+    taskId: string,
+    opts?: { redirect?: string }
+  ): Promise<ClientResult<TaskFormSchema>>;
+
+  /**
+   * Get task form variables
+   */
+  getTaskFormVariables(taskId: string): Promise<ClientResult<TaskFormVariables>>;
+
   /**
    * Complete a user task
    *
@@ -531,6 +584,20 @@ export interface BpmClientAPI {
     inputs: Record<string, CamundaVariableValue> | VariableSubmission
   ): Promise<ClientResult<null>>;
 
+  /**
+   * Query historical tasks
+   */
+  getHistoryTasks(
+    params?: HistoryTaskQueryParams
+  ): Promise<ClientResult<HistoryTask[]>>;
+
+  /**
+   * Get historical task count
+   */
+  getHistoryTaskCount(
+    params?: HistoryTaskQueryParams
+  ): Promise<ClientResult<TaskCount>>;
+
   // ==================== History & Reporting ====================
 
   /**
@@ -572,6 +639,13 @@ export interface BpmClientAPI {
   getHistoryProcessInstanceCount(
     params?: HistoryProcessInstanceQueryParams
   ): Promise<ClientResult<{ count: number }>>;
+
+  /**
+   * Get deployed Camunda form definition for a task
+   */
+  getTaskDeployedForm(
+    taskId: string
+  ): Promise<ClientResult<CamundaFormDefinition>>;
 }
 
 /**
@@ -619,3 +693,52 @@ export interface HistoryProcessInstanceQueryParams {
   /** Pagination: max results to return */
   maxResults?: number;
 }
+
+/**
+ * Historical task query parameters
+ */
+export interface HistoryTaskQueryParams {
+  /** Filter by task assignee */
+  taskAssignee?: string;
+  /** Filter by process instance ID */
+  processInstanceId?: string;
+  /** Filter finished tasks */
+  finished?: boolean;
+  /** Filter unfinished tasks */
+  unfinished?: boolean;
+  /** Pagination: first result index */
+  firstResult?: number;
+  /** Pagination: max results to return */
+  maxResults?: number;
+  /** Sort field */
+  sortBy?: string;
+  /** Sort order */
+  sortOrder?: "asc" | "desc";
+  [key: string]: string | number | boolean | undefined;
+}
+
+/**
+ * Camunda deployed form definition
+ */
+export interface CamundaFormDefinition {
+  components?: CamundaFormComponent[];
+  type?: string;
+  id?: string;
+  schemaVersion?: number;
+}
+
+/**
+ * Camunda form component definition
+ */
+export interface CamundaFormComponent {
+  key: string;
+  label?: string;
+  type: string;
+  validate?: {
+    required?: boolean;
+    readonly?: boolean;
+  };
+  defaultValue?: CamundaVariableValue;
+  values?: Array<{ label: string; value: string }>;
+  properties?: Record<string, unknown>;
+}

package/types/copilot.d.ts

@@ -1,49 +1,168 @@
-import type { SendStreamingMessageResponse, CancelTaskResponse, GetTaskResponse } from '@a2a-js/sdk';
-import type { ClientResult } from './common';
-
 interface TextContent {
-    type: "text";
-    text: string;
+  type: "text";
+  text: string;
 }
+
 interface ImageContent {
-    type: "image";
-    data?: string;
-    url?: string;
-    mimeType?: string;
+  type: "image";
+  data?: string;
+  url?: string;
+  mimeType?: string;
 }
+
 interface FileContent {
-    type: "file";
-    data?: string;
-    url?: string;
-    mimeType?: string;
-    name?: string;
+  type: "file";
+  data?: string;
+  url?: string;
+  mimeType?: string;
+  name?: string;
 }
+
 type MessageContent = TextContent | ImageContent | FileContent;
-interface ChatMessage {
-    role: "system" | "user" | "assistant";
-    content: string | MessageContent[];
+
+type Role = "user" | "assistant" | "system";
+
+interface BaseMessage {
+  messageId: string;
+  role?: Role;
+  kind: string;
+  timestamp?: string;
+}
+
+interface TextMessage extends BaseMessage {
+  kind: "text-content" | "message";
+  content: string;
+}
+
+interface ErrorMessage extends BaseMessage {
+  kind: "error";
+  content: string;
+}
+
+interface ThoughtMessage extends BaseMessage {
+  kind: "thought";
+  thought: string;
+}
+
+interface ToolMessage extends BaseMessage {
+  kind: "tool";
+  toolName?: string;
+  toolStatus?: string;
+  toolDescription?: string;
+  response?: unknown;
+}
+
+interface UIRenderMessage extends BaseMessage {
+  kind: "ui-render";
+  spec: {
+    root: string;
+    elements: Record<
+      string,
+      {
+        type: string;
+        props?: Record<string, unknown>;
+        children?: string[];
+      }
+    >;
+  };
 }
-interface ChatOptions {
-    taskId?: string;
+
+type MessagesItem =
+  | TextMessage
+  | ErrorMessage
+  | ThoughtMessage
+  | ToolMessage
+  | UIRenderMessage
+  | BaseMessage;
+
+interface Conversation {
+  taskId: string;
+  status: "submitted" | "working" | "completed" | "error";
+  messages: MessagesItem[];
+  lastUpdated: string;
+  historyId?: string;
+  system?: {
+    level: "newConversation";
+    content?: string;
+  };
+}
+
+interface HistoryState {
+  next: string | null;
+  hasMore: boolean;
+}
+
+interface UpdateMessageInput {
+  taskId: string;
+  messageId: string;
+  content?: string;
+  partial?: boolean;
+  status?: string;
+  response?: unknown;
+  metadata?: Record<string, unknown>;
+}
+
+interface ConversationControllerSnapshot {
+  starting: boolean;
+  isLoading: boolean;
+  isLoadingHistory: boolean;
+  historyState: HistoryState;
+  conversations: Conversation[];
 }
+
+interface ConversationStrings {
+  thinking: string;
+  errorMessage: string;
+  cancelled: string;
+}
+
+interface ConversationControllerOptions {
+  strings: ConversationStrings;
+  mode?: "conversation" | "single-turn";
+  getContextId?: () => string;
+  loadHistoryOnInit?: boolean;
+  resumeOnInit?: boolean;
+}
+
+interface ConversationController {
+  getSnapshot(): ConversationControllerSnapshot;
+  subscribe(listener: (snapshot: ConversationControllerSnapshot) => void): () => void;
+  init(): Promise<void>;
+  destroy(): void;
+  sendMessage(userContent: string): Promise<void>;
+  abort(): void;
+  cancelChat(taskId?: string): Promise<void>;
+  resetConversation(greeting?: string): void;
+  startNewConversation(): Promise<void>;
+  loadHistory(limit?: number, next?: string): Promise<void>;
+  loadMoreHistory(): Promise<void>;
+  getConversation(taskId: string): Conversation | undefined;
+  clearConversation(taskId: string): void;
+  removeMessage(taskId: string, messageId: string): void;
+  updateMessage(input: UpdateMessageInput): void;
+}
+
 type CopilotClientAPI = {
-    /**
-     * Stream messages from Copilot Agent.
-     *
-     * @example
-     * ```typescript
-     * import { createCopilotClient, Data } from "@amaster.ai/copilot-client";
-     *
-     * const client = createCopilotClient();
-     *
-     * for await (const response of client.chat([{ role: "user", content: "Hello" }])) {
-     *   // deal response
-     * }
-     * ```
-     */
-    chat(messages: ChatMessage[], options?: ChatOptions): AsyncGenerator<SendStreamingMessageResponse, void, unknown>;
-    cancelChat(taskId: string): Promise<ClientResult<CancelTaskResponse>>;
-    getChatStatus(taskId: string): Promise<ClientResult<GetTaskResponse>>;
+  createConversationController(options: ConversationControllerOptions): ConversationController;
 };
 
-export { type ChatMessage, type ChatOptions, type CopilotClientAPI, type FileContent, type ImageContent, type MessageContent, type TextContent };
+export {
+  type CopilotClientAPI,
+  type ConversationController,
+  type ConversationControllerOptions,
+  type ConversationControllerSnapshot,
+  type ConversationStrings,
+  type Conversation,
+  type MessagesItem,
+  type TextMessage,
+  type ErrorMessage,
+  type ThoughtMessage,
+  type ToolMessage,
+  type UIRenderMessage,
+  type Role,
+  type UpdateMessageInput,
+  type FileContent,
+  type ImageContent,
+  type MessageContent,
+  type TextContent,
+};

package/types/http.d.ts

@@ -21,6 +21,7 @@ type AdapterResponse = {
     headers?: unknown;
 };
 type HttpAdapter = (_config: RequestConfig) => Promise<AdapterResponse>;
+type MiniProgramRequest = (_options: any) => any;
 type HttpClientOptions = {
     /**
      * HTTP adapter to use:
@@ -31,6 +32,10 @@ type HttpClientOptions = {
      * - function: custom adapter
      */
     adapter?: "taro" | "axios" | AxiosInstance | HttpAdapter;
+    /**
+     * Explicit mini-program request implementation, for example `Taro.request`.
+     */
+    miniProgramRequest?: MiniProgramRequest;
     /**
      * Base URL to prefix when `config.url` is relative (e.g. "/api/...").
      *
@@ -69,6 +74,7 @@ type HttpClientOptions = {
 };
 type HttpClient = {
     request<T>(_config: RequestConfig): Promise<ClientResult<T>>;
+    miniProgramRequest?: MiniProgramRequest;
 };
 /**
  * Create an HTTP client instance
@@ -92,4 +98,4 @@ type HttpClient = {
  */
 declare function createHttpClient(axiosInstanceOrOptions?: AxiosInstance | HttpClientOptions): HttpClient;
 
-export { type AdapterResponse, type ClientError, type ClientResult, type HttpAdapter, type HttpClient, type HttpClientOptions, type RequestConfig, createHttpClient };
+export { type AdapterResponse, type ClientError, type ClientResult, type HttpAdapter, type HttpClient, type HttpClientOptions, type MiniProgramRequest, type RequestConfig, createHttpClient };

package/types/index.d.ts

@@ -64,7 +64,7 @@ export interface AmasterClientOptions {
    * Base URL for the Amaster API
    *
    */
-  baseURL: string;
+  baseURL?: string;
 
   /**
    * Optional custom headers to include in ALL requests
@@ -75,6 +75,11 @@ export interface AmasterClientOptions {
    */
   headers?: Record<string, string>;
 
+  /**
+   * Explicit mini-program request implementation, for example `Taro.request`.
+   */
+  miniProgramRequest?: import("./http").MiniProgramRequest;
+
   /**
    * Callback triggered when a 401 Unauthorized response is received
    *
@@ -323,7 +328,7 @@ export type { AuthClientAPI } from "./auth";
 export type { EntityClientAPI } from "./entity";
 export type { BpmClientAPI } from "./bpm";
 export type { WorkflowClientAPI } from "./workflow";
-export type { ASRClient, ASRClientConfig, ASRHttpClient, ASRHttpClientConfig } from "./asr";
+export type { ASRClient, ASRClientConfig, ASRHttpClient, ASRHttpClientConfig, Recorder, RecorderOptions } from "./asr";
 export type { CopilotClientAPI } from "./copilot";
 export type { FunctionClientAPI } from "./function";
 export type { TTSClientAPI } from "./tts";

package/types/tts.d.ts

@@ -78,6 +78,12 @@ export interface TTSClientAPI {
    */
   play(): void;
 
+  /**
+   * Stop audio playback
+   *
+   */
+  stop(): void;
+
   /**
    * Close connection
    *