fix: Use document store ID instead of name for referential integrity in agent flows

[naaa760]

Description
This PR fixes a critical bug where renaming a document store breaks existing agent flows that reference it. The issue was caused by storing the document store reference as a hardcoded string containing both ID and name (id:name), which breaks when the name changes.

#4868

Problem

• Agent and Retriever components were storing document store references as ${store.id}:${store.name}
• When users renamed a document store, the stored value in agent flows retained the old name
• The UI couldn't match the stored value with the current list, causing the flow to break
• This affected data integrity and user experience when managing document stores

Solution

• Changed to store only the document store ID for proper referential integrity
• Added backward compatibility to handle both formats:
  • Old format: id:name (splits the string to extract ID)
  • New format: id only (uses ID directly)
• The current name is always fetched from the database when needed
• Display name is shown in the UI while only ID is stored internally

Changes Made

Modified Files:

• Agent.ts

  • Updated listStores method to return only ID in the name field
  • Added backward compatibility in the execute method to handle both old and new formats

• Retriever.ts

  • Applied the same changes as Agent.ts for consistency
  • Handles both formats when extracting knowledge bases

Verified Components:

• DocumentStore component - Already uses correct format (ID only)
• DocumentStoreVS component - Already uses correct format (ID only)

Impact

• Backward Compatible: Existing flows with old format will continue to work
• Forward Compatible**: New flows will use the improved ID-only format
• User Experience**: Users can now safely rename document stores without breaking flows
• Data Integrity: Proper referential integrity maintained using IDs

Testing

• Tested with existing flows using old format - works correctly
• Created new flows with renamed document stores - works correctly
• Verified no compilation errors or linter warnings

[HenryHengZJ]

thanks for the fix!

[HenryHengZJ]

Had a quick test - changing this will cause all users to have empty doc store:

My suggestion is we stick to the original convention

[HenryHengZJ]

Here we can just directly fetch the storeName from database:

const [storeId] = knowledgeBase.documentStore.split(':')
...
const storeName = store?.name || storeId

[naaa760]

let me fix this issues!