@axiom-lattice/protocols 2.1.41 → 2.1.43

package/src/UILatticeProtocol.ts

@@ -39,8 +39,8 @@ export interface UIConfig {
  */
 export interface UIComponent<T = any> {
   render: (props?: any) => T;
-  addEventListener: (event: string, handler: Function) => void;
-  removeEventListener: (event: string, handler: Function) => void;
+  addEventListener: (event: string, handler: (...args: unknown[]) => void) => void;
+  removeEventListener: (event: string, handler: (...args: unknown[]) => void) => void;
 }
 
 /**
@@ -52,6 +52,6 @@ export interface UILatticeProtocol<T = any>
   render: (props?: any) => T;
 
   // 事件处理
-  addEventListener: (event: string, handler: Function) => void;
-  removeEventListener: (event: string, handler: Function) => void;
+  addEventListener: (event: string, handler: (...args: unknown[]) => void) => void;
+  removeEventListener: (event: string, handler: (...args: unknown[]) => void) => void;
 }

package/src/WorkflowDSL.ts

@@ -0,0 +1,72 @@
+/**
+ * YAML Workflow DSL — linear model with parallel blocks
+ *
+ * Steps execute top-to-bottom. `parallel:` blocks declare concurrency.
+ * `if` on any step skips it. `map` iterates over arrays.
+ * No `needs` — execution order = reading order.
+ *
+ * Template syntax:
+ *   {{input}}        — initial user input
+ *   {{label}}        — output of step with given label
+ *   {{label.field}}  — nested field access on structured output
+ *   {{item}}         — current element in map iterations
+ */
+
+// ─── Top-level ─────────────────────────────────────────────────────────────
+
+export interface YamlWorkflow {
+  /** Optional workflow name — defaults to "workflow" if omitted. */
+  name?: string;
+  steps: YamlTopLevelStep[];
+}
+
+export type YamlTopLevelStep = YamlAgentStep | YamlParallelBlock | YamlMapStep;
+
+// ─── Agent step ────────────────────────────────────────────────────────────
+
+export interface YamlAgentStep {
+  /** Unique label serving as state key and template reference. */
+  label: string;
+  /** JS expression evaluated as boolean. Step skipped when falsy. */
+  if?: string;
+  /** Agent instruction with {{template}} references. */
+  prompt: string;
+  /** Shorthand output schema: { field: "string" | "number" | "boolean" } */
+  output?: Record<string, unknown>;
+  /** When true, inject ask_user_to_clarify middleware. */
+  ask?: boolean;
+}
+
+// ─── Parallel block ────────────────────────────────────────────────────────
+
+export interface YamlParallelBlock {
+  parallel: YamlAgentStep[];
+  /** JS expression evaluated as boolean. Entire block skipped when falsy. */
+  if?: string;
+  /** Shorthand output schema for aggregated results. */
+  output?: Record<string, unknown>;
+}
+
+// ─── Map step ──────────────────────────────────────────────────────────────
+
+export interface YamlMapStep {
+  map: {
+    /** Path to source array (e.g. "extract.items"). */
+    source: string;
+    /** Step label for referencing in templates (e.g. {{label}}). */
+    label: string;
+    /** JS expression evaluated as boolean. Entire map skipped when falsy. */
+    if?: string;
+    /** Agent applied to each element. Use {{item}} for current element. */
+    each: {
+      prompt: string;
+      output?: Record<string, unknown>;
+    };
+    /** Shorthand output schema for the aggregated results. */
+    output?: Record<string, unknown>;
+    /** Items per batch (default 50). */
+    batch?: number;
+    /** Max parallel items (default 5). */
+    concurrency?: number;
+  };
+}

package/src/WorkflowTrackingStoreProtocol.ts

@@ -11,7 +11,7 @@ export interface TopologyEdge {
   purpose: string;
 }
 
-export type WorkflowRunStatus = 'running' | 'completed' | 'failed' | 'cancelled';
+export type WorkflowRunStatus = 'running' | 'completed' | 'failed' | 'cancelled' | 'interrupted';
 
 export interface WorkflowRun {
   id: string;
@@ -25,13 +25,13 @@ export interface WorkflowRun {
   errorMessage?: string;
   metadata?: Record<string, any>;
   startedAt: Date;
-  completedAt?: Date;
+  completedAt?: Date | null;
   createdAt: Date;
   updatedAt: Date;
 }
 
-export type StepType = 'task_delegation' | 'tool_call' | 'human_in_loop' | 'topology_transition';
-export type StepStatus = 'running' | 'completed' | 'failed' | 'interrupted';
+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 interface RunStep {
   id: string;
@@ -39,6 +39,8 @@ export interface RunStep {
   tenantId: string;
   stepType: StepType;
   stepName: string;
+  /** Sub-agent thread_id for agent/map steps. null for input/terminal. */
+  threadId?: string | null;
   edgeFrom?: string;
   edgeTo?: string;
   edgePurpose?: string;
@@ -47,7 +49,7 @@ export interface RunStep {
   status: StepStatus;
   errorMessage?: string;
   startedAt: Date;
-  completedAt?: Date;
+  completedAt?: Date | null;
   durationMs?: number;
   createdAt: Date;
   updatedAt: Date;
@@ -65,7 +67,7 @@ export interface UpdateWorkflowRunRequest {
   status?: WorkflowRunStatus;
   completedEdges?: number;
   errorMessage?: string;
-  completedAt?: Date;
+  completedAt?: Date | null;
   metadata?: Record<string, any>;
 }
 
@@ -74,6 +76,7 @@ export interface CreateRunStepRequest {
   tenantId: string;
   stepType: StepType;
   stepName: string;
+  threadId?: string | null;
   edgeFrom?: string;
   edgeTo?: string;
   edgePurpose?: string;
@@ -84,7 +87,7 @@ export interface UpdateRunStepRequest {
   status?: StepStatus;
   output?: Record<string, any>;
   errorMessage?: string;
-  completedAt?: Date;
+  completedAt?: Date | null;
   durationMs?: number;
 }
 
@@ -100,6 +103,8 @@ export interface WorkflowTrackingStore {
 
   // RunStep CRUD
   createRunStep(request: CreateRunStepRequest): Promise<RunStep>;
+  /** Idempotent create — uses (runId, stepType, stepName) as unique key. Returns existing step if one already exists. */
+  upsertRunStep(request: CreateRunStepRequest): Promise<RunStep>;
   updateRunStep(runId: string, stepId: string, updates: UpdateRunStepRequest): Promise<RunStep | null>;
   getRunSteps(runId: string): Promise<RunStep[]>;
   getRunStepsByType(runId: string, stepType: StepType): Promise<RunStep[]>;

package/src/index.ts

@@ -31,11 +31,19 @@ export * from "./UserStoreProtocol";
 export * from "./UserTenantLinkProtocol";
 export * from "./WorkflowTrackingStoreProtocol";
 export * from "./BindingProtocol";
+export * from "./MenuProtocol";
 export * from "./EvalStoreProtocol";
+export * from "./TaskStoreProtocol";
 
 export * from "./ChannelAdapterProtocol";
 export * from "./A2AProtocol";
 export * from "./A2AApiKeyStoreProtocol";
 
+// Workflow DSL (concise, public API)
+export * from "./WorkflowDSL";
+
+// Internal DSL (expanded IR, internal use)
+export * from "./InternalDSL";
+
 // 导出通用类型
 export * from "./types";