refactor(integrations): use shared Oracle Fusion foundation

Author: Bill Leoutsakos

apps/docs/components/ui/icon-mapping.ts

@@ -175,6 +175,7 @@ import {
   OktaIcon,
   OnePasswordIcon,
   OpenAIIcon,
+  OracleIcon,
   OutlookIcon,
   PackageSearchIcon,
   PagerDutyIcon,
@@ -480,7 +481,7 @@ export const blockTypeToIconMap: Record<string, IconComponent> = {
   onedrive: MicrosoftOneDriveIcon,
   onepassword: OnePasswordIcon,
   openai: OpenAIIcon,
-  oracle_fusion_hcm: NetSuiteIcon,
+  oracle_fusion_hcm: OracleIcon,
   outlook: OutlookIcon,
   pagerduty: PagerDutyIcon,
   parallel_ai: ParallelIcon,

apps/docs/content/docs/integrations/oracle_fusion_hcm.mdx

@@ -0,0 +1,64 @@
+/**
+ * @vitest-environment node
+ */
+import { describe, expect, it } from 'vitest'
+import { OracleIcon } from '@/components/icons'
+import { OracleFusionHcmBlock, OracleFusionHcmBlockMeta } from '@/blocks/blocks/oracle_fusion_hcm'
+import { AuthMode } from '@/blocks/types'
+
+describe('OracleFusionHcmBlock', () => {
+  const subBlock = (id: string) =>
+    OracleFusionHcmBlock.subBlocks.find((candidate) => candidate.id === id)
+
+  it('uses one reusable service-account credential with a canonical manual fallback', () => {
+    expect(OracleFusionHcmBlock.authMode).toBe(AuthMode.ApiKey)
+    expect(OracleFusionHcmBlock.icon).toBe(OracleIcon)
+    expect(subBlock('credential')).toMatchObject({
+      type: 'oauth-input',
+      serviceId: 'oracle_fusion_hcm',
+      requiredScopes: [],
+      credentialKind: 'service-account',
+      canonicalParamId: 'oauthCredential',
+      mode: 'basic',
+      required: true,
+    })
+    expect(subBlock('manualCredential')).toMatchObject({
+      type: 'short-input',
+      canonicalParamId: 'oauthCredential',
+      mode: 'advanced',
+      required: true,
+    })
+  })
+
+  it('removes raw destination and username/password inputs', () => {
+    const subBlockIds = OracleFusionHcmBlock.subBlocks.map((candidate) => candidate.id)
+    expect(subBlockIds).not.toEqual(expect.arrayContaining(['tenantUrl', 'username', 'password']))
+    expect(OracleFusionHcmBlock.inputs).toHaveProperty('oauthCredential')
+    expect(OracleFusionHcmBlock.inputs).not.toHaveProperty('tenantUrl')
+    expect(OracleFusionHcmBlock.inputs).not.toHaveProperty('username')
+    expect(OracleFusionHcmBlock.inputs).not.toHaveProperty('password')
+  })
+
+  it('keeps all 18 tools, four protected selectors, and shared cursor output wired', () => {
+    expect(OracleFusionHcmBlock.tools.access).toHaveLength(18)
+    expect(
+      ['personPicker', 'assignmentPicker', 'absencePicker', 'absenceTypePicker'].map((id) =>
+        subBlock(id)
+      )
+    ).toEqual([
+      expect.objectContaining({ selectorKey: 'oracle_fusion_hcm.workers' }),
+      expect.objectContaining({ selectorKey: 'oracle_fusion_hcm.assignments' }),
+      expect.objectContaining({ selectorKey: 'oracle_fusion_hcm.absences' }),
+      expect.objectContaining({ selectorKey: 'oracle_fusion_hcm.absenceTypes' }),
+    ])
+    expect(OracleFusionHcmBlock.outputs).toHaveProperty('nextOffset')
+  })
+
+  it('preserves all eight templates and seven skills with Oracle branding', () => {
+    expect(OracleFusionHcmBlockMeta.templates).toHaveLength(8)
+    expect(OracleFusionHcmBlockMeta.skills).toHaveLength(7)
+    for (const template of OracleFusionHcmBlockMeta.templates) {
+      expect(template.icon).toBe(OracleIcon)
+    }
+  })
+})

apps/sim/blocks/blocks/oracle_fusion_hcm.test.ts

@@ -1,4 +1,5 @@
-import { NetSuiteIcon } from '@/components/icons'
+import { OracleIcon } from '@/components/icons'
+import { getScopesForService } from '@/lib/oauth/utils'
 import type { BlockConfig, BlockMeta } from '@/blocks/types'
 import { AuthMode, IntegrationType } from '@/blocks/types'
 
@@ -62,13 +63,13 @@ export const OracleFusionHcmBlock: BlockConfig = {
   name: 'Oracle Fusion Cloud HCM',
   description: 'Read workers, absences, reporting lines, and workforce structures',
   longDescription:
-    'Connect to Oracle Fusion Cloud HCM with a least-privilege Basic-auth account. Read public worker profiles, assignments, reporting relationships, absences, absence types, and workforce structures without exposing write operations or sensitive HR fields.',
+    'Connect to Oracle Fusion Cloud HCM with a reusable, least-privilege integration-user credential. Read public worker profiles, assignments, reporting relationships, absences, absence types, and workforce structures without exposing write operations, raw credentials, or sensitive HR fields.',
   docsLink: 'https://docs.sim.ai/integrations/oracle_fusion_hcm',
   category: 'tools',
   integrationType: IntegrationType.HR,
   authMode: AuthMode.ApiKey,
   bgColor: '#F80000',
-  icon: NetSuiteIcon,
+  icon: OracleIcon,
   canvasPresentation: {
     defaultTitle: 'Oracle Fusion Cloud HCM',
     sentences: {
@@ -128,26 +129,24 @@ export const OracleFusionHcmBlock: BlockConfig = {
       ],
     },
     {
-      id: 'tenantUrl',
-      title: 'Tenant URL',
-      type: 'short-input',
-      placeholder: 'https://example.fa.ocs.oraclecloud.com',
-      required: true,
-      description: 'Canonical Oracle Fusion application origin',
-    },
-    {
-      id: 'username',
-      title: 'Username',
-      type: 'short-input',
-      placeholder: 'Integration username',
+      id: 'credential',
+      title: 'Oracle Fusion Account',
+      type: 'oauth-input',
+      serviceId: 'oracle_fusion_hcm',
+      requiredScopes: getScopesForService('oracle_fusion_hcm'),
+      credentialKind: 'service-account',
+      canonicalParamId: 'oauthCredential',
+      mode: 'basic',
+      placeholder: 'Select Oracle Fusion credential',
       required: true,
     },
     {
-      id: 'password',
-      title: 'Password',
+      id: 'manualCredential',
+      title: 'Oracle Fusion Account',
       type: 'short-input',
-      placeholder: 'Integration password',
-      password: true,
+      canonicalParamId: 'oauthCredential',
+      mode: 'advanced',
+      placeholder: 'Enter credential ID',
       required: true,
     },
     {
@@ -157,7 +156,7 @@ export const OracleFusionHcmBlock: BlockConfig = {
       canonicalParamId: 'personId',
       serviceId: 'oracle_fusion_hcm',
       selectorKey: 'oracle_fusion_hcm.workers',
-      dependsOn: ['tenantUrl', 'username', 'password'],
+      dependsOn: ['credential'],
       mode: 'basic',
       condition: { field: 'operation', value: [...PERSON_OPERATIONS, 'get_absence'] },
       required: { field: 'operation', value: PERSON_OPERATIONS },
@@ -180,7 +179,7 @@ export const OracleFusionHcmBlock: BlockConfig = {
       canonicalParamId: 'assignmentId',
       serviceId: 'oracle_fusion_hcm',
       selectorKey: 'oracle_fusion_hcm.assignments',
-      dependsOn: ['tenantUrl', 'username', 'password', 'personPicker'],
+      dependsOn: ['credential', 'personPicker'],
       mode: 'basic',
       condition: { field: 'operation', value: ASSIGNMENT_OPERATIONS },
       required: { field: 'operation', value: ASSIGNMENT_OPERATIONS },
@@ -203,7 +202,7 @@ export const OracleFusionHcmBlock: BlockConfig = {
       canonicalParamId: 'absenceId',
       serviceId: 'oracle_fusion_hcm',
       selectorKey: 'oracle_fusion_hcm.absences',
-      dependsOn: ['tenantUrl', 'username', 'password', 'personPicker'],
+      dependsOn: ['credential', 'personPicker'],
       mode: 'basic',
       condition: { field: 'operation', value: 'get_absence' },
       required: { field: 'operation', value: 'get_absence' },
@@ -226,7 +225,7 @@ export const OracleFusionHcmBlock: BlockConfig = {
       canonicalParamId: 'absenceTypeId',
       serviceId: 'oracle_fusion_hcm',
       selectorKey: 'oracle_fusion_hcm.absenceTypes',
-      dependsOn: ['tenantUrl', 'username', 'password', 'personPicker'],
+      dependsOn: ['credential', 'personPicker'],
       mode: 'basic',
       condition: { field: 'operation', value: 'list_absences' },
       placeholder: 'Optionally select an absence type',
@@ -339,9 +338,7 @@ export const OracleFusionHcmBlock: BlockConfig = {
   },
   inputs: {
     operation: { type: 'string', description: 'Read-only Oracle HCM operation' },
-    tenantUrl: { type: 'string', description: 'Oracle Fusion tenant origin' },
-    username: { type: 'string', description: 'Oracle username' },
-    password: { type: 'string', description: 'Oracle password' },
+    oauthCredential: { type: 'string', description: 'Oracle Fusion integration-user credential' },
     personId: { type: 'string', description: 'Person ID' },
     assignmentId: { type: 'string', description: 'Assignment ID' },
     absenceId: { type: 'string', description: 'Absence entry ID' },
@@ -486,6 +483,11 @@ export const OracleFusionHcmBlock: BlockConfig = {
       description: 'Estimated total when Oracle provides it',
       condition: { field: 'operation', value: LIST_OPERATIONS },
     },
+    nextOffset: {
+      type: 'number',
+      description: 'Next Oracle page offset when another page exists',
+      condition: { field: 'operation', value: LIST_OPERATIONS },
+    },
   },
 }
 
@@ -494,7 +496,7 @@ export const OracleFusionHcmBlockMeta = {
   url: 'https://www.oracle.com/human-capital-management/',
   templates: [
     {
-      icon: NetSuiteIcon,
+      icon: OracleIcon,
       title: 'Oracle worker lookup',
       prompt:
         'Build a workflow that safely searches Oracle Fusion Cloud HCM public workers, retrieves the selected worker and assignments, and returns only work identity and organizational details.',
@@ -503,7 +505,7 @@ export const OracleFusionHcmBlockMeta = {
       tags: ['hr', 'enterprise'],
     },
     {
-      icon: NetSuiteIcon,
+      icon: OracleIcon,
       title: 'Oracle reporting chain review',
       prompt:
         'Create a workflow that selects an Oracle HCM worker and assignment, lists that assignment’s managers, and formats a concise reporting-chain review.',
@@ -512,7 +514,7 @@ export const OracleFusionHcmBlockMeta = {
       tags: ['hr', 'reporting'],
     },
     {
-      icon: NetSuiteIcon,
+      icon: OracleIcon,
       title: 'Oracle direct reports roster',
       prompt:
         'Build a workflow that lists direct reports for a selected Oracle HCM assignment and writes the bounded roster page to a review table.',
@@ -521,7 +523,7 @@ export const OracleFusionHcmBlockMeta = {
       tags: ['hr', 'reporting'],
     },
     {
-      icon: NetSuiteIcon,
+      icon: OracleIcon,
       title: 'Oracle assignment audit',
       prompt:
         'Create a scheduled workflow that reads worker assignments from Oracle HCM, compares department, job, position, and location with a reference table, and flags mismatches without changing Oracle.',
@@ -530,7 +532,7 @@ export const OracleFusionHcmBlockMeta = {
       tags: ['hr', 'compliance'],
     },
     {
-      icon: NetSuiteIcon,
+      icon: OracleIcon,
       title: 'Oracle absence calendar',
       prompt:
         'Build a workflow that reads one worker’s Oracle HCM absences for a selected absence type and date range, then creates a review calendar without exposing reasons, comments, attachments, or medical data.',
@@ -539,7 +541,7 @@ export const OracleFusionHcmBlockMeta = {
       tags: ['hr', 'planning'],
     },
     {
-      icon: NetSuiteIcon,
+      icon: OracleIcon,
       title: 'Oracle absence approval review',
       prompt:
         'Create a workflow that lists a worker’s Oracle HCM absences, summarizes status, approval state, dates, and duration, and routes exceptions for human review.',
@@ -548,7 +550,7 @@ export const OracleFusionHcmBlockMeta = {
       tags: ['hr', 'review'],
     },
     {
-      icon: NetSuiteIcon,
+      icon: OracleIcon,
       title: 'Oracle workforce structure catalog',
       prompt:
         'Build a scheduled workflow that reads one page each of Oracle HCM jobs, job families, departments, locations, business units, legal employers, grades, and person types and stores a dated catalog snapshot.',
@@ -557,7 +559,7 @@ export const OracleFusionHcmBlockMeta = {
       tags: ['hr', 'reporting'],
     },
     {
-      icon: NetSuiteIcon,
+      icon: OracleIcon,
       title: 'Oracle job alignment report',
       prompt:
         'Create a workflow that compares Oracle HCM jobs, positions, and grades by code and effective date, then produces a bounded alignment report for HR review.',
@@ -607,7 +609,7 @@ export const OracleFusionHcmBlockMeta = {
       name: 'page-oracle-hcm-results',
       description: 'Continue an Oracle HCM collection safely.',
       content:
-        '# Page Oracle HCM Results\n\n## Steps\n\n1. Read the returned limit, offset, and hasMore values.\n2. Continue at offset plus limit only when hasMore is true and another page is needed.\n3. Never auto-load an entire collection.\n\n## Output\n\nReturn the requested page and its updated pagination state.',
+        '# Page Oracle HCM Results\n\n## Steps\n\n1. Read the returned nextOffset and hasMore values.\n2. Continue at nextOffset only when hasMore is true and another page is needed.\n3. Never auto-load an entire collection.\n\n## Output\n\nReturn the requested page and its updated pagination state.',
     },
   ],
 } as const satisfies BlockMeta

apps/sim/blocks/blocks/oracle_fusion_hcm.ts

@@ -29,9 +29,8 @@ const dateSchema = z
 const searchSchema = z.string().trim().min(1).max(200).optional()
 
 const oracleFusionHcmBaseBodySchema = z.object({
-  tenantUrl: z.string().trim().min(1).max(2048),
-  username: z.string().trim().min(1).max(256),
-  password: z.string().min(1).max(2048),
+  instanceUrl: z.string().trim().min(1).max(2048),
+  accessToken: z.string().min(1).max(4096),
 })
 
 const paginationBodyShape = {
@@ -272,6 +271,7 @@ const paginationResponseShape = {
   limit: z.number().int().min(0),
   offset: z.number().int().min(0),
   totalResults: z.number().int().min(0).optional(),
+  nextOffset: z.number().int().min(0).optional(),
 }
 
 const successResponse = <T extends z.ZodType>(output: T) =>

apps/sim/lib/api/contracts/tools/oracle-fusion-hcm.ts

@@ -173,6 +173,7 @@ import {
   ObsidianIcon,
   OktaIcon,
   OnePasswordIcon,
+  OracleIcon,
   OutlookIcon,
   PackageSearchIcon,
   PagerDutyIcon,
@@ -462,7 +463,7 @@ export const blockTypeToIconMap: Record<string, IconComponent> = {
   okta: OktaIcon,
   onedrive: MicrosoftOneDriveIcon,
   onepassword: OnePasswordIcon,
-  oracle_fusion_hcm: NetSuiteIcon,
+  oracle_fusion_hcm: OracleIcon,
   outlook: OutlookIcon,
   pagerduty: PagerDutyIcon,
   parallel_ai: ParallelIcon,