Flow

flow-level

Top-level chain-link surface for the contact flow. Each .<setter>(…) call mutates a flow-root field; the chain terminates with ;. The Flow and Module namespaces are mutually exclusive, a single script that touches both fails the compile with FlowAndModuleMixed.

Methods

`start`

start(target: Handle) -> Flow

Override the default "first registered block is start" behaviour.

Parameter	Type	Required	Description
`target`	`Handle`	yes	Block whose UUID becomes the flow's `StartAction`.

`version`

version(version: String) -> Flow

Override the default schema version. Decompile only emits this when the wire flow declared a non-default value.

Parameter	Type	Required	Description
`version`	`String`	yes	Schema version string. Connect emits `"2019-10-30"` today.

`auto_layout`

auto_layout(options?: Map) -> Flow

Force a Sugiyama re-layout at compile finalization. Overwrites every block's meta_position regardless of authored values. Call with no arguments for the default layout, or pass an options map (auto_layout(#{ direction: "top-bottom", layer_spacing: 220 })) to tune the layout direction and spacing.

Parameter	Type	Required	Description
`options`	`Map`	no	Optional layout knobs: `direction` ("left-right" \| "top-bottom"), `layer_spacing`, `node_spacing`, `block_width`, `block_height`. Omit for Connect-friendly defaults; unknown keys are rejected at compile time.

`name`

name(name: String) -> Flow

Set the flow's display name (Metadata.name).

Parameter	Type	Required	Description
`name`	`String`	yes	Display name shown in the Connect console.

`description`

description(description: String) -> Flow

Set the flow's description (Metadata.description).

Parameter	Type	Required	Description
`description`	`String`	yes	Long-form description.

`type`

type(ty: String) -> Flow

Set the flow's type tag (Metadata.type).

Parameter	Type	Required	Description
`ty`	`String`	yes	Connect resource type, `"contactFlow"`, `"customerQueue"`, `"contactFlowModule"`, etc.

`status`

status(status: String) -> Flow

Set the flow's published status (Metadata.status).

Parameter	Type	Required	Description
`status`	`String`	yes	Connect-side publish status.

`hash`

hash(hash: String) -> Flow

Set the flow's content hash (Metadata.hash). Connect computes this on save; the builder round-trips whatever the operator provides.

Parameter	Type	Required	Description
`hash`	`String`	yes	Content hash.

`entry_point_position`

entry_point_position(x: Number, y: Number) -> Flow

Position the flow's entry-point arrow on the canvas.

Parameter	Type	Required	Description
`x`	`Number`	yes	Canvas X.
`y`	`Number`	yes	Canvas Y.

`snap_to_grid`

snap_to_grid(value: bool) -> Flow

Toggle the snap-to-grid console UI preference.

Parameter	Type	Required	Description
`value`	`bool`	yes	True to snap blocks to the canvas grid.

`raw`

raw(key: String, value: Dynamic) -> Flow

Escape hatch for top-level wire keys the typed surface doesn't model.

Parameter	Type	Required	Description
`key`	`String`	yes	Top-level wire key.
`value`	`Dynamic`	yes	Any Rhai value; serialized as JSON.