@axiom-lattice/protocols 2.1.50 → 2.1.53

package/src/WorkflowTrackingStoreProtocol.ts

@@ -31,7 +31,7 @@ export interface WorkflowRun {
 }
 
 export type StepType = 'task_delegation' | 'tool_call' | 'human_in_loop' | 'topology_transition' | 'agent' | 'human_feedback' | 'map' | 'input' | 'terminal';
-export type StepStatus = 'running' | 'completed' | 'failed' | 'interrupted' | 'skipped';
+export type StepStatus = 'running' | 'completed' | 'failed' | 'interrupted' | 'skipped' | 'cancelled';
 
 export interface RunStep {
   id: string;
@@ -91,6 +91,24 @@ export interface UpdateRunStepRequest {
   durationMs?: number;
 }
 
+export interface QueryWorkflowRunsOptions {
+  /** Filter by run status (e.g. 'interrupted' for inbox). */
+  status?: WorkflowRunStatus;
+  /** Filter by assistant. */
+  assistantId?: string;
+  /** Max records to return. Omit to return all matching runs. */
+  limit?: number;
+  /** Records to skip. Applied before limit. */
+  offset?: number;
+}
+
+export interface QueryWorkflowRunsResult {
+  /** Matching runs, always ordered by updatedAt DESC. */
+  records: WorkflowRun[];
+  /** Total matching runs BEFORE limit/offset. */
+  total: number;
+}
+
 export interface WorkflowTrackingStore {
   // WorkflowRun CRUD
   createWorkflowRun(request: CreateWorkflowRunRequest): Promise<WorkflowRun>;
@@ -100,6 +118,11 @@ export interface WorkflowTrackingStore {
   getWorkflowRunsByThreadId(tenantId: string, threadId: string): Promise<WorkflowRun[]>;
   getWorkflowRunsByAssistantId(tenantId: string, assistantId: string): Promise<WorkflowRun[]>;
   getWorkflowRunsByTenantId(tenantId: string): Promise<WorkflowRun[]>;
+  /**
+   * Query runs with optional status/assistant filters and limit/offset pagination.
+   * Always ordered by updatedAt DESC. `total` counts all matching runs (ignores limit/offset).
+   */
+  queryWorkflowRuns(tenantId: string, options?: QueryWorkflowRunsOptions): Promise<QueryWorkflowRunsResult>;
 
   // RunStep CRUD
   createRunStep(request: CreateRunStepRequest): Promise<RunStep>;

package/src/index.ts

@@ -37,6 +37,7 @@ export * from "./VectorStoreProviderProtocol";
 export * from "./MenuProtocol";
 export * from "./EvalStoreProtocol";
 export * from "./TaskStoreProtocol";
+export * from "./TaskWorkItemProtocol";
 
 export * from "./ChannelAdapterProtocol";
 export * from "./A2AProtocol";
@@ -59,6 +60,7 @@ export type {
   PluginConnectionFieldSchema,
   PluginConnectionTestResult,
   PluginDiscoveredResource,
+  PluginContext,
   PluginToolMeta,
   PluginMiddlewareFactory,
 } from "./PluginProtocol";