@oomol-lab/open-flow 0.1.0-beta.55 → 0.1.0-beta.57

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

@@ -190,5 +190,6 @@ export declare const controlErrorMetadata: {
 export declare class ApiError extends Error {
     readonly code: string;
     readonly status: number;
-    constructor(status: number, code: string, message: string);
+    readonly details?: Readonly<Record<string, unknown>>;
+    constructor(status: number, code: string, message: string, details?: Readonly<Record<string, unknown>>);
 }

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

@@ -1,3 +1,4 @@
+import type { AuthoringRead, AuthoringSearch, AuthoringRequest, AuthoringType } from './authoringSchema.js';
 import type { ProviderIconAppearance } from './providerIconSprite.js';
 export { providerIconAppearance } from './providerIconSprite.js';
 export type { ProviderIconAppearance, ProviderIconSprite, ProviderIconSpriteCatalog } from './providerIconSprite.js';
@@ -19,6 +20,7 @@ import { decodeResultList, decodeResultRead } from './run-results.js';
 export { readResult, parseResultQuery, decodeResultList, decodeResultRead, type ResultCall, type ResultInfo, type ResultPage, type ResultQuery, } from './run-results.js';
 import type { RunStatus } from './run-lifecycle.js';
 import type { InputPortDefinition, JsonValue, PortDefinition, RevisionContent, TriggerKeySnapshot, WaitAction } from '../browser/flow-change.js';
+import type { FlowResourceReferences } from './flow-semantics.js';
 export type { JsonValue, TriggerKeySnapshot, WaitAction } from '../browser/flow-change.js';
 export type { RunStatus } from './run-lifecycle.js';
 export { ApiError, controlErrorCode, controlErrorMetadata, type ControlErrorCode } from './control-api-errors.js';
@@ -31,6 +33,18 @@ export interface ErrorListener {
     readonly nodeName: string;
     readonly enabled: boolean;
 }
+export interface FlowResources {
+    readonly draft: FlowResourceReferences | null;
+    readonly sharedAccess: {
+        readonly accessRevision: number;
+        readonly providerIds: readonly string[];
+        readonly bindings: readonly {
+            readonly providerId: string;
+            readonly connectionId: string | null;
+            readonly accessBindingId: string;
+        }[];
+    };
+}
 export interface Flow {
     readonly live?: {
         readonly enabled: boolean;
@@ -39,6 +53,7 @@ export interface Flow {
     };
     readonly createdAt: string;
     readonly draftRevisionId: string;
+    readonly resourceReferences: FlowResources;
     readonly flowId: string;
     /** Connector Team scope used by the OOMOL resource cache. */
     readonly connectorTeamId?: string;
@@ -449,12 +464,12 @@ export declare function decodeRunEvent(value: unknown): {
     readonly sequence: number;
     readonly kind: "run.queued";
     readonly payload: {
-        nodeId?: undefined;
         readonly flowId?: undefined;
         readonly scopeId?: undefined;
         readonly progress?: undefined;
         readonly waitIds?: undefined;
         readonly expiresAt?: undefined;
+        readonly nodeId?: undefined;
         readonly waitingSince?: undefined;
         readonly action?: undefined;
         readonly comment?: undefined;
@@ -467,13 +482,13 @@ export declare function decodeRunEvent(value: unknown): {
     readonly sequence: number;
     readonly kind: "run.started";
     readonly payload: {
-        nodeId?: undefined;
         readonly flowId: string;
         readonly scopeId: string;
         readonly parentScopeId?: string | undefined;
         readonly progress?: undefined;
         readonly waitIds?: undefined;
         readonly expiresAt?: undefined;
+        readonly nodeId?: undefined;
         readonly waitingSince?: undefined;
         readonly action?: undefined;
         readonly comment?: undefined;
@@ -486,12 +501,12 @@ export declare function decodeRunEvent(value: unknown): {
     readonly sequence: number;
     readonly kind: "run.progress";
     readonly payload: {
-        nodeId?: undefined;
         readonly flowId: string;
         readonly scopeId: string;
         readonly progress: number;
         readonly waitIds?: undefined;
         readonly expiresAt?: undefined;
+        readonly nodeId?: undefined;
         readonly waitingSince?: undefined;
         readonly action?: undefined;
         readonly comment?: undefined;
@@ -504,12 +519,12 @@ export declare function decodeRunEvent(value: unknown): {
     readonly sequence: number;
     readonly kind: "run.waiting";
     readonly payload: {
-        nodeId?: undefined;
         readonly flowId?: undefined;
         readonly scopeId?: undefined;
         readonly progress?: undefined;
         readonly waitIds: string[];
         readonly expiresAt?: undefined;
+        readonly nodeId?: undefined;
         readonly waitingSince?: undefined;
         readonly action?: undefined;
         readonly comment?: undefined;
@@ -540,12 +555,12 @@ export declare function decodeRunEvent(value: unknown): {
     readonly sequence: number;
     readonly kind: "run.resolved";
     readonly payload: {
-        nodeId?: undefined;
         readonly flowId?: undefined;
         readonly scopeId?: undefined;
         readonly progress?: undefined;
         readonly waitIds?: undefined;
         readonly expiresAt?: undefined;
+        readonly nodeId?: undefined;
         readonly waitingSince?: undefined;
         readonly action: "approve" | "continue" | "reject";
         readonly comment: string | null;
@@ -558,12 +573,12 @@ export declare function decodeRunEvent(value: unknown): {
     readonly sequence: number;
     readonly kind: "run.canceled" | "run.completed" | "run.failed" | "run.indeterminate";
     readonly payload: {
-        nodeId?: undefined;
         readonly flowId?: undefined;
         readonly scopeId?: undefined;
         readonly progress?: undefined;
         readonly waitIds?: undefined;
         readonly expiresAt?: undefined;
+        readonly nodeId?: undefined;
         readonly waitingSince?: undefined;
         readonly action?: undefined;
         readonly comment?: undefined;
@@ -804,6 +819,72 @@ export declare class ControlClient {
     listAllConnectorConnections(signal?: AbortSignal, flowId?: string, fresh?: boolean): Promise<readonly ConnectorConnection[]>;
     listConnectorConnections(serviceId: string, signal?: AbortSignal, flowId?: string, fresh?: boolean): Promise<readonly ConnectorConnection[]>;
     createConnectorConnectionPage(serviceId: string, flowId?: string, teamId?: string): Promise<string>;
+    readAuthoring(flowId: string, query?: AuthoringRead): Promise<{
+        flowId: string;
+        revision: string;
+        data: {
+            nodes?: Record<string, import("zod").JSONType>[] | undefined;
+            edges?: import("zod").JSONType[] | undefined;
+            text?: Record<string, import("zod").JSONType> | undefined;
+        };
+        version: 1;
+    }>;
+    searchAuthoring(flowId: string, query: AuthoringSearch): Promise<{
+        flowId: string;
+        revision: string;
+        data: {
+            matches: {
+                node: string;
+                field: string;
+                line?: number | undefined;
+                excerpt: string;
+            }[];
+            total: number;
+            nextOffset?: number | undefined;
+        };
+        version: 1;
+    }>;
+    authoringSchema(flowId: string, query: {
+        type?: AuthoringType;
+        action?: string;
+    }): Promise<Readonly<Record<string, unknown>>>;
+    editAuthoring(flowId: string, request: AuthoringRequest): Promise<{
+        flowId: string;
+        saved: true;
+        revision: string;
+        nodes: Record<string, string>;
+        changes: {
+            index: number;
+            op: string;
+            node?: string | undefined;
+        }[];
+        validation: {
+            status: "invalid" | "unavailable" | "valid";
+            diagnostics?: {
+                code: string;
+                message: string;
+                nodes: string[];
+                field?: string | undefined;
+                line?: number | undefined;
+                column?: number | undefined;
+            }[] | undefined;
+        };
+        version: 1;
+    }>;
+    checkAuthoring(flowId: string, revisionId: string): Promise<{
+        flowId: string;
+        revisionId: string;
+        valid: boolean;
+        diagnostics: {
+            code: string;
+            message: string;
+            nodes: string[];
+            field?: string | undefined;
+            line?: number | undefined;
+            column?: number | undefined;
+        }[];
+        version: 1;
+    }>;
     changeDraft(flowId: string, expectedRevisionId: string, operations: readonly DraftOperation[], changeId?: string): Promise<DraftChange>;
     repairDraft(flowId: string, expectedRevisionId: string, changeId?: string): Promise<DraftChange>;
     checkFlow(flowId: string, revisionId: string): Promise<FlowCheck>;