@pellux/goodvibes-sdk 0.28.8 → 0.28.9

package/dist/_internal/contracts/artifacts/operator-contract.json

@@ -3,7 +3,7 @@
   "product": {
     "id": "goodvibes",
     "surface": "operator",
-    "version": "0.28.8"
+    "version": "0.28.9"
   },
   "auth": {
     "modes": [

package/dist/_internal/contracts/generated/foundation-metadata.d.ts

@@ -1,6 +1,6 @@
 export declare const FOUNDATION_METADATA: {
     readonly productId: "goodvibes";
-    readonly productVersion: "0.28.8";
+    readonly productVersion: "0.28.9";
     readonly operatorMethodCount: 264;
     readonly operatorEventCount: 30;
     readonly peerEndpointCount: 6;

package/dist/_internal/contracts/generated/foundation-metadata.js

@@ -1,7 +1,7 @@
 // Synced from packages/contracts/src/generated/foundation-metadata.ts
 export const FOUNDATION_METADATA = {
     "productId": "goodvibes",
-    "productVersion": "0.28.8",
+    "productVersion": "0.28.9",
     "operatorMethodCount": 264,
     "operatorEventCount": 30,
     "peerEndpointCount": 6

package/dist/_internal/contracts/generated/operator-contract.js

@@ -3,7 +3,7 @@ export const OPERATOR_CONTRACT = {
     "product": {
         "id": "goodvibes",
         "surface": "operator",
-        "version": "0.28.8"
+        "version": "0.28.9"
     },
     "auth": {
         "modes": [

package/dist/_internal/platform/knowledge/home-graph/search-utils.d.ts

@@ -0,0 +1,3 @@
+export declare function intersects(left: ReadonlySet<string>, right: ReadonlySet<string>): boolean;
+export declare function isSingularObjectQuery(query: string, tokens: readonly string[]): boolean;
+//# sourceMappingURL=search-utils.d.ts.map

package/dist/_internal/platform/knowledge/home-graph/search-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-utils.d.ts","sourceRoot":"","sources":["../../../../../src/_internal/platform/knowledge/home-graph/search-utils.ts"],"names":[],"mappings":"AAAA,wBAAgB,UAAU,CAAC,IAAI,EAAE,WAAW,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,WAAW,CAAC,MAAM,CAAC,GAAG,OAAO,CAKzF;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAOvF"}

package/dist/_internal/platform/knowledge/home-graph/search-utils.js

@@ -0,0 +1,16 @@
+export function intersects(left, right) {
+    for (const value of left) {
+        if (right.has(value))
+            return true;
+    }
+    return false;
+}
+export function isSingularObjectQuery(query, tokens) {
+    const normalized = query.toLowerCase();
+    if (/\b(the|this|that|my)\s+(tv|television|device|sensor|switch|camera|printer|router|phone)\b/.test(normalized))
+        return true;
+    if (tokens.includes('tv') || tokens.includes('television')) {
+        return !tokens.includes('tvs') && !tokens.includes('televisions');
+    }
+    return false;
+}

package/dist/_internal/platform/knowledge/home-graph/search.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../../../../src/_internal/platform/knowledge/home-graph/search.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,KAAK,EACV,mBAAmB,EACnB,yBAAyB,EACzB,mBAAmB,EACnB,qBAAqB,EACtB,MAAM,aAAa,CAAC;AAGrB,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAoIxD,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,SAAS,qBAAqB,EAAE,CAAC;IACnD,QAAQ,CAAC,KAAK,EAAE,SAAS,mBAAmB,EAAE,CAAC;IAC/C,QAAQ,CAAC,KAAK,EAAE,SAAS,mBAAmB,EAAE,CAAC;IAC/C,QAAQ,CAAC,oBAAoB,EAAE,WAAW,CAAC,MAAM,EAAE,yBAAyB,CAAC,CAAC;CAC/E;AAED,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,GAAG,oBAAoB,CAuBrG;AAED,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,SAAS,qBAAqB,EAAE,EACzC,KAAK,EAAE,SAAS,mBAAmB,EAAE,EACrC,KAAK,EAAE,SAAS,mBAAmB,EAAE,EACrC,oBAAoB,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,yBAAyB,GAAG,IAAI,GAAG,SAAS,EACxF,KAAK,EAAE,MAAM,GACZ,qBAAqB,EAAE,CAoFzB;AAED,wBAAgB,yCAAyC,CACvD,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,SAAS,qBAAqB,EAAE,EACzC,KAAK,EAAE,SAAS,mBAAmB,EAAE,EACrC,KAAK,EAAE,SAAS,mBAAmB,EAAE,EACrC,oBAAoB,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,yBAAyB,GAAG,IAAI,GAAG,SAAS,EACxF,KAAK,EAAE,MAAM,GACZ,qBAAqB,EAAE,CAoCzB;AAmND,wBAAgB,8BAA8B,CAAC,UAAU,EAAE,yBAAyB,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,CAWhH"}
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../../../../src/_internal/platform/knowledge/home-graph/search.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,KAAK,EACV,mBAAmB,EACnB,yBAAyB,EACzB,mBAAmB,EACnB,qBAAqB,EACtB,MAAM,aAAa,CAAC;AAIrB,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAsIxD,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,SAAS,qBAAqB,EAAE,CAAC;IACnD,QAAQ,CAAC,KAAK,EAAE,SAAS,mBAAmB,EAAE,CAAC;IAC/C,QAAQ,CAAC,KAAK,EAAE,SAAS,mBAAmB,EAAE,CAAC;IAC/C,QAAQ,CAAC,oBAAoB,EAAE,WAAW,CAAC,MAAM,EAAE,yBAAyB,CAAC,CAAC;CAC/E;AAED,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,GAAG,oBAAoB,CAuBrG;AAED,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,SAAS,qBAAqB,EAAE,EACzC,KAAK,EAAE,SAAS,mBAAmB,EAAE,EACrC,KAAK,EAAE,SAAS,mBAAmB,EAAE,EACrC,oBAAoB,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,yBAAyB,GAAG,IAAI,GAAG,SAAS,EACxF,KAAK,EAAE,MAAM,GACZ,qBAAqB,EAAE,CAoFzB;AAED,wBAAgB,yCAAyC,CACvD,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,SAAS,qBAAqB,EAAE,EACzC,KAAK,EAAE,SAAS,mBAAmB,EAAE,EACrC,KAAK,EAAE,SAAS,mBAAmB,EAAE,EACrC,oBAAoB,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,yBAAyB,GAAG,IAAI,GAAG,SAAS,EACxF,KAAK,EAAE,MAAM,GACZ,qBAAqB,EAAE,CAoCzB;AAmND,wBAAgB,8BAA8B,CAAC,UAAU,EAAE,yBAAyB,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,CAWhH"}

package/dist/_internal/platform/knowledge/home-graph/search.js

@@ -1,5 +1,6 @@
 import { belongsToSpace, edgeIsActive, isGeneratedPageSource, readRecord } from './helpers.js';
 import { isUnusableHomeGraphExtractionText } from './extraction-quality.js';
+import { intersects, isSingularObjectQuery } from './search-utils.js';
 const MAX_FIELD_CHARS = 4_096;
 const MAX_SECTION_COUNT = 32;
 const MAX_SEARCH_TEXT_CHARS = 64 * 1024;
@@ -66,6 +67,8 @@ const GENERIC_ANCHOR_TOKENS = new Set([
     'smart',
     'storage',
     'switch',
+    'television',
+    'tv',
 ]);
 const QUERY_EXPANSIONS = {
     capability: ['capabilities', 'feature', 'features', 'function', 'functions', 'mode', 'modes', 'spec', 'specs', 'support', 'supports'],
@@ -149,7 +152,7 @@ export function scoreHomeGraphResults(query, sources, nodes, edges, extractionBy
     const expandedTokens = expandTokens(tokens);
     const anchorTokens = selectAnchorQueryTokens(tokens);
     const anchors = selectAnchorNodes(anchorTokens, nodes);
-    const sourceAnchors = selectSourceAnchors(anchorTokens, anchors.map((anchor) => anchor.node));
+    const sourceAnchors = selectSourceAnchors(anchorTokens, anchors.map((anchor) => anchor.node), isSingularObjectQuery(query, tokens));
     const anchorIds = new Set(sourceAnchors.map((node) => node.id));
     const anchorIdentityTokens = collectAnchorIdentityTokens(sourceAnchors);
     const sourceLinks = buildSourceLinkIndex(edges);
@@ -234,7 +237,7 @@ export function selectHomeGraphExtractionRepairCandidates(query, sources, nodes,
     if (tokens.length === 0)
         return [];
     const anchors = selectAnchorNodes(tokens, nodes);
-    const sourceAnchors = selectSourceAnchors(tokens, anchors.map((anchor) => anchor.node));
+    const sourceAnchors = selectSourceAnchors(tokens, anchors.map((anchor) => anchor.node), isSingularObjectQuery(query, tokens));
     const anchorIds = new Set(sourceAnchors.map((anchor) => anchor.id));
     const anchorIdentityTokens = collectAnchorIdentityTokens(sourceAnchors);
     const sourceLinks = buildSourceLinkIndex(edges);
@@ -351,7 +354,7 @@ function sourceAnchorIdentityScore(anchorTokens, source, extraction) {
 function selectAnchorNodes(tokens, nodes) {
     if (tokens.length === 0)
         return [];
-    return nodes.map((node) => {
+    const scored = nodes.map((node) => {
         if (!isHomeGraphAnchorNode(node))
             return { node, score: 0 };
         const baseScore = scoreFields(tokens, nodeIdentityFields(node));
@@ -362,7 +365,10 @@ function selectAnchorNodes(tokens, nodes) {
         };
     })
         .filter((entry) => entry.score >= 10)
-        .sort((a, b) => b.score - a.score || a.node.id.localeCompare(b.node.id))
+        .sort((a, b) => b.score - a.score || a.node.id.localeCompare(b.node.id));
+    const topScore = scored[0]?.score ?? 0;
+    return scored
+        .filter((entry) => entry.score >= Math.max(10, topScore - 12))
         .slice(0, 12);
 }
 function selectAnchorQueryTokens(tokens) {
@@ -373,10 +379,10 @@ function isHomeGraphAnchorNode(node) {
         return false;
     return HOME_GRAPH_ANCHOR_KINDS.has(node.kind);
 }
-function selectSourceAnchors(tokens, nodes) {
+function selectSourceAnchors(tokens, nodes, singularObjectQuery = false) {
     const preferred = nodes.filter((node) => sourceAnchorIntentBoost(tokens, node) >= 0);
     if (preferred.length > 0)
-        return preferred.slice(0, 8);
+        return preferred.slice(0, singularObjectQuery ? 1 : ANCHOR_SCOPE_LIMIT);
     return nodes.slice(0, ANCHOR_SCOPE_LIMIT);
 }
 function sourceAnchorIntentBoost(tokens, node) {
@@ -456,13 +462,6 @@ function nodeKindBoost(kind) {
             return 0;
     }
 }
-function intersects(left, right) {
-    for (const value of left) {
-        if (right.has(value))
-            return true;
-    }
-    return false;
-}
 function isPendingDocumentationCandidate(source, extraction) {
     return !extraction
         && source.status !== 'indexed'

package/dist/_internal/platform/knowledge/semantic/answer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"answer.d.ts","sourceRoot":"","sources":["../../../../../src/_internal/platform/knowledge/semantic/answer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAYlD,OAAO,KAAK,EACV,4BAA4B,EAC5B,6BAA6B,EAE7B,oBAAoB,EAErB,MAAM,YAAY,CAAC;AAsBpB,UAAU,sBAAsB;IAC9B,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC;IAC/B,QAAQ,CAAC,GAAG,CAAC,EAAE,oBAAoB,GAAG,IAAI,CAAC;CAC5C;AAsCD,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,sBAAsB,EAC/B,KAAK,EAAE,4BAA4B,GAClC,OAAO,CAAC,6BAA6B,CAAC,CA+DxC"}
+{"version":3,"file":"answer.d.ts","sourceRoot":"","sources":["../../../../../src/_internal/platform/knowledge/semantic/answer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAYlD,OAAO,KAAK,EACV,4BAA4B,EAC5B,6BAA6B,EAE7B,oBAAoB,EAErB,MAAM,YAAY,CAAC;AA2BpB,UAAU,sBAAsB;IAC9B,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC;IAC/B,QAAQ,CAAC,GAAG,CAAC,EAAE,oBAAoB,GAAG,IAAI,CAAC;CAC5C;AAsCD,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,sBAAsB,EAC/B,KAAK,EAAE,4BAA4B,GAClC,OAAO,CAAC,6BAA6B,CAAC,CA+DxC"}

package/dist/_internal/platform/knowledge/semantic/answer.js

@@ -1,6 +1,7 @@
 import { getKnowledgeSpaceId, isHomeAssistantKnowledgeSpace, isInKnowledgeSpace, normalizeKnowledgeSpaceId, } from '../spaces.js';
 import { MAX_ANSWER_EVIDENCE_CHARS, clampText, normalizeWhitespace, readRecord, readString, scoreSemanticText, semanticHash, semanticMetadata, sourceSemanticText, splitSentences, tokenizeSemanticQuery, uniqueStrings, } from './utils.js';
 import { hasConcreteFeatureSignal, isLowValueFeatureOrSpecText, isSemanticAnswerLinkedObject, semanticFactText, } from './fact-quality.js';
+import { inferHomeAssistantAnswerScope, nodeInHomeAssistantAnswerScope, sourceInHomeAssistantAnswerScope, } from './homeassistant-scope.js';
 const GENERIC_ANSWER_INTENT_TOKENS = new Set([
     'capabilities',
     'capability',
@@ -97,8 +98,12 @@ function collectAnswerEvidence(store, input, spaceId, limit) {
     const sourceFacts = buildSourceFactIndex(store, spaceId);
     const linkedSourceIds = sourceIdsLinkedToNodes(store, new Set([...candidateNodeIds, ...linkedObjectIds]), spaceId);
     const broadHomeAssistantAlias = normalizeKnowledgeSpaceId(spaceId) === 'homeassistant' && !strictCandidates;
+    const homeAssistantScope = !strictCandidates
+        ? inferHomeAssistantAnswerScope(store, spaceId, input.query, subjectTokens)
+        : null;
     const sourceItems = store.listSources(10_000)
         .filter((source) => belongsToAnswerSpace(source, spaceId))
+        .filter((source) => sourceInHomeAssistantAnswerScope(store, source, homeAssistantScope))
         .filter((source) => !strictCandidates || candidateSourceIds.has(source.id) || (candidateSourceIds.size === 0 && linkedSourceIds.has(source.id)))
         .map((source) => {
         const extraction = store.getExtractionBySourceId(source.id);
@@ -139,6 +144,7 @@ function collectAnswerEvidence(store, input, spaceId, limit) {
     });
     const nodeItems = store.listNodes(10_000)
         .filter((node) => belongsToAnswerSpace(node, spaceId) && node.status !== 'stale')
+        .filter((node) => nodeInHomeAssistantAnswerScope(node, homeAssistantScope))
         .filter((node) => !strictCandidates
         || candidateNodeIds.has(node.id)
         || linkedObjectIds.has(node.id)

package/dist/_internal/platform/knowledge/semantic/homeassistant-scope.d.ts

@@ -0,0 +1,11 @@
+import type { KnowledgeStore } from '../store.js';
+import type { KnowledgeNodeRecord, KnowledgeSourceRecord } from '../types.js';
+export interface HomeAssistantAnswerScope {
+    readonly anchorNodeIds: ReadonlySet<string>;
+    readonly linkedSourceIds: ReadonlySet<string>;
+    readonly anchorText: readonly string[];
+}
+export declare function inferHomeAssistantAnswerScope(store: KnowledgeStore, spaceId: string, query: string, subjectTokens: readonly string[]): HomeAssistantAnswerScope | null;
+export declare function sourceInHomeAssistantAnswerScope(store: KnowledgeStore, source: KnowledgeSourceRecord, scope: HomeAssistantAnswerScope | null): boolean;
+export declare function nodeInHomeAssistantAnswerScope(node: KnowledgeNodeRecord, scope: HomeAssistantAnswerScope | null): boolean;
+//# sourceMappingURL=homeassistant-scope.d.ts.map

package/dist/_internal/platform/knowledge/semantic/homeassistant-scope.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"homeassistant-scope.d.ts","sourceRoot":"","sources":["../../../../../src/_internal/platform/knowledge/semantic/homeassistant-scope.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,KAAK,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAI9E,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,aAAa,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAC5C,QAAQ,CAAC,eAAe,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAC9C,QAAQ,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;CACxC;AAED,wBAAgB,6BAA6B,CAC3C,KAAK,EAAE,cAAc,EACrB,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,EACb,aAAa,EAAE,SAAS,MAAM,EAAE,GAC/B,wBAAwB,GAAG,IAAI,CA6BjC;AAED,wBAAgB,gCAAgC,CAC9C,KAAK,EAAE,cAAc,EACrB,MAAM,EAAE,qBAAqB,EAC7B,KAAK,EAAE,wBAAwB,GAAG,IAAI,GACrC,OAAO,CAMT;AAED,wBAAgB,8BAA8B,CAC5C,IAAI,EAAE,mBAAmB,EACzB,KAAK,EAAE,wBAAwB,GAAG,IAAI,GACrC,OAAO,CAKT"}

package/dist/_internal/platform/knowledge/semantic/homeassistant-scope.js

@@ -0,0 +1,179 @@
+import { getKnowledgeSpaceId, isHomeAssistantKnowledgeSpace, normalizeKnowledgeSpaceId } from '../spaces.js';
+import { readRecord, readString, scoreSemanticText, sourceSemanticText } from './utils.js';
+export function inferHomeAssistantAnswerScope(store, spaceId, query, subjectTokens) {
+    const normalized = normalizeKnowledgeSpaceId(spaceId);
+    if (normalized !== 'homeassistant' && !isHomeAssistantKnowledgeSpace(normalized))
+        return null;
+    if (subjectTokens.length === 0)
+        return null;
+    const singularObjectQuery = isSingularObjectQuery(query, subjectTokens);
+    const strongIdentityTokens = subjectTokens.filter(isStrongIdentityToken);
+    if (!singularObjectQuery && strongIdentityTokens.length === 0)
+        return null;
+    const linkedSourceCountByNode = linkedSourceCountsByAnchor(store);
+    const anchors = store.listNodes(10_000)
+        .filter((node) => node.status !== 'stale' && isHomeAssistantObjectNode(node))
+        .filter((node) => normalized === 'homeassistant' || normalizeKnowledgeSpaceId(getKnowledgeSpaceId(node)) === normalized)
+        .map((node) => ({
+        node,
+        score: scoreHomeAssistantObject(node, subjectTokens)
+            + Math.min(24, (linkedSourceCountByNode.get(node.id) ?? 0) * 8),
+    }))
+        .filter((entry) => entry.score > 0)
+        .sort((left, right) => right.score - left.score || left.node.id.localeCompare(right.node.id));
+    const topScore = anchors[0]?.score ?? 0;
+    if (topScore <= 0)
+        return null;
+    const selectedAnchors = anchors
+        .filter((entry) => entry.score >= Math.max(1, topScore - 12))
+        .slice(0, singularObjectQuery ? 1 : 8);
+    const anchorNodeIds = new Set(selectedAnchors.map((entry) => entry.node.id));
+    const linkedSourceIds = sourceIdsLinkedToAnchors(store, anchorNodeIds);
+    const anchorText = selectedAnchors.map((entry) => homeAssistantObjectText(entry.node));
+    return { anchorNodeIds, linkedSourceIds, anchorText };
+}
+export function sourceInHomeAssistantAnswerScope(store, source, scope) {
+    if (!scope || scope.anchorNodeIds.size === 0)
+        return true;
+    if (scope.linkedSourceIds.has(source.id))
+        return true;
+    const extraction = store.getExtractionBySourceId(source.id);
+    const text = sourceSemanticText(source, extraction);
+    return scope.anchorText.some((anchor) => sourceMatchesAnchor(text, anchor));
+}
+export function nodeInHomeAssistantAnswerScope(node, scope) {
+    if (!scope || scope.anchorNodeIds.size === 0)
+        return true;
+    if (scope.anchorNodeIds.has(node.id))
+        return true;
+    const sourceId = readString(node.metadata.sourceId) ?? node.sourceId;
+    return Boolean(sourceId && scope.linkedSourceIds.has(sourceId));
+}
+function sourceIdsLinkedToAnchors(store, anchorNodeIds) {
+    const sourceIds = new Set();
+    if (anchorNodeIds.size === 0)
+        return sourceIds;
+    for (const edge of store.listEdges()) {
+        if (edge.fromKind === 'source' && edge.toKind === 'node' && anchorNodeIds.has(edge.toId))
+            sourceIds.add(edge.fromId);
+        if (edge.fromKind === 'node' && anchorNodeIds.has(edge.fromId) && edge.toKind === 'source')
+            sourceIds.add(edge.toId);
+    }
+    return sourceIds;
+}
+function linkedSourceCountsByAnchor(store) {
+    const counts = new Map();
+    for (const edge of store.listEdges()) {
+        if (edge.fromKind === 'source' && edge.toKind === 'node') {
+            counts.set(edge.toId, (counts.get(edge.toId) ?? 0) + 1);
+        }
+        else if (edge.fromKind === 'node' && edge.toKind === 'source') {
+            counts.set(edge.fromId, (counts.get(edge.fromId) ?? 0) + 1);
+        }
+    }
+    return counts;
+}
+function isHomeAssistantObjectNode(node) {
+    return node.kind === 'ha_device'
+        || node.kind === 'ha_entity'
+        || node.kind === 'ha_area'
+        || node.kind === 'ha_integration'
+        || node.kind === 'ha_automation'
+        || node.kind === 'ha_script'
+        || node.kind === 'ha_scene';
+}
+function scoreHomeAssistantObject(node, tokens) {
+    const metadata = readRecord(node.metadata);
+    const homeAssistant = readRecord(metadata.homeAssistant);
+    const text = homeAssistantObjectText(node);
+    const baseScore = scoreSemanticText(text, tokens);
+    const domain = (readString(metadata.domain) ?? readString(homeAssistant.domain) ?? '').toLowerCase();
+    const platform = (readString(metadata.platform) ?? readString(homeAssistant.integrationDomain) ?? '').toLowerCase();
+    const tvQuery = tokens.some((token) => token === 'tv' || token === 'television');
+    if (tvQuery) {
+        const lower = text.toLowerCase();
+        if (node.kind === 'ha_device' && /\b(tv|television|webos|bravia|roku)\b/.test(lower))
+            return baseScore + 80;
+        if (node.kind === 'ha_entity' && (domain === 'media_player' || platform === 'webostv'))
+            return baseScore + 70;
+        if (node.kind === 'ha_integration' && (platform === 'webostv' || lower.includes('webos')))
+            return baseScore + 30;
+        if (node.kind === 'ha_automation' || domain === 'sensor' || domain === 'switch')
+            return Math.max(0, baseScore - 40);
+    }
+    return baseScore;
+}
+function homeAssistantObjectText(node) {
+    const homeAssistant = readRecord(node.metadata.homeAssistant);
+    return [
+        node.title,
+        node.summary,
+        node.aliases.join(' '),
+        readString(node.metadata.manufacturer),
+        readString(node.metadata.model),
+        readString(homeAssistant.objectKind),
+        readString(homeAssistant.objectId),
+        readString(homeAssistant.entityId),
+        readString(homeAssistant.domain),
+        readString(homeAssistant.deviceClass),
+        readString(homeAssistant.integrationDomain),
+    ].filter(Boolean).join('\n');
+}
+function isSingularObjectQuery(query, tokens) {
+    const normalized = query.toLowerCase();
+    if (/\b(the|this|that|my)\s+(tv|television|device|sensor|switch|camera|printer|router|phone|object|thing)\b/.test(normalized)) {
+        return true;
+    }
+    if (tokens.includes('tv') || tokens.includes('television')) {
+        return !tokens.includes('tvs') && !tokens.includes('televisions');
+    }
+    return false;
+}
+function isStrongIdentityToken(token) {
+    return token.length >= 4 && !GENERIC_ANCHOR_TOKENS.has(token);
+}
+function sourceMatchesAnchor(sourceText, anchorText) {
+    const tokens = anchorText
+        .toLowerCase()
+        .split(/[^a-z0-9_.:-]+/)
+        .filter((token) => token.length >= 4 && !GENERIC_ANCHOR_TOKENS.has(token));
+    if (tokens.length === 0)
+        return false;
+    return scoreSemanticText(sourceText, tokens) >= Math.min(24, tokens.length * 12);
+}
+const GENERIC_ANCHOR_TOKENS = new Set([
+    'audio',
+    'available',
+    'capabilities',
+    'capability',
+    'configuration',
+    'device',
+    'entity',
+    'feature',
+    'features',
+    'format',
+    'formats',
+    'gaming',
+    'have',
+    'hdmi',
+    'hdr',
+    'home',
+    'assistant',
+    'integration',
+    'network',
+    'port',
+    'ports',
+    'rate',
+    'refresh',
+    'sensor',
+    'smart',
+    'spec',
+    'specification',
+    'specifications',
+    'switch',
+    'support',
+    'supported',
+    'supports',
+    'television',
+    'tv',
+]);

package/dist/_internal/platform/version.js

@@ -1,6 +1,6 @@
 import { readFileSync } from 'node:fs';
 import { join } from 'node:path';
-let version = '0.28.8';
+let version = '0.28.9';
 try {
     const pkg = JSON.parse(readFileSync(join(import.meta.dir, '..', '..', 'package.json'), 'utf-8'));
     version = pkg.version ?? version;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pellux/goodvibes-sdk",
-  "version": "0.28.8",
+  "version": "0.28.9",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/mgd34msu/goodvibes-sdk.git"