diff --git a/src/brainy.ts b/src/brainy.ts index e9cd27ab..482bb669 100644 --- a/src/brainy.ts +++ b/src/brainy.ts @@ -2006,7 +2006,16 @@ export class Brainy implements BrainyInterface { } else if (Array.isArray(params.to)) { targetVector = params.to as Vector } else { - targetVector = (params.to as Entity).vector + // v5.11.1: Entity object passed - check if vectors are loaded + const entityVector = (params.to as Entity).vector + if (!entityVector || entityVector.length === 0) { + throw new Error( + 'Entity passed to brain.similar() has no vector embeddings loaded. ' + + 'Please retrieve the entity with { includeVectors: true } or pass the entity ID instead.\n\n' + + 'Example: brain.similar({ to: entityId }) OR brain.similar({ to: await brain.get(entityId, { includeVectors: true }) })' + ) + } + targetVector = entityVector } // Use find with vector