@persistent-ai/fireflow-executor / server / ProvisionAndExecuteFireFlowInput

Interface: ProvisionAndExecuteFireFlowInput

Defined in: packages/fireflow-executor/types/messages.ts:134

Input for ExecutionWorkflows.provisionAndExecuteFireFlow.

Cross-language entry point used by external services (e.g. Flame Chorus / Go) that enqueue a FireFlow execution via DBOS without first calling the tRPC executionRouter.create endpoint. The wrapper workflow takes responsibility for inserting the executions row before delegating to the normal execution pipeline (the same pipeline used by the tRPC path).

Field names mirror the Go struct internal/workflows.ProvisionAndExecuteFireFlowInput exactly.

Properties

applicationVersion?

optional applicationVersion?: string

Defined in: packages/fireflow-executor/types/messages.ts:150

---

caller?

optional caller?: ExternalCallerIdentity

Defined in: packages/fireflow-executor/types/messages.ts:170

External identity of the human who triggered this execution. Consumed only by provisionAndExecuteAgentFlow, which maps it to a real FireFlow USR and overwrites integration.createdBy with that id. Absent on the generic provisionAndExecuteFireFlow path (there integration.createdBy is trusted verbatim).

---

commitHash

commitHash: string

Defined in: packages/fireflow-executor/types/messages.ts:143

---

debug?

optional debug?: boolean

Defined in: packages/fireflow-executor/types/messages.ts:149

---

executionDepth?

optional executionDepth?: number

Defined in: packages/fireflow-executor/types/messages.ts:156

---

executionId

executionId: string

Defined in: packages/fireflow-executor/types/messages.ts:136

---

externalEvents?

optional externalEvents?: object[]

Defined in: packages/fireflow-executor/types/messages.ts:161

actionName

actionName: string

eventName?

optional eventName?: string

payload?

optional payload?: any

---

flowId

flowId: string

Defined in: packages/fireflow-executor/types/messages.ts:137

---

flowVersion?

optional flowVersion?: number

Defined in: packages/fireflow-executor/types/messages.ts:145

Deprecated

RFC 057 — superseded by commitHash.

---

integration

integration: objectOutputType

Defined in: packages/fireflow-executor/types/messages.ts:154

---

maxTimeoutMs?

optional maxTimeoutMs?: number

Defined in: packages/fireflow-executor/types/messages.ts:148

---

options?

optional options?: object

Defined in: packages/fireflow-executor/types/messages.ts:155

breakpoints?

optional breakpoints?: string[]

debug?

optional debug?: boolean

execution?

optional execution?: object

execution.flowTimeoutMs?

optional flowTimeoutMs?: number

execution.maxConcurrency?

optional maxConcurrency?: number

execution.nodeTimeoutMs?

optional nodeTimeoutMs?: number

---

ownerId

ownerId: string

Defined in: packages/fireflow-executor/types/messages.ts:153

---

parentExecutionId?

optional parentExecutionId?: string

Defined in: packages/fireflow-executor/types/messages.ts:146

---

path

path: string

Defined in: packages/fireflow-executor/types/messages.ts:141

---

ref

ref: string

Defined in: packages/fireflow-executor/types/messages.ts:142

---

timestamp

timestamp: number

Defined in: packages/fireflow-executor/types/messages.ts:147

---

workspaceId

workspaceId: string

Defined in: packages/fireflow-executor/types/messages.ts:140