Alloy AI Node (Agent Step)

The builder's "Alloy AI" node is the workflow step with `type: agent`.

- `agent` workflows can contain only this node type. - `structured` workflows cannot use the Alloy AI node. - In the current builder, the node is single-purpose: - it must be connected directly from `Starting Step` - it has no normal outgoing branch UI like structured nodes

- `prompt` - `model` - optional tool allowlist

- The main model must be a standard text model. - Validation rejects realtime, TTS, and STT models as the main model for this node.

- Tools come from the agent tool catalog in `agent-tools.md`. - The runtime also adds dynamic `skill.*` tools for the teammate's other assigned skills, excluding the current workflow. - `web.search` appears only when the selected model provider exposes native search. - Voice mode additionally injects `contact.send_message`, even if it was not selected in the node. - Runtime execution also loads MCP toolsets for the current employee alongside the selected Alloy tools.

- Prompt assembly uses organization variables, mode-specific system prompt text, current organization context, employee persona, current time, recent chat history, and conversation user info when available. - Runtime context inherits `WorkflowRun.state.runtimeContext` and adds `runId`, `organizationId`, `employeeId`, and `currentStepId`. - Execution runs through `AgentStepProcessor` and `MastraAgentExecutor`, which stream output, record token usage, persist/update conversation messages, and retry configured fallback chat models on non-terminal failures. - If the node has an output schema, the backend makes a second formatting call to turn the final text into that schema. - If image attachments are present in step input, only image attachments are injected into the model request. - Final output is either the structured object or `{ message: <text> }`.

- `skill.<name>`: run another skill assigned to the same teammate. - `agent.call_teammate`: run another employee's default workflow. - `agent.run_subagent`: run a temporary child agent with a selected model and subset of agent tools.