@oomol-lab/open-flow 0.1.0-beta.27 → 0.1.0-beta.29

package/dist/common/flow-graph.d.ts

@@ -1,9 +1,16 @@
 import type { FlowDocument, Graph, GraphNode, InputPortDefinition, PortDefinition, RevisionContent, SchemaMismatch } from '../browser/flow-change.js';
 import type { Diagnostic, SemanticClosure } from './flow-semantics.js';
+export declare function isResolutionNode(node: GraphNode | undefined): node is Extract<GraphNode, {
+    readonly kind: 'approval' | 'wait';
+}>;
 export declare function nodeInputPorts(document: FlowDocument, node: GraphNode): Readonly<Record<string, InputPortDefinition>>;
-export declare function waitOutputPorts(node: Extract<GraphNode, {
-    readonly kind: 'wait';
+export declare function resolutionActions(node: Extract<GraphNode, {
+    readonly kind: 'approval' | 'wait';
+}>): readonly ['continue'] | readonly ['approve', 'reject'];
+export declare function resolutionOutputPorts(node: Extract<GraphNode, {
+    readonly kind: 'approval' | 'wait';
 }>): Readonly<Record<string, PortDefinition>>;
+export declare function nodeOutputDescription(document: FlowDocument, graph: Graph, nodeId: string, output: string): string | undefined;
 export declare function graphOrder(graph: Graph): readonly string[];
 export type InputSourceCheck = {
     readonly kind: 'available';
@@ -19,6 +26,13 @@ export type InputSourceCheck = {
 } | {
     readonly kind: 'schema-error';
 };
+export type InputSourceCandidateCheck = Extract<InputSourceCheck, {
+    readonly kind: 'available' | 'schema' | 'schema-error';
+}>;
+export interface InputSourceCandidate {
+    readonly output: string;
+    readonly check: InputSourceCandidateCheck;
+}
 export interface InputSourcesCheck {
     readonly conflict: boolean;
     readonly sources: readonly InputSourceCheck[];
@@ -32,5 +46,7 @@ export declare function checkInputSources(document: FlowDocument, graph: Graph,
     readonly nodeId: string;
     readonly output: string;
 }[]): InputSourcesCheck;
+/** Enumerate structurally available outputs while retaining their compatibility with one input. */
+export declare function inputSourceCandidates(document: FlowDocument, graph: Graph, target: string, handle: string): Readonly<Record<string, readonly InputSourceCandidate[]>>;
 export declare function availableOutputs(document: FlowDocument, graph: Graph, target: string, handle?: string): Readonly<Record<string, readonly string[]>>;
 export declare function validateFlowGraph(revision: RevisionContent, closure: SemanticClosure): readonly Diagnostic[];

package/dist/common/flow-notifications.d.ts

@@ -1,7 +1,11 @@
-export interface FlowCatalogEvent {
+export type FlowCatalogEvent = {
     readonly kind: 'flows.changed';
     readonly version: 1;
-}
+} | {
+    readonly kind: 'flow.created';
+    readonly flowId: string;
+    readonly version: 1;
+};
 export type FlowChangeEvent = {
     readonly kind: 'draft.changed';
     readonly flowId: string;

package/dist/common/flow-schema.d.ts

@@ -1,5 +1,4 @@
-import type { JsonValue, PortDefinition, SchemaMismatch, TriggerNode } from '../browser/flow-change.js';
-export declare function triggerPayloadSchema(trigger: TriggerNode): JsonValue;
+import type { JsonValue, PortDefinition, SchemaMismatch } from '../browser/flow-change.js';
 export declare function schemaObject(schema: JsonValue): Readonly<Record<string, JsonValue>> | undefined;
 export declare function schemaList(value: JsonValue | undefined): readonly JsonValue[] | undefined;
 export declare function matchesSchema(value: JsonValue, schema: JsonValue): boolean;

package/dist/common/flow-semantics.d.ts

@@ -1,9 +1,10 @@
+export { matchesTriggerOutputs, triggerOutputDefinitions, triggerOutputPorts } from './trigger-contract.js';
 import type { EngineContract } from './engine-contract.js';
 import type { RuntimeProgram } from './runtime-contract.js';
 import type { ConnectorCapability, FlowDocument, Graph, RevisionContent, SchemaMismatch } from '../browser/flow-change.js';
 export { availableOutputs, graphOrder, nodeInputPorts } from './flow-graph.js';
 export { validateModules } from './flow-modules.js';
-export { matchesSchema, triggerPayloadSchema, variableInputCompatible } from './flow-schema.js';
+export { matchesSchema, variableInputCompatible } from './flow-schema.js';
 export { agentInput, agentToolInput, agentToolSchema } from './flow-agent.js';
 export interface SemanticClosure {
     readonly dependencies: {