@applica-software-guru/persona-sdk 0.1.101 → 0.1.102

package/src/workflows/workflow-executions-api.ts

@@ -25,4 +25,70 @@ export class WorkflowExecutionsApi extends HttpApi {
   async queue(workflowId: string, request: ExecuteRequest): Promise<Execution> {
     return this.httpPost<Execution>('/workflows/' + workflowId + '/executions/queue', request);
   }
+
+  /** Runs across all workflows in the project (filter by status/workflow/date). */
+  async listRuns(filters: {
+    status?: string;
+    workflowId?: string;
+    dateFrom?: string;
+    dateTo?: string;
+    page?: number;
+    size?: number;
+  } = {}): Promise<Paginated<Execution>> {
+    const { page, size } = this.normalizePageParams(filters.page, filters.size);
+    const params: Record<string, unknown> = { page, size };
+    if (filters.status) params.status = filters.status;
+    if (filters.workflowId) params.workflowId = filters.workflowId;
+    if (filters.dateFrom) params.dateFrom = filters.dateFrom;
+    if (filters.dateTo) params.dateTo = filters.dateTo;
+    return this.httpGet<Paginated<Execution>>('/executions', params);
+  }
+
+  /** Request cancellation of a running/waiting execution (cascades to sub-workflows). */
+  async cancel(workflowId: string, executionId: string): Promise<Execution> {
+    return this.httpPost<Execution>(
+      '/workflows/' + workflowId + '/executions/' + executionId + '/cancel',
+      {},
+    );
+  }
+
+  /** Re-run an execution from a given node. mode: 'reuse_outputs' | 'fresh'. */
+  async rerun(
+    workflowId: string,
+    executionId: string,
+    fromNodeId: string,
+    mode: 'reuse_outputs' | 'fresh' = 'reuse_outputs',
+  ): Promise<Execution> {
+    return this.httpPost<Execution>(
+      '/workflows/' + workflowId + '/executions/' + executionId + '/rerun',
+      { fromNodeId, mode },
+    );
+  }
+
+  /** Execute a single node in isolation with the given inputs (debugging). */
+  async dryRunNode(
+    workflowId: string,
+    nodeId: string,
+    inputs: Record<string, unknown> = {},
+  ): Promise<Record<string, unknown>> {
+    return this.httpPost<Record<string, unknown>>(
+      '/workflows/' + workflowId + '/nodes/' + nodeId + '/dry-run',
+      { inputs },
+    );
+  }
+
+  /** Normalized action trace of an agent step (reasoning, tool calls, messages). */
+  async stepTrace(
+    workflowId: string,
+    executionId: string,
+    stepId: string,
+    page?: number,
+    size?: number,
+  ): Promise<Record<string, unknown>> {
+    const { page: p, size: s } = this.normalizePageParams(page, size ?? 200);
+    return this.httpGet<Record<string, unknown>>(
+      '/workflows/' + workflowId + '/executions/' + executionId + '/steps/' + stepId + '/trace',
+      { page: p, size: s },
+    );
+  }
 }

package/src/workflows/workflows-api.ts

@@ -4,6 +4,7 @@ import { AuthenticationProvider } from '../auth/authentication-provider';
 import { Revision } from '../revisions/types';
 import { Workflow } from './types';
 import { WorkflowExecutionsApi } from './workflow-executions-api';
+import { HumanTasksApi } from './human-tasks-api';
 
 export class WorkflowsApi extends HttpApi {
   constructor(baseUrl: string, auth: string | AuthenticationProvider) {
@@ -38,6 +39,10 @@ export class WorkflowsApi extends HttpApi {
     return new WorkflowExecutionsApi(this.getBaseUrl(), this.getAuthProvider());
   }
 
+  humanTasks(): HumanTasksApi {
+    return new HumanTasksApi(this.getBaseUrl(), this.getAuthProvider());
+  }
+
   async listRevisions(workflowId: string): Promise<Revision[]> {
     return this.httpGet<Revision[]>('/workflows/' + workflowId + '/revisions');
   }