@oomol-lab/open-flow 0.1.0-beta.74 → 0.1.0-beta.76

package/src/trigger/common/config.ts

@@ -1,4 +1,4 @@
-import type { Group, InputPort, InputValues, JsonValue } from '../../flow/common/change.ts'
+import type { Group, InputPort, InputValues, JsonValue } from '../../flow/common/model.ts'
 
 import { inputValue } from '../../flow/common/inputValue.ts'
 import { matchesSchema } from '../../flow/common/schema.ts'

package/src/trigger/common/configOptions.ts

@@ -1,5 +1,5 @@
 import type { ConnectorProxy } from '../../connector/common/proxy.ts'
-import type { JsonValue } from '../../flow/common/change.ts'
+import type { JsonValue } from '../../flow/common/model.ts'
 
 export interface TriggerConfigOption {
   readonly value: string

package/src/trigger/common/contract.ts

@@ -1,4 +1,5 @@
-import type { JsonValue, Port, PortDefinition, TriggerNode } from '../../flow/common/change.ts'
+import type { JsonValue, Port, PortDefinition } from '../../flow/common/model.ts'
+import type { TriggerNode } from './model.ts'
 
 import { isJsonObject } from '../../base/common/json.ts'
 import { matchesSchema } from '../../flow/common/schema.ts'

package/src/trigger/common/cron.ts

@@ -1,4 +1,5 @@
-import type { JsonValue, TriggerSchedule } from '../../flow/common/change.ts'
+import type { JsonValue } from '../../flow/common/model.ts'
+import type { TriggerSchedule } from './model.ts'
 
 import { Cron } from 'croner'
 

package/src/trigger/common/integration.ts

@@ -1,7 +1,8 @@
 export { resolveTriggerConfig, triggerConfigValues } from './config.ts'
 import type { ConnectorProxy } from '../../connector/common/proxy.ts'
-import type { IntegrationEndpointMethod, JsonValue, TriggerKeySnapshot } from '../../flow/common/change.ts'
+import type { JsonValue } from '../../flow/common/model.ts'
 import type { TriggerConfigOption, TriggerConfigOptionsContext } from './configOptions.ts'
+import type { IntegrationEndpointMethod, TriggerKeySnapshot } from './model.ts'
 
 import { dequal } from 'dequal/lite'
 import { isJsonObject, isJsonValue } from '../../base/common/json.ts'

package/src/trigger/common/model.ts

@@ -0,0 +1,87 @@
+import type { Group, InputPort, InputValues, Port } from '../../flow/common/model.ts'
+import type { WebhookMethod } from '../../flow/common/webhookMethod.ts'
+
+/** Trigger node shapes. The graph node union and its operations belong to flow/common/change.ts. */
+
+export type TriggerSchedule =
+  | { readonly expression: string; readonly timezone: string; readonly type: 'cron' }
+  | { readonly type: 'every'; readonly unit: 'day' | 'hour' | 'minute' | 'month' | 'week'; readonly value: number }
+
+interface TriggerKeySnapshotBase {
+  readonly configInputs: readonly (InputPort | Group)[]
+  readonly definitionVersion: number
+  readonly description: string
+  readonly displayName: string
+  readonly key: string
+  readonly name: string
+  readonly outputs: readonly Port[]
+  readonly provider: string
+}
+
+export type IntegrationEndpointMethod = 'DELETE' | 'GET' | 'HEAD' | 'PATCH' | 'POST' | 'PUT'
+
+export type IntegrationBodyFormat = 'form' | 'json' | 'multipart' | 'text'
+
+export interface IntegrationEndpointDeclaration {
+  readonly body: {
+    readonly allowArray: boolean
+    readonly allowEmpty: boolean
+    readonly formats: readonly IntegrationBodyFormat[]
+  }
+  readonly methods: readonly IntegrationEndpointMethod[]
+  readonly successStatus: number
+}
+
+export type TriggerKeySnapshot =
+  | (TriggerKeySnapshotBase & { readonly type: 'poll' })
+  | (TriggerKeySnapshotBase & { readonly endpoint: IntegrationEndpointDeclaration; readonly type: 'integration' })
+
+export interface WebhookBodyField extends InputPort {}
+
+export interface WebhookOptions {
+  readonly allowedOrigins?: readonly string[]
+  readonly responseBody?:
+    | { readonly kind: 'workflow-outputs'; readonly output?: string; readonly timeoutMs?: number }
+    | { readonly kind: 'webhook-response'; readonly nodeId?: string; readonly timeoutMs?: number }
+  readonly responseData?: string
+  readonly responseHeaders?: Readonly<Record<string, string>>
+  readonly responseHeadersSource?: {
+    readonly kind: 'workflow-outputs'
+    readonly output?: string
+  }
+  readonly responseHeaderOutputs?: Readonly<Record<string, string>>
+  readonly responseStatusCode?: number
+  readonly responseStatusCodeOutput?: string
+}
+
+interface TriggerNodeBase {
+  readonly onError?: never
+  readonly description?: string
+  readonly icon?: string
+  readonly name: string
+}
+
+export type TriggerNode =
+  | (TriggerNodeBase & { readonly kind: 'manual' })
+  | (TriggerNodeBase & { readonly kind: 'start'; readonly inputDefs: readonly Port[] })
+  | (TriggerNodeBase & { readonly kind: 'error'; readonly sourceFlowIds?: readonly string[] })
+  | (TriggerNodeBase & {
+      readonly bodyFields: readonly WebhookBodyField[]
+      readonly kind: 'webhook'
+      readonly method: WebhookMethod
+      readonly options?: WebhookOptions
+    })
+  | (TriggerNodeBase & { readonly cronTimes: readonly TriggerSchedule[]; readonly kind: 'cron' })
+  | (TriggerNodeBase & {
+      readonly connectionId?: string
+      readonly config: InputValues
+      readonly definition: TriggerKeySnapshot & { readonly type: 'poll' }
+      readonly kind: 'poll'
+      readonly pollTimes: readonly TriggerSchedule[]
+    })
+  | (TriggerNodeBase & {
+      readonly connectionId?: string
+      readonly config: InputValues
+      readonly definition: TriggerKeySnapshot & { readonly type: 'integration' }
+      readonly kind: 'integration'
+    })

package/src/trigger/common/poll.ts

@@ -1,7 +1,8 @@
 export { resolveTriggerConfig, triggerConfigValues } from './config.ts'
 import type { ConnectorProxy } from '../../connector/common/proxy.ts'
-import type { JsonValue, TriggerKeySnapshot, TriggerSchedule } from '../../flow/common/change.ts'
+import type { JsonValue } from '../../flow/common/model.ts'
 import type { TriggerConfigOption, TriggerConfigOptionsContext } from './configOptions.ts'
+import type { TriggerKeySnapshot, TriggerSchedule } from './model.ts'
 
 const encoder = new TextEncoder()
 

package/src/trigger/common/webhook.ts

@@ -1,8 +1,11 @@
-import type { JsonValue, WebhookBodyField, WebhookMethod, WebhookOptions } from '../../flow/common/change.ts'
+import type { JsonValue } from '../../flow/common/model.ts'
+import type { WebhookMethod } from '../../flow/common/webhookMethod.ts'
+import type { WebhookBodyField, WebhookOptions } from './model.ts'
 
 import { dequal } from 'dequal/lite'
 import { isJsonObject } from '../../base/common/json.ts'
-import { webhookHeaderNameIssue, validWebhookStatus, webhookHeaderValues, encodeWebhookBody } from '../../flow/common/webhookResponse.ts'
+import { validWebhookStatus, webhookHeaderValues, encodeWebhookBody } from '../../flow/common/webhookResponse.ts'
+import { httpHeaderNameIssue } from '../../http/common/headers.ts'
 
 export { webhookSupportsBody } from './contract.ts'
 export { webhookResponseAllowsBody, webhookResponseTimeout } from '../../flow/common/webhookResponse.ts'
@@ -34,7 +37,7 @@ export function webhookResponseHeaders(result: unknown, options: WebhookOptions)
   const values = new Map<string, { name: string; value: unknown }>()
   for (const [name, value] of Object.entries(source)) {
     if (
-      webhookHeaderNameIssue(
+      httpHeaderNameIssue(
         name,
         [...values.values()].map((entry) => entry.name),
       ) != null
@@ -45,7 +48,7 @@ export function webhookResponseHeaders(result: unknown, options: WebhookOptions)
   if (whole == null) {
     const names: string[] = []
     for (const [name, output] of Object.entries(options.responseHeaderOutputs ?? {})) {
-      if (webhookHeaderNameIssue(name, names) != null) return
+      if (httpHeaderNameIssue(name, names) != null) return
       names.push(name)
       values.set(name.toLowerCase(), { name, value: workflowOutputValue(result, output) })
     }

package/src/trigger/providers/fieldDescriptions.ts

@@ -1,4 +1,4 @@
-import type { TriggerDisplay } from '../../control/common/triggerCatalog.ts'
+import type { TriggerDisplay } from './localization.ts'
 
 type FieldDescriptions = Pick<TriggerDisplay, 'configInputs' | 'outputs'>
 

package/src/trigger/providers/localization.ts

@@ -1,10 +1,17 @@
-import type { TriggerDisplay } from '../../control/common/triggerCatalog.ts'
-import type { TriggerKeySnapshot } from '../../flow/common/change.ts'
 import type { UiLanguage } from '../../localization/common/languages.ts'
+import type { TriggerKeySnapshot } from '../common/model.ts'
 
 import { englishTriggerFieldDescriptions } from './fieldDescriptions.ts'
 import { triggerConfigFieldLabels } from './fieldLabels.ts'
 
+export interface TriggerDisplay {
+  readonly configInputs: Readonly<Record<string, string>>
+  readonly configInputLabels: Readonly<Record<string, string>>
+  readonly displayName: string
+  readonly description: string
+  readonly outputs: Readonly<Record<string, string>>
+}
+
 type Translations = Readonly<Record<string, Partial<TriggerDisplay>>>
 
 const loaders = {

package/src/trigger/providers/remote.ts

@@ -1,5 +1,4 @@
 import type { ConnectorProxy, TriggerOperationRequest } from '../../connector/common/proxy.ts'
-import type { TriggerKeySnapshot } from '../../flow/common/change.ts'
 import type { TriggerConfigOption } from '../common/configOptions.ts'
 import type {
   IntegrationDefinition,
@@ -8,6 +7,7 @@ import type {
   IntegrationStateContext,
   ListenerPage,
 } from '../common/integration.ts'
+import type { TriggerKeySnapshot } from '../common/model.ts'
 import type { PollDefinition, PollResult } from '../common/poll.ts'
 
 import { isJsonObject } from '../../base/common/json.ts'

package/src/types/index.ts

@@ -22,21 +22,56 @@ export interface ArtifactRef {
   readonly kind: 'artifact'
   readonly id: string
   readonly name: string
-  readonly mediaType: string | undefined
+  readonly mediaType?: string
   readonly size: number
   readonly digest: string
 }
 
 export interface ArtifactPutOptions {
   readonly name: string
-  readonly mediaType?: string | undefined
+  readonly mediaType?: string
 }
 
-export type ArtifactData = Uint8Array | Blob | ReadableStream<Uint8Array>
+/** Strings are stored as UTF-8. */
+export type ArtifactData = string | Uint8Array
 
+/** Artifacts belong to the current Run; an ArtifactRef is JSON and can be passed to downstream nodes. */
 export interface ArtifactCapability {
   put(data: ArtifactData, options: ArtifactPutOptions): Promise<ArtifactRef>
-  open(ref: ArtifactRef): Promise<ReadableStream<Uint8Array>>
+  open(ref: ArtifactRef): Promise<Uint8Array>
+}
+
+export interface TaskFetchInit {
+  /** GET, HEAD, POST, PUT, PATCH, DELETE or OPTIONS. */
+  readonly method?: string
+  readonly headers?: Readonly<Record<string, string>> | Iterable<readonly [string, string]>
+  /** At most 1 MiB; strings are sent as UTF-8 text/plain unless a content-type header is supplied. */
+  readonly body?: string | Uint8Array | ArrayBuffer
+  readonly signal?: AbortSignal
+}
+
+export interface TaskFetchHeaders extends Iterable<[string, string]> {
+  get(name: string): string | null
+  has(name: string): boolean
+  entries(): IterableIterator<[string, string]>
+  keys(): IterableIterator<string>
+  values(): IterableIterator<string>
+  forEach(callback: (value: string, name: string) => void): void
+}
+
+/** A read-only subset of the Fetch Response; the body is buffered, at most 1 MiB, and readable once. */
+export interface TaskFetchResponse {
+  readonly status: number
+  readonly statusText: string
+  readonly ok: boolean
+  readonly redirected: false
+  readonly url: string
+  readonly headers: TaskFetchHeaders
+  readonly bodyUsed: boolean
+  bytes(): Promise<Uint8Array>
+  arrayBuffer(): Promise<ArrayBuffer>
+  text(): Promise<string>
+  json(): Promise<unknown>
 }
 
 export interface MediaPreviewPayload {
@@ -73,13 +108,6 @@ export interface CsvPreviewPayload {
 export type PreviewPayload = MediaPreviewPayload | TextPreviewPayload | ImagePreviewPayload | TablePreviewPayload | CsvPreviewPayload
 export type PreviewType = PreviewPayload['type']
 
-export interface TaskLogger {
-  debug(message: string, data?: unknown): void
-  info(message: string, data?: unknown): void
-  warn(message: string, data?: unknown): void
-  error(message: string, data?: unknown): void
-}
-
 export interface TaskContext<
   Actions extends object = Record<string, never>,
   Workflows extends object = { call: (name: never, input?: never) => Promise<never> },
@@ -92,12 +120,13 @@ export interface TaskContext<
   readonly runId: string
   readonly blockId: string
   readonly artifact: ArtifactCapability
-  readonly fetch: typeof fetch
-  readonly logger: TaskLogger
   /** Reads the selected direct predecessors, sorted by node ID; empty for a graph root. */
   getPrevious(): Promise<readonly PreviousNode[]>
-  preview(payload: PreviewPayload, id?: string): Promise<void>
-  reportProgress(progress: number): Promise<void>
+  /**
+   * Calls an HTTP(S) URL whose host the node declares in its `http` Capability. Redirects are returned, not followed,
+   * and no platform credentials are added. Network failures reject with a TypeError.
+   */
+  fetch(input: string | URL, init?: TaskFetchInit): Promise<TaskFetchResponse>
 }
 
 export type TaskResult<Outputs extends object> = keyof Outputs extends never ? Outputs | void : Outputs

package/src/workflow/common/workflow.ts

@@ -1,23 +1,11 @@
-import type {
-  TaskNode,
-  ManagedTaskDefinition,
-  Port,
-  JsonValue,
-  RevisionContent,
-  GraphNode,
-  WorkflowCapability,
-  AgentWorkflowTool,
-} from '../../flow/common/change.ts'
+import type { TaskNode, ManagedTaskDefinition, Port, JsonValue, RevisionContent, WorkflowCapability, AgentWorkflowTool } from '../../flow/common/change.ts'
 
 import { dequal } from 'dequal/lite'
 import { z } from 'zod'
 import { comparePorts, matchesSchema } from '../../flow/common/schema.ts'
 
-export interface WorkflowExecutor {
-  readonly kind: 'workflow'
-  readonly flowId: string
-  readonly revisionId: string
-}
+export type { WorkflowExecutor } from '../../flow/common/model.ts'
+export { nodeWorkflowReferences } from '../../flow/common/workflowReferences.ts'
 
 const portSchema = z.object({
   handle: z.string().min(1),
@@ -183,35 +171,6 @@ export const workflowReferencesSchema = z.object({
 })
 export type WorkflowReferences = z.infer<typeof workflowReferencesSchema>
 
-/** Workflow declarations share discovery across authoring, admission and resource indexing. */
-export function nodeWorkflowReferences(node: GraphNode): readonly {
-  readonly target: Omit<WorkflowCapability, 'kind' | 'name'>
-  readonly path: string
-  readonly tool?: string
-}[] {
-  if (node.kind != 'task') return []
-  if ('moduleId' in node.task)
-    return (node.task.capabilities ?? []).flatMap((item, index) =>
-      item.kind == 'workflow' ? [{ target: item, path: `task/capabilities/${index}`, tool: item.name }] : [],
-    )
-  if (node.task.executor.kind == 'workflow')
-    return [
-      {
-        target: {
-          ...node.task.executor,
-          inputs: node.task.inputs.filter((port) => 'handle' in port),
-          outputs: node.task.outputs.filter((port) => 'handle' in port),
-        },
-        path: 'task/executor',
-      },
-    ]
-  if (node.task.executor.kind == 'agent')
-    return node.task.executor.tools.flatMap((item, index) =>
-      item.kind == 'workflow' ? [{ target: item, path: `task/executor/tools/${index}`, tool: item.name }] : [],
-    )
-  return []
-}
-
 export function workflowCapability(name: string, target: WorkflowContract | WorkflowCandidate): WorkflowCapability {
   return {
     kind: 'workflow',