@oomol-lab/open-flow 0.1.0-alpha.9 → 0.1.0-beta.10

package/dist/common/control-api.d.ts

@@ -1,6 +1,6 @@
 import type { RunStatus } from './run-lifecycle.js';
-import type { ChangeOperation, InputPortDefinition, JsonValue, PortDefinition, RevisionContent, TriggerKeySnapshot } from '../browser/flow-change.js';
-export type { JsonValue, TriggerKeySnapshot } from '../browser/flow-change.js';
+import type { ChangeOperation, InputPortDefinition, JsonValue, PortDefinition, RevisionContent, TriggerKeySnapshot, WaitAction } from '../browser/flow-change.js';
+export type { JsonValue, TriggerKeySnapshot, WaitAction } from '../browser/flow-change.js';
 export type { RunStatus } from './run-lifecycle.js';
 export { controlErrorCode, controlErrorMetadata, type ControlErrorCode } from './control-api-errors.js';
 export type { FlowCatalogEvent, FlowChangeEvent } from './flow-notifications.js';
@@ -20,6 +20,12 @@ export interface FlowPage {
     readonly total?: number;
     readonly version: 1;
 }
+export interface Variable {
+    readonly name: string;
+    readonly updatedAt: string;
+    readonly value: string;
+    readonly version: 1;
+}
 export interface TriggerKeySummary {
     readonly description: string;
     readonly displayName: string;
@@ -74,8 +80,10 @@ export interface ConnectorConnection {
 }
 export interface ConnectorAction {
     readonly actionId: string;
+    readonly authenticated: boolean;
     readonly defaultConnection?: ConnectorConnection;
     readonly description: string;
+    readonly homepageUrl?: string;
     readonly icon?: string;
     readonly inputs: Readonly<Record<string, InputPortDefinition>>;
     readonly name: string;
@@ -84,6 +92,7 @@ export interface ConnectorAction {
     readonly serviceName: string;
 }
 export interface ConnectorProvider {
+    readonly homepageUrl?: string;
     readonly icon?: string;
     readonly serviceId: string;
     readonly serviceName: string;
@@ -105,18 +114,11 @@ export interface DraftChange {
     readonly revision: RevisionMetadata;
     readonly version: 1;
 }
-export type DraftSync = {
-    readonly kind: 'changes';
-    readonly revisions: readonly {
-        readonly operations: readonly ChangeOperation[];
-        readonly revision: RevisionMetadata;
-    }[];
-    readonly version: 1;
-} | {
+export interface DraftSync {
     readonly draft: Draft;
     readonly kind: 'snapshot';
     readonly version: 1;
-};
+}
 export interface Publication {
     readonly actorId: string;
     readonly closureDigest: string;
@@ -131,12 +133,44 @@ export interface Publication {
     readonly sourcePublicationId?: string;
     readonly version: 1;
 }
+export type PublishOperation = {
+    readonly createdAt: string;
+    readonly flowId: string;
+    readonly operationId: string;
+    readonly revisionId: string;
+    readonly status: 'pending';
+    readonly updatedAt: string;
+    readonly version: 1;
+} | {
+    readonly createdAt: string;
+    readonly flowId: string;
+    readonly operationId: string;
+    readonly publicationId: string;
+    readonly revisionId: string;
+    readonly status: 'succeeded';
+    readonly updatedAt: string;
+    readonly version: 1;
+} | {
+    readonly createdAt: string;
+    readonly flowId: string;
+    readonly issue: {
+        readonly code: string;
+        readonly message: string;
+        readonly nodeId?: string;
+    };
+    readonly operationId: string;
+    readonly revisionId: string;
+    readonly status: 'failed';
+    readonly updatedAt: string;
+    readonly version: 1;
+};
 export interface Diagnostic {
     readonly code: string;
     readonly column: number;
     readonly line: number;
     readonly message: string;
     readonly path: string;
+    readonly values?: Readonly<Record<string, string | number>>;
 }
 export interface FlowCheck {
     readonly closureDigest: string;
@@ -181,6 +215,14 @@ interface RunDetailsBase extends Run {
     readonly eventsExpiresAt?: string;
     readonly modelVersion: number;
     readonly revisionDigest: string;
+    readonly waiting?: {
+        readonly actions: readonly ['continue'] | readonly ['approve', 'reject'];
+        readonly expiresAt: string;
+        readonly nodeId: string;
+        readonly prompt: string;
+        readonly waitId: string;
+        readonly waitingSince: string;
+    };
 }
 export type DraftRun = RunDetailsBase & {
     readonly source: 'draft';
@@ -202,7 +244,7 @@ export interface RunPage {
     readonly runs: readonly Run[];
     readonly version: 1;
 }
-export type RunEventKind = 'node.artifact' | 'node.completed' | 'node.failed' | 'node.log' | 'node.output' | 'node.progress' | 'node.started' | 'run.canceled' | 'run.completed' | 'run.events-truncated' | 'run.failed' | 'run.indeterminate' | 'run.progress' | 'run.queued' | 'run.started';
+export type RunEventKind = 'node.artifact' | 'node.completed' | 'node.failed' | 'node.log' | 'node.output' | 'node.progress' | 'node.started' | 'run.canceled' | 'run.completed' | 'run.events-truncated' | 'run.failed' | 'run.indeterminate' | 'run.progress' | 'run.queued' | 'run.resolved' | 'run.started' | 'run.waiting';
 export interface RunEvent {
     readonly createdAt: string;
     readonly kind: RunEventKind;
@@ -266,6 +308,13 @@ export declare class ControlClient {
         readonly includeTotal?: boolean;
         readonly limit?: number;
     }): Promise<FlowPage>;
+    listVariables(): Promise<{
+        readonly variables: readonly Variable[];
+        readonly version: 1;
+    }>;
+    getVariable(name: string): Promise<Variable>;
+    putVariable(name: string, value: string): Promise<Variable>;
+    deleteVariable(name: string): Promise<void>;
     createFlow(name: string, idempotencyKey?: string): Promise<Flow>;
     getFlow(flowId: string): Promise<Flow>;
     renameFlow(flowId: string, name: string): Promise<Flow>;
@@ -283,15 +332,15 @@ export declare class ControlClient {
     resumeFlowTrigger(flowId: string, triggerNodeId: string): Promise<TriggerBinding>;
     testFlowPollTrigger(flowId: string, triggerNodeId: string): Promise<PollTriggerTestResult>;
     getDraft(flowId: string): Promise<Draft>;
-    syncDraft(flowId: string, fromRevisionId?: string): Promise<DraftSync>;
+    syncDraft(flowId: string): Promise<DraftSync>;
     getRevision(flowId: string, revisionId: string): Promise<Draft>;
-    listConnectorProviders(signal?: AbortSignal): Promise<readonly ConnectorProvider[]>;
-    listConnectorActions(serviceId?: string, signal?: AbortSignal): Promise<readonly ConnectorAction[]>;
-    searchConnectorActions(query: string, signal?: AbortSignal): Promise<readonly ConnectorAction[]>;
-    getConnectorAction(actionId: string, signal?: AbortSignal): Promise<ConnectorAction>;
-    listConnectorConnections(serviceId: string, signal?: AbortSignal): Promise<readonly ConnectorConnection[]>;
-    createConnectorConnectionPage(serviceId: string): Promise<string>;
-    changeDraft(flowId: string, expectedRevisionId: string, operations: readonly ChangeOperation[]): Promise<DraftChange>;
+    listConnectorProviders(signal?: AbortSignal, flowId?: string): Promise<readonly ConnectorProvider[]>;
+    listConnectorActions(serviceId?: string, signal?: AbortSignal, flowId?: string): Promise<readonly ConnectorAction[]>;
+    searchConnectorActions(query: string, signal?: AbortSignal, flowId?: string): Promise<readonly ConnectorAction[]>;
+    getConnectorAction(actionId: string, signal?: AbortSignal, flowId?: string): Promise<ConnectorAction>;
+    listConnectorConnections(serviceId: string, signal?: AbortSignal, flowId?: string): Promise<readonly ConnectorConnection[]>;
+    createConnectorConnectionPage(serviceId: string, flowId?: string): Promise<string>;
+    changeDraft(flowId: string, expectedRevisionId: string, operations: readonly ChangeOperation[], changeId?: string): Promise<DraftChange>;
     checkFlow(flowId: string, revisionId: string): Promise<FlowCheck>;
     getLive(flowId: string): Promise<Live>;
     listPublications(flowId: string, options?: {
@@ -301,7 +350,8 @@ export declare class ControlClient {
     }): Promise<PublicationPage>;
     createDraftRun(flowId: string, revisionId: string, options?: RunOptions): Promise<DraftRun>;
     createLiveRun(publicationId: string, options?: RunOptions): Promise<LiveRun>;
-    publishFlow(flowId: string, revisionId: string, expectedLivePublicationId: string | null, options?: PublicationOptions): Promise<Publication>;
+    publishFlow(flowId: string, revisionId: string, expectedLivePublicationId: string | null, options?: PublicationOptions): Promise<PublishOperation>;
+    getPublishOperation(flowId: string, operationId: string): Promise<PublishOperation>;
     rollbackFlow(flowId: string, publicationId: string, expectedLivePublicationId: string, options?: PublicationOptions): Promise<Publication>;
     getRun(runId: string): Promise<RunDetails>;
     listRuns(flowId: string, options?: {
@@ -315,6 +365,15 @@ export declare class ControlClient {
     }): Promise<RunEvents>;
     getRunResult(runId: string): Promise<RunResult>;
     cancelRun(runId: string): Promise<RunCancellation>;
+    resolveRunWait(runId: string, waitId: string, action: WaitAction): Promise<{
+        readonly action: WaitAction | null;
+        readonly resolutionAccepted: boolean;
+        readonly resolvedAt: string | null;
+        readonly runId: string;
+        readonly status: RunStatus;
+        readonly version: 1;
+        readonly waitId: string;
+    }>;
     private connectorActions;
     protected request<Value = unknown>(path: string, init?: RequestInit): Promise<Value>;
 }