@flowgram.ai/runtime-interface 0.1.0-alpha.10 → 0.1.0-alpha.12

package/dist/{index.d.mts → index.d.cts}

@@ -17,12 +17,11 @@ declare enum FlowGramAPIName {
     TaskReport = "TaskReport",
     TaskResult = "TaskResult",
     TaskCancel = "TaskCancel",
-    Validation = "Validation"
+    TaskValidate = "TaskValidate"
 }
 declare enum FlowGramAPIModule {
     Info = "Info",
-    Task = "Task",
-    Validation = "Validation"
+    Task = "Task"
 }
 
 /**
@@ -166,6 +165,20 @@ interface WorkflowNodeSchema<T = string, D = any> {
     edges?: WorkflowEdgeSchema[];
 }
 
+/**
+ * Copyright (c) 2025 Bytedance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ */
+
+interface WorkflowGroupSchema extends WorkflowNodeSchema {
+    data: {
+        title?: string;
+        color?: string;
+        parentID: string;
+        blockIDs: string[];
+    };
+}
+
 /**
  * Copyright (c) 2025 Bytedance Ltd. and/or its affiliates
  * SPDX-License-Identifier: MIT
@@ -174,6 +187,7 @@ interface WorkflowNodeSchema<T = string, D = any> {
 interface WorkflowSchema {
     nodes: WorkflowNodeSchema[];
     edges: WorkflowEdgeSchema[];
+    groups?: WorkflowGroupSchema[];
 }
 
 /**
@@ -212,6 +226,20 @@ interface InvokeParams {
 }
 type WorkflowRuntimeInvoke = (params: InvokeParams) => Promise<WorkflowInputs>;
 
+/**
+ * Copyright (c) 2025 Bytedance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ */
+
+interface ValidationResult {
+    valid: boolean;
+    errors?: string[];
+}
+interface IValidation {
+    invoke(params: InvokeParams): ValidationResult;
+}
+declare const IValidation: unique symbol;
+
 /**
  * Copyright (c) 2025 Bytedance Ltd. and/or its affiliates
  * SPDX-License-Identifier: MIT
@@ -290,63 +318,6 @@ interface IStatusCenter {
     exportNodeStatus(): Record<string, StatusData>;
 }
 
-/**
- * Copyright (c) 2025 Bytedance Ltd. and/or its affiliates
- * SPDX-License-Identifier: MIT
- */
-
-interface SnapshotData {
-    nodeID: string;
-    inputs: WorkflowInputs;
-    outputs: WorkflowOutputs;
-    data: any;
-    branch?: string;
-}
-interface Snapshot extends SnapshotData {
-    id: string;
-}
-interface ISnapshot {
-    id: string;
-    data: Partial<SnapshotData>;
-    addData(data: Partial<SnapshotData>): void;
-    validate(): boolean;
-    export(): Snapshot;
-}
-
-/**
- * Copyright (c) 2025 Bytedance Ltd. and/or its affiliates
- * SPDX-License-Identifier: MIT
- */
-
-interface ISnapshotCenter {
-    id: string;
-    create(snapshot: Partial<SnapshotData>): ISnapshot;
-    exportAll(): Snapshot[];
-    export(): Record<string, Snapshot[]>;
-    init(): void;
-    dispose(): void;
-}
-
-/**
- * Copyright (c) 2025 Bytedance Ltd. and/or its affiliates
- * SPDX-License-Identifier: MIT
- */
-
-interface IOData {
-    inputs: WorkflowInputs;
-    outputs: WorkflowOutputs;
-}
-/** Input & Output */
-interface IIOCenter {
-    inputs: WorkflowInputs;
-    outputs: WorkflowOutputs;
-    setInputs(inputs: WorkflowInputs): void;
-    setOutputs(outputs: WorkflowOutputs): void;
-    init(inputs: WorkflowInputs): void;
-    dispose(): void;
-    export(): IOData;
-}
-
 /**
  * Copyright (c) 2025 Bytedance Ltd. and/or its affiliates
  * SPDX-License-Identifier: MIT
@@ -356,13 +327,16 @@ declare enum FlowGramNode {
     Start = "start",
     End = "end",
     LLM = "llm",
-    code = "code",
+    Code = "code",
     Condition = "condition",
     Loop = "loop",
     Comment = "comment",
     Group = "group",
     BlockStart = "block-start",
-    BlockEnd = "block-end"
+    BlockEnd = "block-end",
+    HTTP = "http",
+    Break = "break",
+    Continue = "continue"
 }
 
 /**
@@ -473,6 +447,10 @@ interface IState {
         node: INode;
         outputs: WorkflowOutputs;
     }): void;
+    parseInputs(params: {
+        values: Record<string, IFlowValue>;
+        declare: IJsonSchema;
+    }): WorkflowInputs;
     parseRef<T = unknown>(ref: IFlowRefValue): IVariableParseResult<T> | null;
     parseTemplate(template: IFlowTemplateValue): IVariableParseResult<string> | null;
     parseValue<T = unknown>(flowValue: IFlowValue, type?: WorkflowVariableType): IVariableParseResult<T> | null;
@@ -480,6 +458,77 @@ interface IState {
     addExecutedNode(node: INode): void;
 }
 
+/**
+ * Copyright (c) 2025 Bytedance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ */
+
+interface SnapshotData {
+    nodeID: string;
+    inputs: WorkflowInputs;
+    outputs: WorkflowOutputs;
+    data: any;
+    branch?: string;
+    error?: string;
+}
+interface Snapshot extends SnapshotData {
+    id: string;
+}
+interface ISnapshot {
+    id: string;
+    data: Partial<SnapshotData>;
+    update(data: Partial<SnapshotData>): void;
+    validate(): boolean;
+    export(): Snapshot;
+}
+
+/**
+ * Copyright (c) 2025 Bytedance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ */
+
+interface ISnapshotCenter {
+    id: string;
+    create(snapshot: Partial<SnapshotData>): ISnapshot;
+    exportAll(): Snapshot[];
+    export(): Record<string, Snapshot[]>;
+    init(): void;
+    dispose(): void;
+}
+
+/**
+ * Copyright (c) 2025 Bytedance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ */
+declare enum WorkflowMessageType {
+    Log = "log",
+    Info = "info",
+    Debug = "debug",
+    Error = "error",
+    Warn = "warning"
+}
+interface MessageData {
+    message: string;
+    nodeID?: string;
+    timestamp?: number;
+}
+interface IMessage extends MessageData {
+    id: string;
+    type: WorkflowMessageType;
+    timestamp: number;
+}
+type WorkflowMessages = Record<WorkflowMessageType, IMessage[]>;
+interface IMessageCenter {
+    init(): void;
+    dispose(): void;
+    log(data: MessageData): IMessage;
+    info(data: MessageData): IMessage;
+    debug(data: MessageData): IMessage;
+    error(data: MessageData): IMessage;
+    warn(data: MessageData): IMessage;
+    export(): WorkflowMessages;
+}
+
 /**
  * Copyright (c) 2025 Bytedance Ltd. and/or its affiliates
  * SPDX-License-Identifier: MIT
@@ -489,33 +538,71 @@ interface NodeReport extends StatusData {
     id: string;
     snapshots: Snapshot[];
 }
+type WorkflowReports = Record<string, NodeReport>;
 interface IReport {
     id: string;
     inputs: WorkflowInputs;
     outputs: WorkflowOutputs;
     workflowStatus: StatusData;
-    reports: Record<string, NodeReport>;
+    reports: WorkflowReports;
+    messages: WorkflowMessages;
 }
 interface IReporter {
     snapshotCenter: ISnapshotCenter;
     statusCenter: IStatusCenter;
+    messageCenter: IMessageCenter;
     init(): void;
     dispose(): void;
     export(): IReport;
 }
 
+/**
+ * Copyright (c) 2025 Bytedance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ */
+
+interface IOData {
+    inputs: WorkflowInputs;
+    outputs: WorkflowOutputs;
+}
+/** Input & Output */
+interface IIOCenter {
+    inputs: WorkflowInputs;
+    outputs: WorkflowOutputs;
+    setInputs(inputs: WorkflowInputs): void;
+    setOutputs(outputs: WorkflowOutputs): void;
+    init(inputs: WorkflowInputs): void;
+    dispose(): void;
+    export(): IOData;
+}
+
+/**
+ * Copyright (c) 2025 Bytedance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ */
+interface ICache<K = string, V = any> {
+    init(): void;
+    dispose(): void;
+    get(key: K): V;
+    set(key: K, value: V): this;
+    delete(key: K): boolean;
+    has(key: K): boolean;
+}
+
 /**
  * Copyright (c) 2025 Bytedance Ltd. and/or its affiliates
  * SPDX-License-Identifier: MIT
  */
 
 interface ContextData {
+    cache: ICache;
     variableStore: IVariableStore;
     state: IState;
     document: IDocument;
     ioCenter: IIOCenter;
     snapshotCenter: ISnapshotCenter;
     statusCenter: IStatusCenter;
+    messageCenter: IMessageCenter;
     reporter: IReporter;
 }
 interface IContext extends ContextData {
@@ -636,6 +723,96 @@ interface ConditionNodeData {
 }
 type ConditionNodeSchema = WorkflowNodeSchema<FlowGramNode.Condition, ConditionNodeData>;
 
+/**
+ * Copyright (c) 2025 Bytedance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ */
+declare enum HTTPMethod {
+    Get = "GET",
+    Post = "POST",
+    Put = "PUT",
+    Delete = "DELETE",
+    Patch = "PATCH",
+    Head = "HEAD"
+}
+declare enum HTTPBodyType {
+    None = "none",
+    FormData = "form-data",
+    XWwwFormUrlencoded = "x-www-form-urlencoded",
+    RawText = "raw-text",
+    JSON = "JSON",
+    Binary = "binary"
+}
+
+/**
+ * Copyright (c) 2025 Bytedance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ */
+
+interface HTTPNodeData {
+    title: string;
+    outputs: IJsonSchema<'object'>;
+    api: {
+        method: HTTPMethod;
+        url: IFlowTemplateValue;
+    };
+    headers: IJsonSchema<'object'>;
+    headersValues: Record<string, IFlowConstantRefValue>;
+    params: IJsonSchema<'object'>;
+    paramsValues: Record<string, IFlowConstantRefValue>;
+    body: {
+        bodyType: HTTPBodyType;
+        json?: IFlowTemplateValue;
+        formData?: IJsonSchema<'object'>;
+        formDataValues?: Record<string, IFlowConstantRefValue>;
+        rawText?: IFlowTemplateValue;
+        binary?: IFlowTemplateValue;
+        xWwwFormUrlencoded?: IJsonSchema<'object'>;
+        xWwwFormUrlencodedValues?: Record<string, IFlowConstantRefValue>;
+    };
+    timeout: {
+        retryTimes: number;
+        timeout: number;
+    };
+}
+
+type HTTPNodeSchema = WorkflowNodeSchema<FlowGramNode.HTTP, HTTPNodeData>;
+
+/**
+ * Copyright (c) 2025 Bytedance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ */
+
+interface CodeNodeData {
+    title: string;
+    inputsValues: Record<string, IFlowValue>;
+    inputs: IJsonSchema<'object'>;
+    outputs: IJsonSchema<'object'>;
+    script: {
+        language: 'javascript';
+        content: string;
+    };
+}
+type CodeNodeSchema = WorkflowNodeSchema<FlowGramNode.Code, CodeNodeData>;
+
+/**
+ * Copyright (c) 2025 Bytedance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ */
+
+interface BreakNodeData {
+}
+type BreakNodeSchema = WorkflowNodeSchema<FlowGramNode.Break, BreakNodeData>;
+
+/**
+ * Copyright (c) 2025 Bytedance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ */
+
+interface ContinueNodeData {
+}
+type ContinueNodeSchema = WorkflowNodeSchema<FlowGramNode.Continue, ContinueNodeData>;
+
 /**
  * Copyright (c) 2025 Bytedance Ltd. and/or its affiliates
  * SPDX-License-Identifier: MIT
@@ -646,6 +823,7 @@ interface ExecutionContext {
     inputs: WorkflowInputs;
     container: IContainer;
     runtime: IContext;
+    snapshot: ISnapshot;
 }
 interface ExecutionResult {
     outputs: WorkflowOutputs;
@@ -676,6 +854,7 @@ declare const IExecutor: unique symbol;
  */
 
 interface EngineServices {
+    Validation: IValidation;
     Executor: IExecutor;
 }
 interface IEngine {
@@ -687,20 +866,6 @@ interface IEngine {
 }
 declare const IEngine: unique symbol;
 
-/**
- * Copyright (c) 2025 Bytedance Ltd. and/or its affiliates
- * SPDX-License-Identifier: MIT
- */
-
-interface ValidationResult {
-    valid: boolean;
-    errors?: string[];
-}
-interface IValidation {
-    validate(schema: WorkflowSchema): ValidationResult;
-}
-declare const IValidation: unique symbol;
-
 /**
  * Copyright (c) 2025 Bytedance Ltd. and/or its affiliates
  * SPDX-License-Identifier: MIT
@@ -748,12 +913,13 @@ declare const TaskReportDefine: FlowGramAPIDefine;
  * SPDX-License-Identifier: MIT
  */
 
-interface ValidationReq {
+interface TaskValidateInput {
+    inputs: WorkflowInputs;
     schema: string;
 }
-interface ValidationRes extends ValidationResult {
+interface TaskValidateOutput extends ValidationResult {
 }
-declare const ValidationDefine: FlowGramAPIDefine;
+declare const TaskValidateDefine: FlowGramAPIDefine;
 
 /**
  * Copyright (c) 2025 Bytedance Ltd. and/or its affiliates
@@ -789,6 +955,7 @@ interface IRuntimeClient {
     [FlowGramAPIName.TaskReport]: (input: TaskReportInput) => Promise<TaskReportOutput | undefined>;
     [FlowGramAPIName.TaskResult]: (input: TaskResultInput) => Promise<TaskResultOutput | undefined>;
     [FlowGramAPIName.TaskCancel]: (input: TaskCancelInput) => Promise<TaskCancelOutput | undefined>;
+    [FlowGramAPIName.TaskValidate]: (input: TaskValidateInput) => Promise<TaskValidateOutput | undefined>;
 }
 
-export { type ConditionItem, type ConditionNodeSchema, ConditionOperation, type ContainerService, type ContextData, type CreateEdgeParams, type CreateNodeParams, type CreatePortParams, type EndNodeSchema, type EngineServices, type ExecutionContext, type ExecutionResult, type FlowGramAPIDefine, type FlowGramAPIDefines, FlowGramAPIMethod, FlowGramAPIModule, FlowGramAPIName, FlowGramAPINames, FlowGramAPIs, FlowGramNode, type IBasicJsonSchema, type IContainer, type IContext, type IDocument, type IEdge, IEngine, IExecutor, type IFlowConstantRefValue, type IFlowConstantValue, type IFlowRefValue, type IFlowTemplateValue, type IFlowValue, type IIOCenter, type IJsonSchema, type INode, type INodeExecutor, type INodeExecutorFactory, type IOData, type IPort, type IReport, type IReporter, type IRuntimeClient, type ISnapshot, type ISnapshotCenter, type IState, type IStatus, type IStatusCenter, type ITask, IValidation, type IVariable, type IVariableParseResult, type IVariableStore, type InvokeParams, type JsonSchemaBasicType, type LLMNodeSchema, type LoopNodeSchema, type NodeReport, type NodeDeclare as NodeVariable, type PositionSchema, ServerInfoDefine, type ServerInfoInput, type ServerInfoOutput, type Snapshot, type SnapshotData, type StartNodeSchema, type StatusData, TaskCancelDefine, type TaskCancelInput, type TaskCancelOutput, type TaskParams, TaskReportDefine, type TaskReportInput, type TaskReportOutput, TaskResultDefine, type TaskResultInput, type TaskResultOutput, TaskRunDefine, type TaskRunInput, type TaskRunOutput, type VOData, ValidationDefine, type ValidationReq, type ValidationRes, type ValidationResult, type WorkflowEdgeSchema, type WorkflowInputs, type WorkflowNodeMetaSchema, type WorkflowNodeSchema, type WorkflowOutputs, WorkflowPortType, type WorkflowRuntimeInvoke, type WorkflowSchema, WorkflowStatus, WorkflowVariableType, type XYSchema };
+export { type BreakNodeSchema, type CodeNodeSchema, type ConditionItem, type ConditionNodeSchema, ConditionOperation, type ContainerService, type ContextData, type ContinueNodeSchema, type CreateEdgeParams, type CreateNodeParams, type CreatePortParams, type EndNodeSchema, type EngineServices, type ExecutionContext, type ExecutionResult, type FlowGramAPIDefine, type FlowGramAPIDefines, FlowGramAPIMethod, FlowGramAPIModule, FlowGramAPIName, FlowGramAPINames, FlowGramAPIs, FlowGramNode, HTTPBodyType, HTTPMethod, type HTTPNodeSchema, type IBasicJsonSchema, type ICache, type IContainer, type IContext, type IDocument, type IEdge, IEngine, IExecutor, type IFlowConstantRefValue, type IFlowConstantValue, type IFlowRefValue, type IFlowTemplateValue, type IFlowValue, type IIOCenter, type IJsonSchema, type IMessage, type IMessageCenter, type INode, type INodeExecutor, type INodeExecutorFactory, type IOData, type IPort, type IReport, type IReporter, type IRuntimeClient, type ISnapshot, type ISnapshotCenter, type IState, type IStatus, type IStatusCenter, type ITask, IValidation, type IVariable, type IVariableParseResult, type IVariableStore, type InvokeParams, type JsonSchemaBasicType, type LLMNodeSchema, type LoopNodeSchema, type MessageData, type NodeReport, type NodeDeclare as NodeVariable, type PositionSchema, ServerInfoDefine, type ServerInfoInput, type ServerInfoOutput, type Snapshot, type SnapshotData, type StartNodeSchema, type StatusData, TaskCancelDefine, type TaskCancelInput, type TaskCancelOutput, type TaskParams, TaskReportDefine, type TaskReportInput, type TaskReportOutput, TaskResultDefine, type TaskResultInput, type TaskResultOutput, TaskRunDefine, type TaskRunInput, type TaskRunOutput, TaskValidateDefine, type TaskValidateInput, type TaskValidateOutput, type VOData, type ValidationResult, type WorkflowEdgeSchema, type WorkflowInputs, WorkflowMessageType, type WorkflowMessages, type WorkflowNodeMetaSchema, type WorkflowNodeSchema, type WorkflowOutputs, WorkflowPortType, type WorkflowReports, type WorkflowRuntimeInvoke, type WorkflowSchema, WorkflowStatus, WorkflowVariableType, type XYSchema };