fix(workflows): resolve tool references by active canonical mode and keep the reference cache live

- workflow_input tools inside tool-input now resolve basic/advanced via the
  index-scoped canonicalModes override, mirroring execution (Cursor finding)
- staleTime back to 0: no mutation invalidates this key, so a reopen must
  background-refetch; on-demand mounting keeps the cached tree painting
  instantly (Greptile P1)
- modal header uses the em-dash label-entity convention; tree items carry
  aria-level instead of a static aria-selected

Author: waleedlatif1

apps/sim/app/workspace/[workspaceId]/w/components/sidebar/components/workflow-list/components/references-modal/components/reference-tree/reference-tree.tsx

@@ -24,7 +24,7 @@ interface ReferenceTreeItemProps {
 
 function ReferenceTreeItem({ node, depth, onNavigate }: ReferenceTreeItemProps) {
   return (
-    <div role='treeitem' aria-selected={false}>
+    <div role='treeitem' aria-level={depth + 1}>
       <button
         type='button'
         onClick={() => onNavigate(node.id)}

apps/sim/app/workspace/[workspaceId]/w/components/sidebar/components/workflow-list/components/references-modal/references-modal.tsx

@@ -51,7 +51,7 @@ export function ReferencesModal({
 
   return (
     <ChipModal open onOpenChange={(next) => !next && onClose()} srTitle='References'>
-      <ChipModalHeader onClose={onClose}>References · {workflowName}</ChipModalHeader>
+      <ChipModalHeader onClose={onClose}>References — {workflowName}</ChipModalHeader>
       <ChipModalBody>
         <ChipModalTabs
           tabs={TABS}

apps/sim/hooks/queries/workflow-references.ts

@@ -6,11 +6,12 @@ import {
 } from '@/lib/api/contracts/workflow-references'
 
 /**
- * Short — the graph reflects live editor state (workflow blocks/names can change
- * between opens). The modal mounts on demand, so each open refetches once the
- * window lapses while still absorbing rapid open/close flapping.
+ * Zero — the graph reflects live editor state, and no workflow-edit mutation
+ * invalidates this key (edits arrive over the socket, not through React Query).
+ * The modal mounts on demand, so every open refetches; a reopen paints the
+ * cached tree instantly while the background refetch reconciles it.
  */
-export const WORKFLOW_REFERENCES_STALE_TIME = 30 * 1000
+export const WORKFLOW_REFERENCES_STALE_TIME = 0
 
 export const workflowReferenceKeys = {
   all: ['workflow-references'] as const,

apps/sim/lib/workflows/references/operations.test.ts

@@ -198,6 +198,25 @@ describe('resolveWorkflowReferences', () => {
     expect(bResult.callers.map((n) => n.id)).toEqual(['a'])
   })
 
+  it('resolves a workflow tool to its active advanced-mode value', () => {
+    // Tool 0 is toggled to advanced via the index-scoped canonicalModes key; the
+    // stale basic selector (`b`) must not mask the live manual value (`c`).
+    const blocks: ReferenceBlockRow[] = [
+      {
+        parentId: 'a',
+        type: 'agent',
+        childFromSelector: null,
+        childFromManual: null,
+        canonicalModes: { '0:workflowId': 'advanced' },
+        toolInputValues: [
+          [{ type: 'workflow_input', params: { workflowId: 'b', manualWorkflowId: 'c' } }],
+        ],
+      },
+    ]
+    const { callees } = resolveWorkflowReferences('a', workflows, blocks, [])
+    expect(callees.map((n) => n.id)).toEqual(['c'])
+  })
+
   it('resolves workflow tools from a JSON-stringified tool-input value', () => {
     const blocks: ReferenceBlockRow[] = [
       {

apps/sim/lib/workflows/references/operations.ts

@@ -9,6 +9,7 @@ import {
   type CanonicalGroup,
   type CanonicalModeOverrides,
   resolveActiveCanonicalValue,
+  scopeCanonicalModesForTool,
 } from '@/lib/workflows/subblocks/visibility'
 import { CUSTOM_BLOCK_TYPE_PREFIX } from '@/blocks/custom/build-config'
 import { BlockType, isWorkflowBlockType } from '@/executor/constants'
@@ -85,20 +86,40 @@ interface ReferenceGraph {
 
 /**
  * Callee workflow ids referenced by a block's tool-input values: `workflow_input`
- * tools whose `params.workflowId` was picked from the workflow selector.
+ * tools resolved to their ACTIVE canonical member — the basic `params.workflowId`
+ * selector or the advanced `params.manualWorkflowId` input, per the tool's
+ * index-scoped `canonicalModes` override ({@link scopeCanonicalModesForTool}) —
+ * mirroring how execution picks the live value.
  */
-function toolInputCallees(toolInputValues: unknown[] | null): string[] {
+function toolInputCallees(
+  toolInputValues: unknown[] | null,
+  canonicalModes: CanonicalModeOverrides | null
+): string[] {
   if (!toolInputValues) return []
   const callees: string[] = []
   for (const value of toolInputValues) {
     const { array } = coerceObjectArray(value)
     if (!array) continue
-    for (const tool of array) {
+    array.forEach((tool, toolIndex) => {
       if (!isRecord(tool) || tool.type !== BlockType.WORKFLOW_INPUT || !isRecord(tool.params)) {
-        continue
+        return
       }
-      if (typeof tool.params.workflowId === 'string') callees.push(tool.params.workflowId)
-    }
+      const scoped = scopeCanonicalModesForTool(
+        canonicalModes ?? undefined,
+        toolIndex,
+        BlockType.WORKFLOW_INPUT
+      )
+      const active = resolveActiveCanonicalValue(
+        WORKFLOW_ID_CANONICAL_GROUP,
+        {
+          workflowId: typeof tool.params.workflowId === 'string' ? tool.params.workflowId : null,
+          manualWorkflowId:
+            typeof tool.params.manualWorkflowId === 'string' ? tool.params.manualWorkflowId : null,
+        },
+        scoped
+      )
+      if (typeof active === 'string' && active) callees.push(active)
+    })
   }
   return callees
 }
@@ -161,7 +182,7 @@ function buildReferenceGraph(
       const sourceId = sourceByCustomType.get(block.type)
       if (sourceId) addEdge(block.parentId, sourceId)
     }
-    for (const calleeId of toolInputCallees(block.toolInputValues)) {
+    for (const calleeId of toolInputCallees(block.toolInputValues, block.canonicalModes)) {
       addEdge(block.parentId, calleeId)
     }
   }