@amaster.ai/client 1.1.0-beta.3 → 1.1.0-beta.5

package/README.md

@@ -487,13 +487,10 @@ const result = await client.copilot.sendMessage([
 console.log(result.data.content);
 
 // Streaming response
-await client.copilot.sendMessage(
-  [{ role: "user", content: "Tell me a story" }],
-  {
-    stream: true,
-    onChunk: (chunk) => console.log(chunk),
-  }
-);
+await client.copilot.sendMessage([{ role: "user", content: "Tell me a story" }], {
+  stream: true,
+  onChunk: (chunk) => console.log(chunk),
+});
 ```
 
 ### `client.function`

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@amaster.ai/client",
-  "version": "1.1.0-beta.3",
+  "version": "1.1.0-beta.5",
   "description": "Unified API client for Amaster platform - All services in one package",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -69,16 +69,16 @@
     "registry": "https://registry.npmjs.org/"
   },
   "dependencies": {
-    "@amaster.ai/bpm-client": "1.1.0-beta.3",
+    "@amaster.ai/asr-http-client": "1.1.0-beta.3",
     "@amaster.ai/copilot-client": "1.1.0-beta.3",
+    "@amaster.ai/entity-client": "1.1.0-beta.3",
+    "@amaster.ai/bpm-client": "1.1.0-beta.3",
+    "@amaster.ai/http-client": "1.1.0-beta.3",
+    "@amaster.ai/tts-client": "1.1.0-beta.3",
     "@amaster.ai/function-client": "1.1.0-beta.3",
     "@amaster.ai/auth-client": "1.1.0-beta.3",
     "@amaster.ai/asr-client": "1.1.0-beta.3",
-    "@amaster.ai/http-client": "1.1.0-beta.3",
-    "@amaster.ai/workflow-client": "1.1.0-beta.3",
-    "@amaster.ai/tts-client": "1.1.0-beta.3",
-    "@amaster.ai/entity-client": "1.1.0-beta.3",
-    "@amaster.ai/asr-http-client": "1.1.0-beta.3"
+    "@amaster.ai/workflow-client": "1.1.0-beta.3"
   },
   "peerDependencies": {
     "axios": "^1.11.0"

package/types/copilot.d.ts

@@ -10,6 +10,150 @@
 
 import type { ClientResult } from './common';
 
+// ============================================================================
+// A2UI Protocol Types (for streaming UI)
+// ============================================================================
+
+/**
+ * String value with data binding support
+ */
+export interface StringValue {
+  path?: string;
+  literalString?: string;
+  literal?: string;
+}
+
+/**
+ * Number value with data binding support
+ */
+export interface NumberValue {
+  path?: string;
+  literalNumber?: number;
+  literal?: number;
+}
+
+/**
+ * Boolean value with data binding support
+ */
+export interface BooleanValue {
+  path?: string;
+  literalBoolean?: boolean;
+  literal?: boolean;
+}
+
+/**
+ * Component properties in A2UI protocol
+ */
+export type ComponentProperties = Record<string, unknown>;
+
+/**
+ * Component instance from server
+ */
+export interface ComponentInstance {
+  id: string;
+  weight?: number;
+  component?: ComponentProperties;
+}
+
+/**
+ * Value map for data model updates
+ */
+export interface ValueMap {
+  key: string;
+  valueString?: string;
+  valueNumber?: number;
+  valueBoolean?: boolean;
+  valueMap?: ValueMap[];
+  [k: string]: unknown;
+}
+
+/**
+ * Begin rendering message - initializes a new UI surface
+ */
+export interface BeginRenderingMessage {
+  surfaceId: string;
+  root: string;
+  styles?: Record<string, string>;
+}
+
+/**
+ * Surface update message - updates UI components
+ */
+export interface SurfaceUpdateMessage {
+  surfaceId: string;
+  components: ComponentInstance[];
+}
+
+/**
+ * Data model update message - updates data bindings
+ */
+export interface DataModelUpdate {
+  surfaceId: string;
+  path?: string;
+  contents: ValueMap[];
+}
+
+/**
+ * Delete surface message - removes a UI surface
+ */
+export interface DeleteSurfaceMessage {
+  surfaceId: string;
+}
+
+/**
+ * Server-to-client message in A2UI protocol
+ * 
+ * Used by the chat() streaming API to send UI updates.
+ * Each message can contain one of several update types.
+ * 
+ * @example
+ * ```typescript
+ * const stream = client.copilot.chat([
+ *   { role: 'user', content: 'Show me a chart' }
+ * ]);
+ * 
+ * for await (const messages of stream) {
+ *   for (const msg of messages) {
+ *     if (msg.surfaceUpdate) {
+ *       // Render UI components
+ *       renderComponents(msg.surfaceUpdate.components);
+ *     }
+ *     if (msg.dataModelUpdate) {
+ *       // Update data bindings
+ *       updateData(msg.dataModelUpdate.contents);
+ *     }
+ *   }
+ * }
+ * ```
+ */
+export interface ServerToClientMessage {
+  beginRendering?: BeginRenderingMessage;
+  surfaceUpdate?: SurfaceUpdateMessage;
+  dataModelUpdate?: DataModelUpdate;
+  deleteSurface?: DeleteSurfaceMessage;
+}
+
+/**
+ * Complete UI surface state
+ */
+export interface Surface {
+  rootComponentId: string | null;
+  componentTree: unknown | null;
+  dataModel: Record<string, unknown>;
+  components: Map<string, ComponentInstance>;
+  styles: Record<string, string>;
+}
+
+/**
+ * Message processor for handling A2UI updates
+ */
+export interface MessageProcessor {
+  getSurfaces(): ReadonlyMap<string, Surface>;
+  clearSurfaces(): void;
+  processMessages(messages: ServerToClientMessage[]): void;
+  resolvePath(path: string, dataContextPath?: string): string;
+}
+
 /**
  * Text content in a message
  */

package/types/index.d.ts

@@ -54,6 +54,10 @@ import type { AuthClientAPI } from './auth/index';
 import type { EntityClientAPI } from './entity';
 import type { BpmClientAPI } from './bpm';
 import type { WorkflowClientAPI } from './workflow';
+import type { ASRClient } from './asr';
+import type { CopilotA2UIClient } from './copilot';
+import type { FunctionClient } from './function';
+import type { TTSClient } from './tts';
 
 /**
  * Configuration options for creating an Amaster client
@@ -335,6 +339,54 @@ export interface AmasterClient {
    */
   workflow: WorkflowClientAPI;
 
+  /**
+   * ASR (Automatic Speech Recognition) module
+   * 
+   * Provides methods for real-time speech-to-text conversion via WebSocket.
+   * 
+   * For detailed documentation, see {@link ./asr.d.ts}
+   */
+  asr: ASRClient;
+
+  /**
+   * Copilot AI Assistant module
+   * 
+   * Provides methods for interactive AI conversations with A2UI streaming.
+   * 
+   * For detailed documentation, see {@link ./copilot.d.ts}
+   * 
+   * @example
+   * Chat with AI:
+   * ```typescript
+   * const stream = client.copilot.chat([
+   *   { role: 'user', content: 'Hello' }
+   * ]);
+   * 
+   * for await (const messages of stream) {
+   *   // Process A2UI messages
+   * }
+   * ```
+   */
+  copilot: CopilotA2UIClient;
+
+  /**
+   * Serverless Function module
+   * 
+   * Provides methods for invoking serverless functions.
+   * 
+   * For detailed documentation, see {@link ./function.d.ts}
+   */
+  function: FunctionClient;
+
+  /**
+   * TTS (Text-to-Speech) module
+   * 
+   * Provides methods for real-time text-to-speech conversion via WebSocket.
+   * 
+   * For detailed documentation, see {@link ./tts.d.ts}
+   */
+  tts: TTSClient;
+
   /**
    * Check if the user is currently authenticated
    * 
@@ -491,9 +543,14 @@ export type { AuthClientAPI } from './auth';
 export type { EntityClientAPI } from './entity';
 export type { BpmClientAPI } from './bpm';
 export type { WorkflowClientAPI } from './workflow';
+export type { ASRClient } from './asr';
+export type { CopilotA2UIClient } from './copilot';
+export type { FunctionClient } from './function';
+export type { TTSClient } from './tts';
 
 // For detailed types, import directly from submodules:
 // import type { LoginParams, User } from '@amaster.ai/client/auth'
 // import type { EntityQueryParams } from '@amaster.ai/client/entity'
 // import type { Task, ProcessInstance } from '@amaster.ai/client/bpm'
 // import type { WorkflowRunRequest } from '@amaster.ai/client/workflow'
+// import type { ServerToClientMessage } from '@amaster.ai/client/copilot'