@amaster.ai/client 1.1.42 → 1.1.43-beta.2

package/dist/index.d.cts

@@ -5,7 +5,7 @@ export { EntityGetParams, EntityListResponse, EntityQueryParams, FilterGroup, Fi
 import { BpmClient } from '@amaster.ai/bpm-client';
 export { ActivityInstanceTree, CamundaVariable, HistoryActivityInstance, HistoryProcessInstance, HistoryTask, ProcessInstance, ProcessVariable, Task, TaskFormSchema, TaskQueryParams, UserOperationLog } from '@amaster.ai/bpm-client';
 import { WorkflowClient } from '@amaster.ai/workflow-client';
-export { WorkflowFile, WorkflowInputValue, WorkflowRunRequest, WorkflowRunResponse } from '@amaster.ai/workflow-client';
+export { WorkflowFile, WorkflowInputValue, WorkflowNodeUsage, WorkflowRunRequest, WorkflowRunResponse, WorkflowRunUsage, WorkflowUsageSummary } from '@amaster.ai/workflow-client';
 import { ASRClientConfig, ASRClient, ASRHttpClientConfig, ASRHttpClient } from '@amaster.ai/asr-client';
 export { ASRClient, ASRClientConfig, ASRHttpClient, ASRHttpClientConfig, ASRLanguage } from '@amaster.ai/asr-client';
 import { CopilotClient } from '@amaster.ai/copilot-client';

package/dist/index.d.ts

@@ -5,7 +5,7 @@ export { EntityGetParams, EntityListResponse, EntityQueryParams, FilterGroup, Fi
 import { BpmClient } from '@amaster.ai/bpm-client';
 export { ActivityInstanceTree, CamundaVariable, HistoryActivityInstance, HistoryProcessInstance, HistoryTask, ProcessInstance, ProcessVariable, Task, TaskFormSchema, TaskQueryParams, UserOperationLog } from '@amaster.ai/bpm-client';
 import { WorkflowClient } from '@amaster.ai/workflow-client';
-export { WorkflowFile, WorkflowInputValue, WorkflowRunRequest, WorkflowRunResponse } from '@amaster.ai/workflow-client';
+export { WorkflowFile, WorkflowInputValue, WorkflowNodeUsage, WorkflowRunRequest, WorkflowRunResponse, WorkflowRunUsage, WorkflowUsageSummary } from '@amaster.ai/workflow-client';
 import { ASRClientConfig, ASRClient, ASRHttpClientConfig, ASRHttpClient } from '@amaster.ai/asr-client';
 export { ASRClient, ASRClientConfig, ASRHttpClient, ASRHttpClientConfig, ASRLanguage } from '@amaster.ai/asr-client';
 import { CopilotClient } from '@amaster.ai/copilot-client';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@amaster.ai/client",
-  "version": "1.1.42",
+  "version": "1.1.43-beta.2",
   "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/asr-client": "1.1.42",
-    "@amaster.ai/copilot-client": "1.1.42",
-    "@amaster.ai/entity-client": "1.1.42",
-    "@amaster.ai/function-client": "1.1.42",
-    "@amaster.ai/auth-client": "1.1.42",
-    "@amaster.ai/bpm-client": "1.1.42",
-    "@amaster.ai/http-client": "1.1.42",
-    "@amaster.ai/s3-client": "1.1.42",
-    "@amaster.ai/tts-client": "1.1.42",
-    "@amaster.ai/workflow-client": "1.1.42"
+    "@amaster.ai/asr-client": "1.1.43-beta.2",
+    "@amaster.ai/bpm-client": "1.1.43-beta.2",
+    "@amaster.ai/function-client": "1.1.43-beta.2",
+    "@amaster.ai/auth-client": "1.1.43-beta.2",
+    "@amaster.ai/copilot-client": "1.1.43-beta.2",
+    "@amaster.ai/entity-client": "1.1.43-beta.2",
+    "@amaster.ai/tts-client": "1.1.43-beta.2",
+    "@amaster.ai/s3-client": "1.1.43-beta.2",
+    "@amaster.ai/http-client": "1.1.43-beta.2",
+    "@amaster.ai/workflow-client": "1.1.43-beta.2"
   },
   "peerDependencies": {
     "axios": "^1.11.0"

package/types/index.d.ts

@@ -399,8 +399,11 @@ export type {
 } from "./bpm";
 export type {
   WorkflowClientAPI,
+  WorkflowNodeUsage,
   WorkflowRunRequest,
   WorkflowRunResponse,
+  WorkflowRunUsage,
+  WorkflowUsageSummary,
   WorkflowInputValue,
   WorkflowFile,
 } from "./workflow";

package/types/workflow.d.ts

@@ -61,6 +61,52 @@ export interface WorkflowRunRequest {
   files?: WorkflowFile[];
   /** Trace ID for debugging */
   trace_id?: string;
+  /** Include workflow and node usage in blocking run response */
+  usage?: boolean;
+  /** Include node-level usage details when `usage` is enabled */
+  usage_detail?: boolean;
+}
+
+/**
+ * Workflow usage summary.
+ */
+export interface WorkflowUsageSummary {
+  workflow_run_id: string;
+  status: string;
+  total_tokens: number;
+  total_steps: number;
+  elapsed_time: number;
+  created_at: number | null;
+  finished_at: number | null;
+  is_finished: boolean;
+}
+
+/**
+ * Per-node workflow usage detail.
+ */
+export interface WorkflowNodeUsage {
+  id: string;
+  node_execution_id: string | null;
+  index: number;
+  node_id: string;
+  node_type: string;
+  title: string;
+  status: string;
+  error: string | null;
+  elapsed_time: number;
+  created_at: number | null;
+  finished_at: number | null;
+  usage: Record<string, unknown>;
+  execution_metadata: Record<string, unknown>;
+}
+
+/**
+ * Workflow usage returned when run request includes `usage: true`.
+ */
+export interface WorkflowRunUsage {
+  summary: WorkflowUsageSummary;
+  estimated_price_by_currency?: Record<string, string>;
+  nodes?: WorkflowNodeUsage[];
 }
 
 /**
@@ -92,6 +138,8 @@ export interface WorkflowRunResponse<TOutput = Record<string, unknown>> {
   created_at: number;
   /** Completion timestamp (Unix time in milliseconds) */
   finished_at: number;
+  /** Optional usage detail returned when request includes `usage: true` */
+  usage?: WorkflowRunUsage;
 }
 
 // ==================== Workflow Client API ====================