fix(ENG-12152): render description and tooltips for falcon connectors

[adefreitas]

Before

After

---

Summary by cubic

Fixes missing tooltips and descriptions for Falcon connectors in the Auth Hub by falling back to field.description and field.tooltip when guide is absent. Restores parity with V2 connectors and improves account linking.

• Bug Fixes
  • Render tooltips/descriptions for Falcon fields by using guide values when present, otherwise field.description/field.tooltip.
  • Add optional description and tooltip to ConnectorConfigField; addresses ENG-12152.

^{Written for commit 213a0b2. Summary will update on new commits.}

[cubic-dev-ai]

cubic analysis

No issues found across 2 files

Linked issue analysis

Linked issue: ENG-12152: Fix tooltip and description display for Falcon connectors in the hub

Status	Acceptance criteria	Notes
✅	Tooltips are displayed for Falcon connectors	Added tooltip fallback to field.tooltip in IntegrationFields.tsx
✅	Descriptions are displayed for Falcon connectors	Added description fallback to field.description in IntegrationFields.tsx
✅	Behavior is consistent with V2 connectors (guide.* still preferred)	Code prefers guide.* then falls back to field.*
✅	ConnectorConfigField type includes description and tooltip	Added optional description and tooltip in types.ts
✅	Apply tooltip/description fallback across all field renderers (secret, input, textarea, select)	All render paths updated in IntegrationFields.tsx
⚠️	Fix aids successful account linking (UX/outcome)	UI help text restored but no metrics or tests proving improved linking

[Copilot]

Pull request overview

This PR updates the integration picker field rendering to display per-field descriptions and tooltips for Falcon connector configuration fields (in addition to the existing legacy “guide” metadata), aligning the UI with the expected connector config shape.

Changes:

• Extend ConnectorConfigField to support optional description and tooltip.
• Update field rendering to fall back from field.guide to the new top-level field.description / field.tooltip across input, textarea, and dropdown fields.

Reviewed changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated no comments.

File	Description
src/modules/integration-picker/types.ts	Adds optional description/tooltip to the config field type so Falcon configs can supply field help text directly.
src/modules/integration-picker/components/IntegrationFields.tsx	Uses field.guide?.* ?? field.* so the UI renders help text for both legacy and Falcon connector field shapes.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

You can also share your feedback on Copilot code review. Take the survey.