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

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

@@ -0,0 +1,6 @@
+import type { FlowDocument, Graph, GraphNode, InputPortDefinition, RevisionContent } from '../browser/flow-change.js';
+import type { Diagnostic, SemanticClosure } from './flow-semantics.js';
+export declare function nodeInputPorts(document: FlowDocument, node: GraphNode): Readonly<Record<string, InputPortDefinition>>;
+export declare function graphOrder(graph: Graph): readonly string[];
+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-json.d.ts

@@ -0,0 +1,2 @@
+export declare const maxJsonDepth = 64;
+export declare function checkJsonDepth(value: unknown, depth?: number): void;

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

@@ -0,0 +1,20 @@
+import type { EngineContract } from './engine-contract.js';
+import type { RevisionContent } from '../browser/flow-change.js';
+import type { Diagnostic } from './flow-semantics.js';
+interface ImportReference {
+    readonly column: number;
+    readonly imported: readonly string[];
+    readonly line: number;
+    readonly specifier: string;
+}
+interface ModuleAnalysis {
+    readonly exports: ReadonlySet<string>;
+    readonly imports: readonly ImportReference[];
+}
+export declare function compareDiagnostics(left: Diagnostic, right: Diagnostic): number;
+export declare function validateModuleGraph(revision: RevisionContent, moduleIds: readonly string[], engine: EngineContract): {
+    readonly analysis: ReadonlyMap<string, ModuleAnalysis>;
+    readonly diagnostics: Diagnostic[];
+};
+export declare function validateModules(revision: RevisionContent, moduleIds: readonly string[], engine: EngineContract): readonly Diagnostic[];
+export {};

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

@@ -12,4 +12,9 @@ export type FlowChangeEvent = {
     readonly kind: 'run.created';
     readonly runId: string;
     readonly version: 1;
+} | {
+    readonly flowId: string;
+    readonly kind: 'run.changed';
+    readonly runId: string;
+    readonly version: 1;
 };

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

@@ -0,0 +1,8 @@
+import type { JsonValue, PortDefinition, TriggerNode } from '../browser/flow-change.js';
+export declare function triggerPayloadSchema(trigger: TriggerNode): JsonValue;
+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;
+export declare function portsAssignable(source: PortDefinition, target: PortDefinition): boolean;
+export declare function variableInputCompatible(jsonSchema: JsonValue): boolean;
+export declare function hasRetiredRef(value: unknown): boolean;

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

@@ -1,6 +1,10 @@
-import type { FlowDocument, Graph, JsonValue, RevisionContent, TriggerNode } from '@oomol-lab/open-flow/flow-change';
 import type { EngineContract } from './engine-contract.js';
 import type { RuntimeProgram } from './runtime-contract.js';
+import type { ConnectorCapability, FlowDocument, Graph, RevisionContent } 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 { agentInput, agentToolInput, agentToolSchema } from './flow-agent.js';
 export interface SemanticClosure {
     readonly dependencies: {
         readonly bindings: ReadonlySet<string>;
@@ -11,6 +15,7 @@ export interface SemanticClosure {
     };
     readonly digest: string;
 }
+export declare function flowDependencies(content: RevisionContent, triggerId?: string): SemanticClosure['dependencies'];
 export declare function flowClosure(content: RevisionContent): Promise<SemanticClosure>;
 export declare function variableBindings(revision: RevisionContent, bindingIds: Iterable<string>): Readonly<Record<string, string>>;
 export interface Diagnostic {
@@ -26,12 +31,9 @@ export interface FlowValidation {
     readonly diagnostics: readonly Diagnostic[];
     readonly valid: boolean;
 }
-export declare function triggerPayloadSchema(trigger: TriggerNode): JsonValue;
-export declare function matchesSchema(value: JsonValue, schema: JsonValue): boolean;
-export declare function variableInputCompatible(jsonSchema: JsonValue): boolean;
 export type FlowInputsValidation = 'invalid' | 'valid';
+export declare function validRunTrigger(revision: RevisionContent, value: unknown): boolean;
 export declare function validateFlowInputs(revision: RevisionContent, value: unknown): FlowInputsValidation;
-export declare function validateModules(revision: RevisionContent, moduleIds: readonly string[], engine: EngineContract): readonly Diagnostic[];
 export declare function validateFlow(revision: RevisionContent, engine: EngineContract): Promise<FlowValidation>;
 export interface PreparedFlow {
     readonly closureDigest: string;
@@ -51,5 +53,7 @@ export type PrepareFlowResult = {
     readonly kind: 'prepared';
     readonly validation: FlowValidation;
 };
-export declare function prepareFlow(revision: RevisionContent, engineContract: string): Promise<PrepareFlowResult>;
+export declare function prepareFlow(revision: RevisionContent, engineContract: string, triggerId?: string): Promise<PrepareFlowResult>;
 export declare function createRuntimeProgram(prepared: PreparedFlow, entryModuleId: string, engineDigest: string): RuntimeProgram | undefined;
+export declare function agentActions(flow: Pick<PreparedFlow, 'tasks'>): readonly ConnectorCapability[];
+export declare function codeActions(flow: Pick<PreparedFlow, 'graph' | 'subflows'>): readonly ConnectorCapability[];