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

Interface: ExternalCallerIdentity

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

External identity of the human who triggered an execution, sent by a cross-language caller (e.g. Flame Chorus / Go) on the dedicated agent entrypoint ExecutionWorkflows.provisionAndExecuteAgentFlow.

The entrypoint maps (provider, externalId) to a real FireFlow USR via getOrCreateUserByExternalAccount (idempotent, race-safe) and uses that id as integration.createdBy (the execution's callerId). Using the SAME provider/externalId that the tRPC PersistentAI-session login uses (provider: 'persistentai', externalId: userProfile.id) means a chat trigger and an editor login resolve to the same FireFlow user.

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

Properties

avatarUrl?

optional avatarUrl?: string

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

---

displayName?

optional displayName?: string

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

---

email?

optional email?: string

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

Optional profile data, stored on first provision.

---

externalId

externalId: string

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

Provider-scoped external user id (e.g. PersistentAI userProfile.id).

---

provider

provider: string

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

External auth provider namespace (e.g. 'persistentai').