@amaster.ai/client 1.1.0-beta.68 → 1.1.0-beta.69

package/package.json

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

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>;
+}