@oomol-lab/open-flow 0.1.0-beta.65 → 0.1.0-beta.67

package/dist/common/authoring.d.ts

@@ -1,4 +1,5 @@
 import type { ChangeOperation, JsonValue, RevisionContent, TriggerKeySnapshot } from '../browser/flow-change.js';
+import type { WorkflowContract, WorkflowCandidate } from './workflow.js';
 import type { ConnectorAction, Diagnostic } from './control-api.js';
 import type { AuthoringRead, AuthoringRequest, AuthoringSearch } from './authoringSchema.js';
 export * from './authoringSchema.js';
@@ -9,7 +10,7 @@ export declare class AuthoringError extends Error {
 }
 export declare function authoringNode(content: RevisionContent, ref: string): {
     ref: string;
-    type: "agent" | "approval" | "code" | "condition" | "connector" | "cron" | "decision" | "error" | "integration" | "llm" | "manual" | "openapi" | "poll" | "value" | "wait" | "webhook";
+    type: "agent" | "approval" | "code" | "condition" | "connector" | "cron" | "decision" | "error" | "integration" | "llm" | "openapi" | "outputs" | "poll" | "start" | "value" | "wait" | "webhook" | "workflow";
     name: string;
     readOnly: boolean;
     description?: string | undefined;
@@ -71,6 +72,7 @@ export declare function authoringNode(content: RevisionContent, ref: string): {
     })[];
 };
 export declare function readAuthoring(content: RevisionContent, query?: AuthoringRead): {
+    nodes?: undefined;
     text: {
         node: string;
         field: "code" | "prompt";
@@ -81,13 +83,12 @@ export declare function readAuthoring(content: RevisionContent, query?: Authorin
         nextStart?: number | undefined;
         truncated: boolean;
     };
-    nodes?: undefined;
     edges?: undefined;
 } | {
     text?: undefined;
     nodes: {
         ref: string;
-        type: "agent" | "approval" | "code" | "condition" | "connector" | "cron" | "decision" | "error" | "integration" | "llm" | "manual" | "openapi" | "poll" | "value" | "wait" | "webhook";
+        type: "agent" | "approval" | "code" | "condition" | "connector" | "cron" | "decision" | "error" | "integration" | "llm" | "openapi" | "outputs" | "poll" | "start" | "value" | "wait" | "webhook" | "workflow";
         name: string;
         readOnly: boolean;
         description?: string | undefined;
@@ -153,7 +154,7 @@ export declare function readAuthoring(content: RevisionContent, query?: Authorin
     text?: undefined;
     nodes: {
         ref: string;
-        type: "agent" | "approval" | "code" | "condition" | "connector" | "cron" | "decision" | "error" | "integration" | "llm" | "manual" | "openapi" | "poll" | "value" | "wait" | "webhook";
+        type: "agent" | "approval" | "code" | "condition" | "connector" | "cron" | "decision" | "error" | "integration" | "llm" | "openapi" | "outputs" | "poll" | "start" | "value" | "wait" | "webhook" | "workflow";
         name: string;
         readOnly: boolean;
         inputHandles: string[];
@@ -178,7 +179,7 @@ export declare function readAuthoring(content: RevisionContent, query?: Authorin
 };
 export declare function searchAuthoring(content: RevisionContent, query: AuthoringSearch): {
     matches: {
-        node: string;
+        node?: string;
         field: string;
         line?: number;
         excerpt: string;
@@ -187,6 +188,7 @@ export declare function searchAuthoring(content: RevisionContent, query: Authori
     nextOffset?: number | undefined;
 };
 export interface AuthoringHost {
+    workflow?(flowId: string): Promise<WorkflowContract | WorkflowCandidate>;
     id(label: string): string;
     action(id: string): Promise<ConnectorAction>;
     trigger(key: string): TriggerKeySnapshot;

package/dist/common/authoringExamples.d.ts

@@ -1,6 +1,6 @@
 import type { DraftOperation } from './draftOperations.js';
 declare const descriptions: {
-    readonly manual: 'A Manual start node.';
+    readonly start: 'A Start node with a required message parameter. Supply it through trigger.outputs.';
     readonly error: 'A Flow Error node. Select upstream Flows, then publish and enable this Flow to listen for failures in their automatic runs.';
     readonly webhook: 'A Webhook start node.';
     readonly cron: 'An hourly scheduled start node.';
@@ -8,7 +8,7 @@ declare const descriptions: {
     readonly integration: 'Telegram webhook integration by key; replace CONNECTION_ID with an active Telegram connection.';
     readonly decision: 'AI Decision evaluates named questions against target and returns a complete answer object per output. Configure target before running.';
     readonly openapi: 'A fixed JSON API operation. Replace the example document and URL before running.';
-    readonly connector: 'A Connector Task and its node. Replace ACTION_ID, CONNECTION_ID and port definitions using connector_get / connector show.';
+    readonly connector: 'A Connector Task and its node. Replace ACTION_ID, CONNECTION_ID and port definitions using connector_get / connector show. Set connectionId to an empty string to defer account configuration; execution will require an account.';
     readonly code: 'A JavaScript module and its node. Use Code for custom computation; use Connector Tasks for existing actions.';
     readonly condition: 'A condition with true and false execution branches.';
     readonly value: 'A fixed value node.';
@@ -21,8 +21,8 @@ declare const descriptions: {
 };
 export declare const authoringExampleNames: (keyof typeof descriptions)[];
 export declare const authoringExamples: {
-    name: "agent" | "approval" | "code" | "condition" | "connector" | "cron" | "decision" | "error" | "integration" | "llm-chat" | "llm-json" | "manual" | "openapi" | "poll" | "poll-notification" | "value" | "wait" | "webhook";
-    description: "A Connector Task and its node. Replace ACTION_ID, CONNECTION_ID and port definitions using connector_get / connector show." | "A Flow Error node. Select upstream Flows, then publish and enable this Flow to listen for failures in their automatic runs." | "A JavaScript module and its node. Use Code for custom computation; use Connector Tasks for existing actions." | "A Manual start node." | "A Wait with a continue action and a built-in notification output." | "A Webhook start node." | "A condition with true and false execution branches." | "A fixed JSON API operation. Replace the example document and URL before running." | "A fixed value node." | "AI Decision evaluates named questions against target and returns a complete answer object per output. Configure target before running." | "An Agent with code computation enabled. Configure a model available in the deployment." | "An Approval with approve and reject decision branches and a built-in notification output." | "An LLM JSON Task and its node; configure a model available in the deployment." | "An LLM chat Task and its node; configure a model available in the deployment." | "An hourly scheduled start node." | "Gmail events → JavaScript text formatting → Connector notification. Replace connection/action IDs and match the notification input ports." | "Gmail polling by key; replace CONNECTION_ID with an active Gmail connection." | "Telegram webhook integration by key; replace CONNECTION_ID with an active Telegram connection.";
+    name: "agent" | "approval" | "code" | "condition" | "connector" | "cron" | "decision" | "error" | "integration" | "llm-chat" | "llm-json" | "openapi" | "poll" | "poll-notification" | "start" | "value" | "wait" | "webhook";
+    description: "A Connector Task and its node. Replace ACTION_ID, CONNECTION_ID and port definitions using connector_get / connector show. Set connectionId to an empty string to defer account configuration; execution will require an account." | "A Flow Error node. Select upstream Flows, then publish and enable this Flow to listen for failures in their automatic runs." | "A JavaScript module and its node. Use Code for custom computation; use Connector Tasks for existing actions." | "A Start node with a required message parameter. Supply it through trigger.outputs." | "A Wait with a continue action and a built-in notification output." | "A Webhook start node." | "A condition with true and false execution branches." | "A fixed JSON API operation. Replace the example document and URL before running." | "A fixed value node." | "AI Decision evaluates named questions against target and returns a complete answer object per output. Configure target before running." | "An Agent with code computation enabled. Configure a model available in the deployment." | "An Approval with approve and reject decision branches and a built-in notification output." | "An LLM JSON Task and its node; configure a model available in the deployment." | "An LLM chat Task and its node; configure a model available in the deployment." | "An hourly scheduled start node." | "Gmail events → JavaScript text formatting → Connector notification. Replace connection/action IDs and match the notification input ports." | "Gmail polling by key; replace CONNECTION_ID with an active Gmail connection." | "Telegram webhook integration by key; replace CONNECTION_ID with an active Telegram connection.";
 }[];
 export declare function authoringExample(name: string): {
     version: 1;

package/dist/common/authoringFields.d.ts

@@ -0,0 +1,20 @@
+import type { InputPort, Group, JsonValue, RevisionContent } from '../browser/flow-change.js';
+/** Business field contracts, independent of storage handles and presentation groups. */
+export declare function fieldsView(ports: readonly (InputPort | Group)[]): {
+    [k: string]: {
+        schema: JsonValue;
+        nullable: boolean;
+        description?: string | undefined;
+        default?: JsonValue | undefined;
+    };
+};
+export declare function fieldsToPorts(fields: unknown, previous: readonly (InputPort | Group)[]): readonly (InputPort | Group)[];
+/** The workflow input contract shared by draft authoring and published views. */
+export declare function flowInputDefinitions(content: RevisionContent): {
+    [k: string]: {
+        schema: JsonValue;
+        nullable: boolean;
+        description?: string | undefined;
+        default?: JsonValue | undefined;
+    };
+};