@oomol-lab/open-flow 0.1.0-beta.2 → 0.1.0-beta.20

package/dist/browser/flow-change-schema.d.ts

@@ -0,0 +1,6 @@
+import type { ChangeOperation, FlowDocument, JsonValue, RevisionContent } from './flow-change.js';
+export declare function decodeFlowDocument(value: unknown): FlowDocument;
+export declare function decodeRevisionContent(value: unknown): RevisionContent;
+export declare function decodeRevisionEnvelope(value: unknown): RevisionContent;
+export declare function decodeChangeOperations(value: unknown): readonly ChangeOperation[];
+export declare function changeOperationsSchema(kind?: string): JsonValue;

package/dist/browser/flow-change.d.ts

@@ -1,3 +1,4 @@
+export { changeOperationsSchema, decodeChangeOperations } from './flow-change-schema.js';
 export type JsonValue = null | boolean | number | string | readonly JsonValue[] | {
     readonly [key: string]: JsonValue;
 };
@@ -48,7 +49,6 @@ export interface OutputMapping {
     readonly sources: readonly (FlowSource | NodeSource)[];
 }
 interface GraphNodeBase {
-    readonly concurrency: number;
     readonly description?: string;
     readonly icon?: string;
     readonly inputs: Readonly<Record<string, InputMapping>>;
@@ -63,6 +63,19 @@ export interface ValueNode extends GraphNodeBase {
     readonly kind: 'value';
     readonly values: readonly InputPort[];
 }
+export type WaitAction = 'approve' | 'continue' | 'reject';
+export interface WaitNode extends GraphNodeBase {
+    readonly actions: readonly ['continue'] | readonly ['approve', 'reject'];
+    readonly input: InputPort;
+    readonly kind: 'wait';
+    readonly notification?: {
+        readonly inputs: Readonly<Record<string, InputMapping>>;
+        readonly messageHandle: string;
+        readonly taskId: string;
+    };
+    readonly prompt: string;
+    readonly timeoutMs?: never;
+}
 export type ConditionOperator = '!=' | '<' | '<=' | '==' | '>' | '>=' | 'contains' | 'endsWith' | 'hasKey' | 'hasValue' | 'isEmpty' | 'isFalse' | 'isNotEmpty' | 'isNotNull' | 'isNull' | 'isTrue' | 'notContains' | 'notHasKey' | 'notHasValue' | 'startsWith';
 export interface ConditionExpression {
     readonly input: string;
@@ -87,12 +100,54 @@ export type ManagedTaskExecutor = {
 } | {
     readonly kind: 'llm';
     readonly mode: 'chat' | 'json';
+} | {
+    readonly kind: 'agent';
+    readonly code?: boolean;
+    readonly model: string;
+    readonly prompt: Exclude<AgentInput, {
+        readonly kind: 'model';
+    }>;
+    readonly system: string;
+    readonly maxRounds: number;
+    readonly tools: readonly AgentTool[];
+    readonly notification?: {
+        readonly taskId: string;
+        readonly messageHandle: string;
+        readonly inputs: Readonly<Record<string, Exclude<AgentInput, {
+            readonly kind: 'model';
+        }>>>;
+    };
+};
+export type AgentInput = {
+    readonly kind: 'value';
+    readonly value: JsonValue;
+} | {
+    readonly kind: 'input';
+    readonly input: string;
+} | {
+    readonly kind: 'model';
 };
+export interface AgentTool {
+    readonly id: string;
+    readonly name: string;
+    readonly description: string;
+    readonly action: string;
+    readonly connectionId?: string;
+    readonly approval: boolean;
+    readonly inputs: readonly (InputPort & {
+        readonly source: AgentInput;
+    })[];
+}
 export interface ConnectorCapability {
     readonly action: string;
-    readonly connectionId: string;
+    readonly connections: readonly {
+        readonly connectionId: string;
+        readonly alias?: string;
+    }[];
+    readonly connectionId?: string;
     readonly kind: 'connector';
 }
+export declare function decodeConnectorCapabilities(value: unknown): readonly ConnectorCapability[];
 interface TaskDefinitionBase {
     readonly inputs: readonly (InputPort | Group)[];
     readonly name: string;
@@ -109,13 +164,16 @@ export type TaskDefinition = InlineTaskDefinition | ManagedTaskDefinition;
 export type TaskNode = GraphNodeBase & {
     readonly kind: 'task';
 } & ({
+    readonly additionalInputs?: readonly InputPort[];
     readonly task: InlineTaskDefinition;
     readonly taskId?: never;
 } | {
+    readonly additionalInputs?: readonly InputPort[];
     readonly task?: never;
     readonly taskId: string;
 });
 export interface Graph {
+    readonly edges: readonly GraphEdge[];
     readonly nodes: Readonly<Record<string, GraphNode>>;
 }
 export type TriggerSchedule = {
@@ -170,6 +228,8 @@ interface TriggerNodeBase {
     readonly name: string;
 }
 export type TriggerNode = (TriggerNodeBase & {
+    readonly kind: 'manual';
+}) | (TriggerNodeBase & {
     readonly inputsDef: readonly WebhookInputDefinition[];
     readonly kind: 'webhook';
     readonly options?: WebhookOptions;
@@ -192,7 +252,7 @@ export type TriggerNode = (TriggerNodeBase & {
     };
     readonly kind: 'integration';
 });
-export type GraphNode = ConditionNode | SubflowNode | TaskNode | TriggerNode | ValueNode;
+export type GraphNode = ConditionNode | SubflowNode | TaskNode | TriggerNode | ValueNode | WaitNode;
 export interface FlowDocument {
     readonly bindings: Readonly<Record<string, {
         readonly kind: 'connection' | 'variable';
@@ -225,21 +285,30 @@ export type GraphTarget = {
 };
 export interface GraphEdge {
     readonly source: string;
-    readonly sourceHandle: string;
+    readonly sourceHandle?: string;
     readonly target: string;
-    readonly targetHandle: string;
 }
+export declare function normalizeNodeName(value: string): string;
+export declare function nextNodeName(value: string, names: Iterable<string>): string;
+export declare function nodeNameIssue(graph: Graph, nodeId: string, value: string): 'duplicate' | 'empty' | undefined;
 export type ChangeOperation = {
+    readonly before?: readonly ConnectorCapability[];
+    readonly kind: 'graph.node.task.capabilities.set';
+    readonly nodeId: string;
+    readonly target: GraphTarget;
+    readonly value?: readonly ConnectorCapability[];
+} | {
     readonly binding: FlowDocument['bindings'][string];
     readonly bindingId: string;
     readonly kind: 'binding.create';
 } | {
-    readonly binding: FlowDocument['bindings'][string];
     readonly bindingId: string;
-    readonly kind: 'binding.replace';
+    readonly kind: 'binding.delete';
 } | {
+    readonly before: string;
     readonly bindingId: string;
-    readonly kind: 'binding.delete';
+    readonly kind: 'binding.target.set';
+    readonly value: string;
 } | {
     readonly kind: 'graph.edge.connect';
     readonly edge: GraphEdge;
@@ -248,6 +317,18 @@ export type ChangeOperation = {
     readonly kind: 'graph.edge.disconnect';
     readonly edge: GraphEdge;
     readonly target: GraphTarget;
+} | {
+    readonly before?: readonly InputPort[];
+    readonly kind: 'graph.node.additional-inputs.set';
+    readonly nodeId: string;
+    readonly target: GraphTarget;
+    readonly value?: readonly InputPort[];
+} | {
+    readonly before: Pick<ConditionNode, 'cases' | 'defaultOutput' | 'input'>;
+    readonly kind: 'graph.node.condition.set';
+    readonly nodeId: string;
+    readonly target: GraphTarget;
+    readonly value: Pick<ConditionNode, 'cases' | 'defaultOutput' | 'input'>;
 } | {
     readonly kind: 'graph.node.create';
     readonly node: GraphNode;
@@ -258,10 +339,68 @@ export type ChangeOperation = {
     readonly nodeId: string;
     readonly target: GraphTarget;
 } | {
-    readonly kind: 'graph.node.replace';
-    readonly node: GraphNode;
+    readonly before?: number | string;
+    readonly field: 'description' | 'icon' | 'name' | 'timeoutMs';
+    readonly kind: 'graph.node.field.set';
+    readonly nodeId: string;
+    readonly target: GraphTarget;
+    readonly value?: number | string;
+} | {
+    readonly before?: InputMapping;
+    readonly handle: string;
+    readonly kind: 'graph.node.input.set';
+    readonly nodeId: string;
+    readonly target: GraphTarget;
+    readonly value?: InputMapping;
+} | {
+    readonly before: Pick<InlineTaskDefinition, 'inputs' | 'outputs'>;
+    readonly kind: 'graph.node.task.ports.set';
     readonly nodeId: string;
     readonly target: GraphTarget;
+    readonly value: Pick<InlineTaskDefinition, 'inputs' | 'outputs'>;
+} | {
+    readonly before: string;
+    readonly kind: 'graph.node.task.name.set';
+    readonly nodeId: string;
+    readonly target: GraphTarget;
+    readonly value: string;
+} | {
+    readonly before: readonly InputPort[];
+    readonly kind: 'graph.node.values.set';
+    readonly nodeId: string;
+    readonly target: GraphTarget;
+    readonly value: readonly InputPort[];
+} | {
+    readonly before: Pick<WaitNode, 'actions' | 'notification' | 'prompt'>;
+    readonly kind: 'graph.node.wait.set';
+    readonly nodeId: string;
+    readonly target: Extract<GraphTarget, {
+        readonly kind: 'flow';
+    }>;
+    readonly value: Pick<WaitNode, 'actions' | 'notification' | 'prompt'>;
+} | {
+    readonly before: Pick<Extract<TriggerNode, {
+        readonly kind: 'webhook';
+    }>, 'inputsDef' | 'options'>;
+    readonly kind: 'graph.node.webhook.set';
+    readonly nodeId: string;
+    readonly target: Extract<GraphTarget, {
+        readonly kind: 'flow';
+    }>;
+    readonly value: Pick<Extract<TriggerNode, {
+        readonly kind: 'webhook';
+    }>, 'inputsDef' | 'options'>;
+} | {
+    readonly before?: JsonValue;
+    readonly kind: 'graph.trigger.config.set';
+    readonly name: string;
+    readonly nodeId: string;
+    readonly value?: JsonValue;
+} | {
+    readonly before: readonly TriggerSchedule[];
+    readonly kind: 'graph.trigger.schedule.set';
+    readonly nodeId: string;
+    readonly value: readonly TriggerSchedule[];
 } | {
     readonly kind: 'module.create';
     readonly module: CodeModule;
@@ -270,10 +409,13 @@ export type ChangeOperation = {
     readonly kind: 'module.delete';
     readonly moduleId: string;
 } | {
+    readonly before: string;
     readonly kind: 'module.rename';
     readonly moduleId: string;
     readonly name: string;
 } | {
+    readonly beforeImports: readonly string[];
+    readonly beforeSource: string;
     readonly imports: readonly string[];
     readonly kind: 'module.source.replace';
     readonly moduleId: string;
@@ -283,8 +425,9 @@ export type ChangeOperation = {
     readonly subflow: FlowDocument['subflows'][string];
     readonly subflowId: string;
 } | {
+    readonly before: Omit<FlowDocument['subflows'][string], 'graph'>;
     readonly definition: Omit<FlowDocument['subflows'][string], 'graph'>;
-    readonly kind: 'subflow.definition.replace';
+    readonly kind: 'subflow.definition.set';
     readonly subflowId: string;
 } | {
     readonly kind: 'subflow.delete';
@@ -293,15 +436,31 @@ export type ChangeOperation = {
     readonly kind: 'task.create';
     readonly task: FlowDocument['tasks'][string];
     readonly taskId: string;
+} | {
+    readonly before?: string;
+    readonly kind: 'task.connector.connection.set';
+    readonly taskId: string;
+    readonly value?: string;
 } | {
     readonly kind: 'task.delete';
     readonly taskId: string;
 } | {
-    readonly kind: 'task.replace';
-    readonly task: FlowDocument['tasks'][string];
+    readonly before: ManagedTaskDefinition;
+    readonly kind: 'task.agent.set';
+    readonly taskId: string;
+    readonly value: ManagedTaskDefinition;
+} | {
+    readonly before: 'chat' | 'json';
+    readonly kind: 'task.llm.mode.set';
+    readonly taskId: string;
+    readonly value: 'chat' | 'json';
+} | {
+    readonly before: string;
+    readonly kind: 'task.name.set';
     readonly taskId: string;
+    readonly value: string;
 };
 export declare class FlowChangeError extends Error {
+    constructor(message: string);
 }
 export declare function applyFlowChanges(content: RevisionContent, operations: readonly ChangeOperation[]): RevisionContent;
-export {};