@agentforge4j/workflow-builder-react 0.2.1 → 0.2.2

package/dist/index.d.cts

@@ -188,4 +188,150 @@ declare class WorkflowParseError extends Error {
 declare function serializeWorkflowJson(workflow: WorkflowDefinition): string;
 declare function parseWorkflowJson(text: string): WorkflowDefinition;
 
-export { type AgentRef, type BuilderAction, type BuilderActions, type BuilderAdapters, type BuilderCapabilities, type BuilderState, type BuilderTheme, type ExportFormat, type UseBuilderStateResult, type ValidationIssue, type ValidationResult, WorkflowBuilder, type WorkflowBuilderProps, type WorkflowDefinition, WorkflowParseError, builderReducer, WorkflowBuilder as default, parseWorkflowJson, serializeWorkflowJson, useBuilderState, validateWorkflow };
+type NodeKind = 'ASK_USER' | 'AI_STEP' | 'AI_DEBATE' | 'DECISION' | 'REPEAT' | 'REUSE_WORKFLOW' | 'LOAD_RESOURCE' | 'STOP' | 'RETRY' | 'SAVE_RESULT';
+type NodeKindMeta = {
+    label: string;
+    description: string;
+    iconGlyph: string;
+    advanced?: boolean;
+};
+declare const NODE_KIND_META: Record<NodeKind, NodeKindMeta>;
+
+type LoopTerminationStrategy = 'AGENT_SIGNAL' | 'EVALUATOR' | 'FIXED_COUNT' | 'FOR_EACH';
+type MaxIterationsActionUi = 'AWAIT_USER' | 'FAIL';
+type ArtifactItemDraft = {
+    id: string;
+    type: EditableArtifactItem['type'];
+    label: string;
+    key: string;
+    required: boolean;
+    options?: string[];
+};
+type AskUserNodeData = {
+    name: string;
+    question: string;
+    artifactItems: ArtifactItemDraft[];
+};
+type AiStepNodeData = {
+    name: string;
+    agentRef: string;
+    instructions: string;
+    transition: StepTransition;
+    maxRetries: number;
+};
+type AiDebateNodeData = {
+    name: string;
+    primaryAgentRef: string;
+    challengerAgentRef: string;
+    maxRounds: number;
+    resolutionPrompt: string;
+    transition: StepTransition;
+};
+type DecisionCaseDraft = {
+    label: string;
+    value: string;
+    targetNodeId: string;
+};
+type DecisionNodeData = {
+    name: string;
+    contextKey: string;
+    cases: DecisionCaseDraft[];
+    defaultTargetNodeId: string;
+};
+type RepeatNodeData = {
+    name: string;
+    strategy: LoopTerminationStrategy;
+    maxIterations: number;
+    forEachKey?: string;
+    evaluatorAgentId?: string;
+    maxIterationsAction: MaxIterationsActionUi;
+    bodyNodeIds: string[];
+};
+type SaveResultNodeData = {
+    name: string;
+    resultName: string;
+};
+type ReuseWorkflowNodeData = {
+    name: string;
+    workflowRef: string;
+    transition: StepTransition;
+};
+type LoadResourceNodeData = {
+    name: string;
+    resourcePath: string;
+    resultName: string;
+    transition: StepTransition;
+};
+type StopNodeData = {
+    name: string;
+    reason: string;
+};
+type RetryNodeData = {
+    name: string;
+    targetNodeId: string;
+    maxAttempts: number;
+    fallbackTargetNodeId: string;
+    retryMode: 'SINGLE_STEP' | 'FROM_STEP';
+};
+type CanvasNodeBase = {
+    id: string;
+    backendStepId?: string;
+    position: {
+        x: number;
+        y: number;
+    };
+    parentNode?: string;
+};
+type CanvasNode = (CanvasNodeBase & {
+    kind: 'ASK_USER';
+    data: AskUserNodeData;
+}) | (CanvasNodeBase & {
+    kind: 'AI_STEP';
+    data: AiStepNodeData;
+}) | (CanvasNodeBase & {
+    kind: 'AI_DEBATE';
+    data: AiDebateNodeData;
+}) | (CanvasNodeBase & {
+    kind: 'DECISION';
+    data: DecisionNodeData;
+}) | (CanvasNodeBase & {
+    kind: 'REPEAT';
+    data: RepeatNodeData;
+}) | (CanvasNodeBase & {
+    kind: 'SAVE_RESULT';
+    data: SaveResultNodeData;
+}) | (CanvasNodeBase & {
+    kind: 'REUSE_WORKFLOW';
+    data: ReuseWorkflowNodeData;
+}) | (CanvasNodeBase & {
+    kind: 'LOAD_RESOURCE';
+    data: LoadResourceNodeData;
+}) | (CanvasNodeBase & {
+    kind: 'STOP';
+    data: StopNodeData;
+}) | (CanvasNodeBase & {
+    kind: 'RETRY';
+    data: RetryNodeData;
+});
+type CanvasEdge = {
+    id: string;
+    source: string;
+    target: string;
+    sourceHandle?: string | null;
+    label?: string | null;
+};
+type BlueprintDefinition = Record<string, unknown>;
+type CanvasModel = {
+    workflowId: string;
+    workflowName: string;
+    description: string;
+    startNodeId: string | null;
+    nodes: CanvasNode[];
+    edges: CanvasEdge[];
+    artifacts: Record<string, EditableArtifact>;
+    blueprints: Record<string, BlueprintDefinition>;
+    unsupported?: boolean;
+    unsupportedReasons?: string[];
+};
+
+export { type AgentRef, type BuilderAction, type BuilderActions, type BuilderAdapters, type BuilderCapabilities, type BuilderState, type BuilderTheme, type CanvasModel, type ExportFormat, NODE_KIND_META, type NodeKind, type UseBuilderStateResult, type ValidationIssue, type ValidationResult, WorkflowBuilder, type WorkflowBuilderProps, type WorkflowDefinition, WorkflowParseError, builderReducer, WorkflowBuilder as default, parseWorkflowJson, serializeWorkflowJson, useBuilderState, validateWorkflow };

package/dist/index.d.ts

@@ -188,4 +188,150 @@ declare class WorkflowParseError extends Error {
 declare function serializeWorkflowJson(workflow: WorkflowDefinition): string;
 declare function parseWorkflowJson(text: string): WorkflowDefinition;
 
-export { type AgentRef, type BuilderAction, type BuilderActions, type BuilderAdapters, type BuilderCapabilities, type BuilderState, type BuilderTheme, type ExportFormat, type UseBuilderStateResult, type ValidationIssue, type ValidationResult, WorkflowBuilder, type WorkflowBuilderProps, type WorkflowDefinition, WorkflowParseError, builderReducer, WorkflowBuilder as default, parseWorkflowJson, serializeWorkflowJson, useBuilderState, validateWorkflow };
+type NodeKind = 'ASK_USER' | 'AI_STEP' | 'AI_DEBATE' | 'DECISION' | 'REPEAT' | 'REUSE_WORKFLOW' | 'LOAD_RESOURCE' | 'STOP' | 'RETRY' | 'SAVE_RESULT';
+type NodeKindMeta = {
+    label: string;
+    description: string;
+    iconGlyph: string;
+    advanced?: boolean;
+};
+declare const NODE_KIND_META: Record<NodeKind, NodeKindMeta>;
+
+type LoopTerminationStrategy = 'AGENT_SIGNAL' | 'EVALUATOR' | 'FIXED_COUNT' | 'FOR_EACH';
+type MaxIterationsActionUi = 'AWAIT_USER' | 'FAIL';
+type ArtifactItemDraft = {
+    id: string;
+    type: EditableArtifactItem['type'];
+    label: string;
+    key: string;
+    required: boolean;
+    options?: string[];
+};
+type AskUserNodeData = {
+    name: string;
+    question: string;
+    artifactItems: ArtifactItemDraft[];
+};
+type AiStepNodeData = {
+    name: string;
+    agentRef: string;
+    instructions: string;
+    transition: StepTransition;
+    maxRetries: number;
+};
+type AiDebateNodeData = {
+    name: string;
+    primaryAgentRef: string;
+    challengerAgentRef: string;
+    maxRounds: number;
+    resolutionPrompt: string;
+    transition: StepTransition;
+};
+type DecisionCaseDraft = {
+    label: string;
+    value: string;
+    targetNodeId: string;
+};
+type DecisionNodeData = {
+    name: string;
+    contextKey: string;
+    cases: DecisionCaseDraft[];
+    defaultTargetNodeId: string;
+};
+type RepeatNodeData = {
+    name: string;
+    strategy: LoopTerminationStrategy;
+    maxIterations: number;
+    forEachKey?: string;
+    evaluatorAgentId?: string;
+    maxIterationsAction: MaxIterationsActionUi;
+    bodyNodeIds: string[];
+};
+type SaveResultNodeData = {
+    name: string;
+    resultName: string;
+};
+type ReuseWorkflowNodeData = {
+    name: string;
+    workflowRef: string;
+    transition: StepTransition;
+};
+type LoadResourceNodeData = {
+    name: string;
+    resourcePath: string;
+    resultName: string;
+    transition: StepTransition;
+};
+type StopNodeData = {
+    name: string;
+    reason: string;
+};
+type RetryNodeData = {
+    name: string;
+    targetNodeId: string;
+    maxAttempts: number;
+    fallbackTargetNodeId: string;
+    retryMode: 'SINGLE_STEP' | 'FROM_STEP';
+};
+type CanvasNodeBase = {
+    id: string;
+    backendStepId?: string;
+    position: {
+        x: number;
+        y: number;
+    };
+    parentNode?: string;
+};
+type CanvasNode = (CanvasNodeBase & {
+    kind: 'ASK_USER';
+    data: AskUserNodeData;
+}) | (CanvasNodeBase & {
+    kind: 'AI_STEP';
+    data: AiStepNodeData;
+}) | (CanvasNodeBase & {
+    kind: 'AI_DEBATE';
+    data: AiDebateNodeData;
+}) | (CanvasNodeBase & {
+    kind: 'DECISION';
+    data: DecisionNodeData;
+}) | (CanvasNodeBase & {
+    kind: 'REPEAT';
+    data: RepeatNodeData;
+}) | (CanvasNodeBase & {
+    kind: 'SAVE_RESULT';
+    data: SaveResultNodeData;
+}) | (CanvasNodeBase & {
+    kind: 'REUSE_WORKFLOW';
+    data: ReuseWorkflowNodeData;
+}) | (CanvasNodeBase & {
+    kind: 'LOAD_RESOURCE';
+    data: LoadResourceNodeData;
+}) | (CanvasNodeBase & {
+    kind: 'STOP';
+    data: StopNodeData;
+}) | (CanvasNodeBase & {
+    kind: 'RETRY';
+    data: RetryNodeData;
+});
+type CanvasEdge = {
+    id: string;
+    source: string;
+    target: string;
+    sourceHandle?: string | null;
+    label?: string | null;
+};
+type BlueprintDefinition = Record<string, unknown>;
+type CanvasModel = {
+    workflowId: string;
+    workflowName: string;
+    description: string;
+    startNodeId: string | null;
+    nodes: CanvasNode[];
+    edges: CanvasEdge[];
+    artifacts: Record<string, EditableArtifact>;
+    blueprints: Record<string, BlueprintDefinition>;
+    unsupported?: boolean;
+    unsupportedReasons?: string[];
+};
+
+export { type AgentRef, type BuilderAction, type BuilderActions, type BuilderAdapters, type BuilderCapabilities, type BuilderState, type BuilderTheme, type CanvasModel, type ExportFormat, NODE_KIND_META, type NodeKind, type UseBuilderStateResult, type ValidationIssue, type ValidationResult, WorkflowBuilder, type WorkflowBuilderProps, type WorkflowDefinition, WorkflowParseError, builderReducer, WorkflowBuilder as default, parseWorkflowJson, serializeWorkflowJson, useBuilderState, validateWorkflow };

package/dist/index.js

@@ -3526,6 +3526,7 @@ function WorkflowBuilder({
   ] });
 }
 export {
+  NODE_KIND_META,
   WorkflowBuilder,
   WorkflowParseError,
   builderReducer,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agentforge4j/workflow-builder-react",
-  "version": "0.2.1",
+  "version": "0.2.2",
   "private": false,
   "description": "Reusable React workflow builder for AgentForge4j",
   "license": "Apache-2.0",