feat(oracle-fusion): add SCM integration

Author: Bill Leoutsakos

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

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

apps/docs/content/docs/integrations/meta.json

@@ -187,6 +187,7 @@
     "onedrive",
     "onepassword",
     "openai",
+    "oracle_fusion_scm",
     "outlook",
     "pagerduty",
     "parallel_ai",

apps/docs/content/docs/integrations/oracle_fusion_scm.mdx

@@ -0,0 +1,156 @@
+/**
+ * @vitest-environment node
+ */
+import { describe, expect, it } from 'vitest'
+import { OracleFusionScmBlock, OracleFusionScmBlockMeta } from '@/blocks/blocks/oracle_fusion_scm'
+import type { SubBlockConfig } from '@/blocks/types'
+import * as oracleFusionScmTools from '@/tools/oracle_fusion_scm'
+import type { ToolConfig } from '@/tools/types'
+
+const toolsById = new Map<string, ToolConfig>(
+  Object.values(oracleFusionScmTools)
+    .filter((value): value is ToolConfig =>
+      Boolean(value && typeof value === 'object' && 'id' in value)
+    )
+    .map((tool) => [tool.id, tool])
+)
+
+const subBlocks: SubBlockConfig[] = OracleFusionScmBlock.subBlocks
+const access = OracleFusionScmBlock.tools.access ?? []
+const operation = subBlocks.find((subBlock) => subBlock.id === 'operation')
+const options =
+  typeof operation?.options === 'function' ? operation.options() : (operation?.options ?? [])
+const operationIds = options.map((option) => option.id)
+
+function visibleFor(operationId: string): SubBlockConfig[] {
+  return subBlocks.filter((subBlock) => {
+    const condition = subBlock.condition
+    if (typeof condition === 'function' || !condition) return true
+    if (condition.field !== 'operation') return false
+    return Array.isArray(condition.value)
+      ? condition.value.includes(operationId)
+      : condition.value === operationId
+  })
+}
+
+function visibleOutputNames(operationId: string): string[] {
+  return Object.entries(OracleFusionScmBlock.outputs)
+    .filter(([, output]) => {
+      const condition = output.condition
+      if (!condition) return true
+      return Array.isArray(condition.value)
+        ? condition.value.includes(operationId)
+        : condition.value === operationId
+    })
+    .map(([name]) => name)
+}
+
+describe('Oracle Fusion SCM block', () => {
+  it('exposes all 20 tools as direct operation values and canvas sentences', () => {
+    expect(access).toHaveLength(20)
+    expect(new Set(operationIds)).toEqual(new Set(access))
+    expect(new Set(toolsById.keys())).toEqual(new Set(access))
+    expect(
+      Object.keys(OracleFusionScmBlock.canvasPresentation?.sentences?.byOperation ?? {})
+    ).toEqual(expect.arrayContaining(access))
+    for (const operationId of access) {
+      expect(OracleFusionScmBlock.tools.config?.tool?.({ operation: operationId })).toBe(
+        operationId
+      )
+    }
+  })
+
+  it('keeps subBlock ids unique and covers every required tool parameter', () => {
+    const ids = subBlocks.map((subBlock) => subBlock.id)
+    expect(new Set(ids).size).toBe(ids.length)
+
+    const missing: string[] = []
+    for (const operationId of access) {
+      const tool = toolsById.get(operationId)
+      if (!tool) continue
+      const visible = visibleFor(operationId)
+      const canonicalIds = new Set(
+        visible.flatMap((subBlock) => [subBlock.id, subBlock.canonicalParamId].filter(Boolean))
+      )
+      for (const [name, param] of Object.entries(tool.params)) {
+        if (param.visibility === 'hidden' || !param.required) continue
+        if (!canonicalIds.has(name)) missing.push(`${operationId}.${name}`)
+      }
+    }
+    expect(missing).toEqual([])
+  })
+
+  it('shows finder only for the four documented resource families', () => {
+    const finder = subBlocks.find((subBlock) => subBlock.id === 'finder')
+    expect(finder?.condition).toEqual({
+      field: 'operation',
+      value: [
+        'oracle_fusion_scm_list_inventory_organizations',
+        'oracle_fusion_scm_list_items',
+        'oracle_fusion_scm_list_inventory_transactions',
+        'oracle_fusion_scm_list_supply_requests',
+      ],
+    })
+  })
+
+  it('shows pagination only for lists and only the matching wrapper for details', () => {
+    const pageOutputs = [
+      'items',
+      'count',
+      'hasMore',
+      'limit',
+      'offset',
+      'totalResults',
+      'nextOffset',
+    ]
+    for (const operationId of access.filter((id) => id.includes('_list_'))) {
+      expect(visibleOutputNames(operationId)).toEqual(pageOutputs)
+    }
+    expect(visibleOutputNames('oracle_fusion_scm_get_inventory_organization')).toEqual([
+      'organization',
+    ])
+    expect(visibleOutputNames('oracle_fusion_scm_get_item')).toEqual(['item'])
+    expect(visibleOutputNames('oracle_fusion_scm_get_on_hand_quantity')).toEqual(['onHandQuantity'])
+    expect(visibleOutputNames('oracle_fusion_scm_get_inventory_transaction')).toEqual([
+      'transaction',
+    ])
+    expect(visibleOutputNames('oracle_fusion_scm_get_supply_request')).toEqual(['supplyRequest'])
+    expect(visibleOutputNames('oracle_fusion_scm_get_supply_order_line')).toEqual([
+      'supplyOrderLine',
+    ])
+    expect(visibleOutputNames('oracle_fusion_scm_get_shipment')).toEqual(['shipment'])
+    expect(visibleOutputNames('oracle_fusion_scm_get_shipment_line')).toEqual(['shipmentLine'])
+    expect(visibleOutputNames('oracle_fusion_scm_get_manufacturing_work_order')).toEqual([
+      'manufacturingWorkOrder',
+    ])
+    expect(visibleOutputNames('oracle_fusion_scm_get_maintenance_work_order')).toEqual([
+      'maintenanceWorkOrder',
+    ])
+  })
+
+  it('binds all six project selectors to the stored SCM credential', () => {
+    const selectors = subBlocks.filter((subBlock) => subBlock.type === 'project-selector')
+    expect(selectors).toHaveLength(6)
+    for (const selector of selectors) {
+      expect(selector.serviceId).toBe('oracle_fusion_scm')
+      expect(selector.dependsOn).toEqual(['credential'])
+      expect(selector.canonicalParamId).toBeTruthy()
+    }
+  })
+
+  it('ships exactly nine templates and operation-grounded skills', () => {
+    expect(OracleFusionScmBlockMeta.templates).toHaveLength(9)
+    expect(OracleFusionScmBlockMeta.skills).toHaveLength(7)
+    for (const template of OracleFusionScmBlockMeta.templates) {
+      expect(template.prompt.length).toBeGreaterThan(40)
+      expect(template.modules.length).toBeGreaterThan(0)
+      expect(template.tags.length).toBeGreaterThan(0)
+    }
+    for (const skill of OracleFusionScmBlockMeta.skills) {
+      expect(skill.name).toMatch(/^[a-z0-9]+(?:-[a-z0-9]+)*$/)
+      expect(skill.content).toContain('# ')
+      expect(skill.content).toContain('## Steps')
+      expect(skill.content).toContain('## Output')
+    }
+  })
+})