[Due for payment 2026-05-15] [Custom Workflow Agents] Add Create Agent flow

[puneetlath]

Part of the Custom workflow agents project

Main issue: https://github.com/Expensify/Expensify/issues/614622
Doc section: https://expensify.enterprise.slack.com/docs/T03SC9DTT/F0AKV1FPD41

Feature Description

In #89284 we will have added the agents page. Now let's add support for creating agents. To do that you will need to:

• Add to that section a New agent button that:
  • Shows a form in the RHP to:
    • Set the profile image (let's just hardcode one avatar for now, we can add selection later)
    • Set the display name (set the default as "Bob's Agent" if the creator is "Bob")
    • Set the the initial prompt
    • Calls a new API command CreateAgent when saved
    • Optimistically creates the agent so that it shows in the list immediately

Manual Test Steps

Since the back-end is not yet returning agents, this can be tested while offline.

1. Click the New agent button
2. Verify you see the modal with the default avatar and the ability to set name and prompt
3. Verify name is defaulted to "bob's agent" assuming the creating user is named "bob"
4. Verify name is editable
5. Verify default prompt is present
6. Verify prompt is editable
7. Hit save
8. Verify CreateAgent API is called in Network tab
9. Verify that the new agent is optimistically shown on the Agents page with the provided details

Automated Tests

Same as manual

Issue Owner

Current Issue Owner: @NicolasBonet

[NicolasBonet]

@MelvinBot let's plan this

[MelvinBot]

Implementation Plan

Here's the plan broken into layers, bottom-up. Each step lists the files to create/modify.

1. Data layer

New file: src/libs/API/parameters/CreateAgentParams.ts
Define the params type for the CreateAgent write command:

• agentAccountID (number) — optimistic ID generated client-side
• displayName (string)
• prompt (string)

Modify: src/libs/API/types.ts

• Add CREATE_AGENT: 'CreateAgent' to WRITE_COMMANDS
• Add the parameter type mapping for CREATE_AGENT

Modify: src/libs/API/parameters/index.ts

• Export CreateAgentParams

New file: src/types/form/CreateAgentForm.ts

• Define INPUT_IDS with DISPLAY_NAME and PROMPT
• Export the form type

Modify: src/types/form/index.ts

• Export CreateAgentForm

Modify: src/ONYXKEYS.ts

• Add CREATE_AGENT_FORM and CREATE_AGENT_FORM_DRAFT to the FORMS section

2. Action layer

Modify: src/libs/actions/Agent.ts

• Add createAgent(displayName, prompt) function that:
  1. Generates an optimistic agent account ID
  2. Builds optimistic Onyx data: sets SHARED_NVP_AGENT_PROMPT_{agentAccountID} with the prompt, and sets personal details for the agent (displayName, avatar)
  3. Calls write(WRITE_COMMANDS.CREATE_AGENT, params, {optimisticData, failureData})
  4. Navigates back to the agents list on success

3. Navigation layer

Modify: src/ROUTES.ts

• Add SETTINGS_AGENTS_CREATE route (path: settings/agents/new)

Modify: src/SCREENS.ts

• Add CREATE: 'Settings_Agent_Create' inside AGENTS

Modify: src/libs/Navigation/AppNavigator/ModalStackNavigators/index.tsx

• Add an AgentsModalStackNavigator with the create screen

Modify: src/libs/Navigation/linkingConfig/config.ts

• Add linking config entry for the agents RHP screens

Modify the RHP navigator (wherever RIGHT_MODAL screens are registered)

• Register SETTINGS_AGENTS modal with the new AgentsModalStackNavigator

4. UI layer

New file: src/pages/settings/Agents/CreateAgentPage.tsx
RHP page with a form containing:

• Avatar — hardcoded for now (use a default agent avatar)
• Display name (TextInput) — default value: "{user's first name}'s Agent"
• Prompt (TextInput, multiline) — default placeholder prompt
• Save button — calls createAgent() action, which optimistically adds the agent and fires the CreateAgent API command

Follow the pattern from CreateCategoryPage.tsx: use FormProvider + InputWrapper + validation.

5. Wire up the button

Modify: src/pages/settings/Agents/AgentsPage.tsx

• Change the onPress={() => {}} on the "New agent" button to navigate to ROUTES.SETTINGS_AGENTS_CREATE

6. Translations

Modify: src/languages/en.ts (and es.ts)

• Add strings under agentsPage for: createAgent (page title), agentName (input label), agentPrompt (input label), defaultPrompt (default prompt text), nameRequired (validation error)

7. Tests

Modify: tests/unit/pages/settings/AgentsPageTest.tsx

• Add test: clicking "New agent" navigates to create screen
• Add test: CreateAgent API is called with correct params on form submit
• Add test: agent appears optimistically in the list after creation

---

Key design decisions to confirm:

1. Avatar: Hardcode a single default avatar per the issue — no avatar picker needed yet
2. Default name: Use "{firstName}'s Agent" from currentUserPersonalDetails
3. Default prompt: Should we include a starter prompt string, or leave the field blank?
4. Optimistic data: Generate a temporary accountID client-side; the server will return the real one. Use SuccessData to update the key if needed

---

Next Steps: Reply with @MelvinBot implement this to create a draft PR, or @MelvinBot <your feedback> to refine this plan.

[mitarachim]

Deploy Blocker #89852 was identified to be related to the PR #89547 that attempted to fix this issue.