@pellux/goodvibes-sdk 0.27.6 → 0.27.8

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

@@ -3,7 +3,7 @@
   "product": {
     "id": "goodvibes",
     "surface": "operator",
-    "version": "0.27.6"
+    "version": "0.27.8"
   },
   "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.27.6";
+    readonly productVersion: "0.27.8";
     readonly operatorMethodCount: 256;
     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.27.6",
+    "productVersion": "0.27.8",
     "operatorMethodCount": 256,
     "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.27.6"
+        "version": "0.27.8"
     },
     "auth": {
         "modes": [

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

@@ -3,10 +3,10 @@ export async function answerHomeGraphQuery(input) {
     const sources = input.results.flatMap((result) => result.source ? [result.source] : []);
     const linkedObjects = collectLinkedObjects(input.results, input.state);
     if (input.semanticService) {
-        await input.semanticService.enrichSources(uniqueSources(sources), {
+        void input.semanticService.enrichSources(uniqueSources(sources), {
             knowledgeSpaceId: input.spaceId,
             limit: Math.min(3, Math.max(1, sources.length)),
-        });
+        }).catch(() => { });
         const answer = await input.semanticService.answer({
             query: input.query.query,
             knowledgeSpaceId: input.spaceId,

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

@@ -1 +1 @@
-{"version":3,"file":"generated-pages.d.ts","sourceRoot":"","sources":["../../../../../src/_internal/platform/knowledge/home-graph/generated-pages.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAK9D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AA8BlD,OAAO,KAAK,EACV,6BAA6B,EAC7B,8BAA8B,EAC9B,wBAAwB,EACxB,yBAAyB,EACzB,sBAAsB,EACvB,MAAM,YAAY,CAAC;AAEpB,UAAU,oBAAoB;IAC5B,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC;IAC/B,QAAQ,CAAC,aAAa,EAAE,aAAa,CAAC;IACtC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;CACjC;AAED,wBAAsB,+BAA+B,CACnD,OAAO,EAAE,oBAAoB,GAAG;IAAE,QAAQ,CAAC,KAAK,EAAE,sBAAsB,CAAA;CAAE,GACzE,OAAO,CAAC,8BAA8B,CAAC,CAEzC;AAED,wBAAsB,8BAA8B,CAClD,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,8BAA8B,CAAC,CAEzC;AA2ED,wBAAsB,8BAA8B,CAClD,OAAO,EAAE,oBAAoB,GAAG;IAAE,QAAQ,CAAC,KAAK,EAAE,wBAAwB,CAAA;CAAE,GAC3E,OAAO,CAAC,6BAA6B,GAAG;IAAE,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAA;CAAE,CAAC,CA2EhF;AAED,wBAAsB,yBAAyB,CAC7C,OAAO,EAAE,oBAAoB,GAAG;IAAE,QAAQ,CAAC,KAAK,EAAE,wBAAwB,CAAA;CAAE,GAC3E,OAAO,CAAC,yBAAyB,GAAG;IAAE,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAA;CAAE,CAAC,CAsC5E;AAED,wBAAsB,uBAAuB,CAC3C,OAAO,EAAE,oBAAoB,GAAG;IAAE,QAAQ,CAAC,KAAK,EAAE,wBAAwB,CAAA;CAAE,GAC3E,OAAO,CAAC,yBAAyB,GAAG;IAAE,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAA;CAAE,CAAC,CAyB5E"}
+{"version":3,"file":"generated-pages.d.ts","sourceRoot":"","sources":["../../../../../src/_internal/platform/knowledge/home-graph/generated-pages.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAK9D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AA+BlD,OAAO,KAAK,EACV,6BAA6B,EAC7B,8BAA8B,EAC9B,wBAAwB,EACxB,yBAAyB,EACzB,sBAAsB,EACvB,MAAM,YAAY,CAAC;AAEpB,UAAU,oBAAoB;IAC5B,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC;IAC/B,QAAQ,CAAC,aAAa,EAAE,aAAa,CAAC;IACtC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;CACjC;AAED,wBAAsB,+BAA+B,CACnD,OAAO,EAAE,oBAAoB,GAAG;IAAE,QAAQ,CAAC,KAAK,EAAE,sBAAsB,CAAA;CAAE,GACzE,OAAO,CAAC,8BAA8B,CAAC,CAEzC;AAED,wBAAsB,8BAA8B,CAClD,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,8BAA8B,CAAC,CAEzC;AA2ED,wBAAsB,8BAA8B,CAClD,OAAO,EAAE,oBAAoB,GAAG;IAAE,QAAQ,CAAC,KAAK,EAAE,wBAAwB,CAAA;CAAE,GAC3E,OAAO,CAAC,6BAA6B,GAAG;IAAE,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAA;CAAE,CAAC,CA2EhF;AAED,wBAAsB,yBAAyB,CAC7C,OAAO,EAAE,oBAAoB,GAAG;IAAE,QAAQ,CAAC,KAAK,EAAE,wBAAwB,CAAA;CAAE,GAC3E,OAAO,CAAC,yBAAyB,GAAG;IAAE,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAA;CAAE,CAAC,CAsC5E;AAED,wBAAsB,uBAAuB,CAC3C,OAAO,EAAE,oBAAoB,GAAG;IAAE,QAAQ,CAAC,KAAK,EAAE,wBAAwB,CAAA;CAAE,GAC3E,OAAO,CAAC,yBAAyB,GAAG;IAAE,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAA;CAAE,CAAC,CAyB5E"}

package/dist/_internal/platform/knowledge/home-graph/generated-pages.js

@@ -2,6 +2,7 @@ import { materializeGeneratedKnowledgeProjection, } from '../generated-projectio
 import { HOME_GRAPH_CONNECTOR_ID, buildHomeGraphMetadata, edgeIsActive, homeGraphNodeId, homeGraphSourceId, isGeneratedPageSource, namespacedCanonicalUri, readRecord, uniqueStrings, } from './helpers.js';
 import { findHomeAssistantNode, missingDevicePassportFields, readHomeGraphState, renderHomeGraphState, safeHomeGraphFilename, sourcesLinkedToNode, } from './state.js';
 import { renderDevicePassportPage, renderPacketPage, renderRoomPage, } from './rendering.js';
+import { isUsefulHomeGraphPageFact } from '../semantic/fact-quality.js';
 export async function generateAutomaticHomeGraphPages(context) {
     return generateHomeGraphPagesForCurrentState(context, context.input.pageAutomation ?? {});
 }
@@ -286,7 +287,7 @@ function semanticFactsLinkedToSources(sources, nodes, edges) {
         && sourceIds.has(edge.fromId)
         && edge.toKind === 'node'
         && edge.relation === 'supports_fact')).map((edge) => edge.toId));
-    return nodes.filter((node) => factIds.has(node.id));
+    return nodes.filter((node) => factIds.has(node.id) && isUsefulHomeGraphPageFact(node));
 }
 function limitRecords(records, limit) {
     if (typeof limit !== 'number')

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

@@ -1 +1 @@
-{"version":3,"file":"rendering.d.ts","sourceRoot":"","sources":["../../../../../src/_internal/platform/knowledge/home-graph/rendering.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,mBAAmB,EACnB,yBAAyB,EACzB,oBAAoB,EAEpB,mBAAmB,EACnB,qBAAqB,EACtB,MAAM,aAAa,CAAC;AAKrB,OAAO,KAAK,EAA6B,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAEnG,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,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,MAAM,EAAE,SAAS,oBAAoB,EAAE,CAAC;IACjD,QAAQ,CAAC,WAAW,CAAC,EAAE,SAAS,yBAAyB,EAAE,CAAC;CAC7D;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,oBAAoB,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAmDnF;AAED,wBAAgB,wBAAwB,CAAC,KAAK,EAAE;IAC9C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,mBAAmB,CAAC;IACrC,QAAQ,CAAC,QAAQ,EAAE,SAAS,mBAAmB,EAAE,CAAC;IAClD,QAAQ,CAAC,OAAO,EAAE,SAAS,qBAAqB,EAAE,CAAC;IACnD,QAAQ,CAAC,WAAW,CAAC,EAAE,SAAS,yBAAyB,EAAE,CAAC;IAC5D,QAAQ,CAAC,MAAM,EAAE,SAAS,oBAAoB,EAAE,CAAC;IACjD,QAAQ,CAAC,aAAa,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1C,QAAQ,CAAC,aAAa,CAAC,EAAE,SAAS,mBAAmB,EAAE,CAAC;CACzD,GAAG,MAAM,CA+BT;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,oBAAoB,EAAE,OAAO,GAAE;IACrE,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,aAAa,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC3C,QAAQ,CAAC,aAAa,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACvC,GAAG,MAAM,CAkBd;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,oBAAoB,EAAE,OAAO,GAAE,iBAAsB,GAAG,kBAAkB,CAcnH"}
+{"version":3,"file":"rendering.d.ts","sourceRoot":"","sources":["../../../../../src/_internal/platform/knowledge/home-graph/rendering.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,mBAAmB,EACnB,yBAAyB,EACzB,oBAAoB,EAEpB,mBAAmB,EACnB,qBAAqB,EACtB,MAAM,aAAa,CAAC;AAKrB,OAAO,KAAK,EAA6B,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAGnG,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,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,MAAM,EAAE,SAAS,oBAAoB,EAAE,CAAC;IACjD,QAAQ,CAAC,WAAW,CAAC,EAAE,SAAS,yBAAyB,EAAE,CAAC;CAC7D;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,oBAAoB,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAmDnF;AAED,wBAAgB,wBAAwB,CAAC,KAAK,EAAE;IAC9C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,mBAAmB,CAAC;IACrC,QAAQ,CAAC,QAAQ,EAAE,SAAS,mBAAmB,EAAE,CAAC;IAClD,QAAQ,CAAC,OAAO,EAAE,SAAS,qBAAqB,EAAE,CAAC;IACnD,QAAQ,CAAC,WAAW,CAAC,EAAE,SAAS,yBAAyB,EAAE,CAAC;IAC5D,QAAQ,CAAC,MAAM,EAAE,SAAS,oBAAoB,EAAE,CAAC;IACjD,QAAQ,CAAC,aAAa,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1C,QAAQ,CAAC,aAAa,CAAC,EAAE,SAAS,mBAAmB,EAAE,CAAC;CACzD,GAAG,MAAM,CA+BT;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,oBAAoB,EAAE,OAAO,GAAE;IACrE,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,aAAa,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC3C,QAAQ,CAAC,aAAa,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACvC,GAAG,MAAM,CAkBd;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,oBAAoB,EAAE,OAAO,GAAE,iBAAsB,GAAG,kBAAkB,CAcnH"}

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

@@ -2,6 +2,7 @@ import { renderKnowledgeMap } from '../map.js';
 import { countFacet, normalizeStringArray, readString } from '../map-filters.js';
 import { isUnusableHomeGraphExtractionText } from './extraction-quality.js';
 import { edgeIsActive, isGeneratedPageSource, readRecord, uniqueStrings } from './helpers.js';
+import { isLowValueFeatureOrSpecText, isUsefulHomeGraphPageFact } from '../semantic/fact-quality.js';
 export function renderRoomPage(state, areaId) {
     const area = areaId
         ? findNodeByHaId(state.nodes, 'ha_area', areaId) ?? findNodeByHaId(state.nodes, 'ha_room', areaId)
@@ -295,7 +296,7 @@ function sourceEvidenceSnippets(source, extraction, tokens, limit) {
         ...featureSentences(searchText),
         source.summary,
         source.description,
-    ]).filter((entry) => !isUnusableHomeGraphExtractionText(entry)).slice(0, 80);
+    ]).filter((entry) => !isUnusableHomeGraphExtractionText(entry) && !isLowValueFeatureOrSpecText(entry)).slice(0, 80);
     const scored = candidates
         .map((text) => ({ text: clampEvidence(text), score: evidenceScore(text, tokens) }))
         .filter((entry) => entry.text.length > 0)
@@ -327,7 +328,7 @@ function featureSentences(value) {
     const keywords = /\b(feature|features|support|supports|capability|capabilities|specification|specifications|mode|modes|hdmi|hdr|dolby|battery|reset|warranty|firmware|voice|remote)\b/i;
     return (text.match(/[^.!?\n]+[.!?]?/g) ?? [])
         .map((entry) => entry.trim())
-        .filter((entry) => keywords.test(entry))
+        .filter((entry) => keywords.test(entry) && !isLowValueFeatureOrSpecText(entry))
         .slice(0, 24);
 }
 function evidenceScore(value, tokens) {
@@ -390,7 +391,7 @@ function renderSourceList(title, sources) {
 }
 function renderSemanticFacts(title, facts) {
     const entries = facts
-        .filter((node) => node.metadata.semanticKind === 'fact')
+        .filter(isUsefulHomeGraphPageFact)
         .sort((left, right) => semanticFactSortKey(left).localeCompare(semanticFactSortKey(right)) || left.title.localeCompare(right.title))
         .slice(0, 80);
     if (entries.length === 0)
@@ -423,7 +424,7 @@ function semanticFactsLinkedToSources(sources, nodes, edges) {
         && sourceIds.has(edge.fromId)
         && edge.toKind === 'node'
         && edge.relation === 'supports_fact')).map((edge) => edge.toId));
-    return nodes.filter((node) => factIds.has(node.id));
+    return nodes.filter((node) => factIds.has(node.id) && isUsefulHomeGraphPageFact(node));
 }
 function semanticFactSortKey(node) {
     const order = {

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;AAOlD,OAAO,KAAK,EACV,4BAA4B,EAC5B,6BAA6B,EAE7B,oBAAoB,EAErB,MAAM,YAAY,CAAC;AAepB,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,CAiDxC"}
+{"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;AAOlD,OAAO,KAAK,EACV,4BAA4B,EAC5B,6BAA6B,EAE7B,oBAAoB,EAErB,MAAM,YAAY,CAAC;AAqBpB,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,CAmDxC"}

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

@@ -1,5 +1,6 @@
 import { getKnowledgeSpaceId, isInKnowledgeSpace, normalizeKnowledgeSpaceId } from '../spaces.js';
 import { MAX_ANSWER_EVIDENCE_CHARS, clampText, normalizeWhitespace, readRecord, readString, scoreSemanticText, semanticHash, semanticMetadata, sourceSemanticText, tokenizeSemanticQuery, uniqueStrings, } from './utils.js';
+import { hasConcreteFeatureSignal, isLowValueFeatureOrSpecText, isSemanticAnswerLinkedObject, semanticFactText, } from './fact-quality.js';
 const GENERIC_ANSWER_INTENT_TOKENS = new Set([
     'capabilities',
     'capability',
@@ -53,7 +54,9 @@ export async function answerKnowledgeQuery(context, input) {
     const sources = uniqueSources(evidence.flatMap((item) => item.source ? [item.source] : [])).slice(0, limit);
     const linkedObjects = input.includeLinkedObjects === false
         ? []
-        : uniqueNodes([...(input.linkedObjects ?? []), ...evidence.flatMap((item) => item.node ? [item.node] : [])]).slice(0, 24);
+        : uniqueNodes([...(input.linkedObjects ?? []), ...evidence.flatMap((item) => item.node ? [item.node] : [])])
+            .filter(isSemanticAnswerLinkedObject)
+            .slice(0, 24);
     const gaps = await persistAnswerGaps(context.store, spaceId, input.query, llmAnswer?.gaps ?? []);
     const text = llmAnswer?.answer?.trim() || renderFallbackAnswer(input.query, mode, evidence);
     return {
@@ -260,14 +263,8 @@ function isLowValueFactForQuery(tokens, intent, fact) {
     const kind = readString(fact.metadata.factKind) ?? 'note';
     if (!['feature', 'capability', 'specification', 'compatibility', 'configuration', 'identity'].includes(kind))
         return false;
-    const text = [
-        fact.title,
-        fact.summary,
-        readString(fact.metadata.value),
-        readString(fact.metadata.evidence),
-        Array.isArray(fact.metadata.labels) ? fact.metadata.labels.join(' ') : '',
-    ].filter(Boolean).join(' ').toLowerCase();
-    if (isManualBoilerplateFeatureText(text))
+    const text = semanticFactText(fact);
+    if (isLowValueFeatureOrSpecText(text))
         return true;
     const extractor = readString(fact.metadata.extractor);
     const confidence = typeof fact.confidence === 'number' ? fact.confidence : 0;
@@ -279,12 +276,6 @@ function isLowValueFactForQuery(tokens, intent, fact) {
 function hasFeatureIntent(intent) {
     return intent.has('feature') || intent.has('capability') || intent.has('specification') || intent.has('compatibility');
 }
-function isManualBoilerplateFeatureText(text) {
-    return /\b(items? supplied|accessories supplied|contents? of (this )?manual|may vary|may be changed|without prior notice|depending (upon|on) (the )?model|available menus? and options?|product specifications?|power cord|electric shock|fire hazard|certified cable|do not|warning|caution|risk|hazard|clean only|near water|ventilation|antenna grounding)\b/.test(text);
-}
-function hasConcreteFeatureSignal(text) {
-    return /\b(hdmi|usb|hdr|hdr10|dolby|vision|earc|arc|bluetooth|wi-?fi|ethernet|voice|remote|game|filmmaker|airplay|chromecast|resolution|4k|8k|refresh|ports?|speakers?|audio|display|screen|apps?|streaming|matter|energy monitoring|scheduling|sensor|battery|z-?wave|zigbee|thread|motion|temperature|humidity|camera|recording|lock|garage|local control|api|automation)\b/.test(text);
-}
 function compareFactQuality(left, right) {
     return factQuality(right) - factQuality(left) || left.title.localeCompare(right.title);
 }
@@ -361,12 +352,18 @@ function sourceIdsLinkedToNodes(store, nodeIds, spaceId) {
 }
 function selectEvidenceExcerpt(query, text, facts) {
     const tokens = expandQueryTokens(tokenizeSemanticQuery(query));
+    const intent = factIntent(tokenizeSemanticQuery(query));
+    const featureIntent = Boolean(intent && hasFeatureIntent(intent));
     const factLines = facts
         .map(renderFactForPrompt)
         .filter((line) => scoreSemanticText(line, tokens) > 0)
+        .filter((line) => !featureIntent || !isLowValueFeatureOrSpecText(line))
         .slice(0, 12);
-    const windows = evidenceWindows(text, tokens).slice(0, 4);
-    return uniqueStrings([...factLines, ...windows, clampText(text, 720)]).join('\n');
+    const windows = evidenceWindows(text, tokens)
+        .filter((line) => !featureIntent || !isLowValueFeatureOrSpecText(line))
+        .slice(0, 4);
+    const fallback = featureIntent && (factLines.length > 0 || windows.length > 0) ? [] : [clampText(text, 720)];
+    return uniqueStrings([...factLines, ...windows, ...fallback]).join('\n');
 }
 function evidenceWindows(text, tokens) {
     const normalized = normalizeWhitespace(text);

package/dist/_internal/platform/knowledge/semantic/fact-quality.d.ts

@@ -0,0 +1,7 @@
+import type { KnowledgeNodeRecord } from '../types.js';
+export declare function isSemanticAnswerLinkedObject(node: KnowledgeNodeRecord): boolean;
+export declare function semanticFactText(fact: KnowledgeNodeRecord): string;
+export declare function isLowValueFeatureOrSpecText(text: string): boolean;
+export declare function hasConcreteFeatureSignal(text: string): boolean;
+export declare function isUsefulHomeGraphPageFact(fact: KnowledgeNodeRecord): boolean;
+//# sourceMappingURL=fact-quality.d.ts.map

package/dist/_internal/platform/knowledge/semantic/fact-quality.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fact-quality.d.ts","sourceRoot":"","sources":["../../../../../src/_internal/platform/knowledge/semantic/fact-quality.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAcvD,wBAAgB,4BAA4B,CAAC,IAAI,EAAE,mBAAmB,GAAG,OAAO,CAK/E;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,mBAAmB,GAAG,MAAM,CAQlE;AAED,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAgCjE;AAWD,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAE9D;AAED,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,mBAAmB,GAAG,OAAO,CAa5E"}

package/dist/_internal/platform/knowledge/semantic/fact-quality.js

@@ -0,0 +1,93 @@
+import { readString } from './utils.js';
+const USEFUL_PAGE_FACT_KINDS = new Set([
+    'feature',
+    'capability',
+    'specification',
+    'identity',
+    'maintenance',
+    'compatibility',
+    'configuration',
+    'troubleshooting',
+]);
+export function isSemanticAnswerLinkedObject(node) {
+    if (node.status === 'stale')
+        return false;
+    const semanticKind = readString(node.metadata.semanticKind);
+    if (semanticKind)
+        return false;
+    return node.kind !== 'fact' && node.kind !== 'wiki_page' && node.kind !== 'knowledge_gap';
+}
+export function semanticFactText(fact) {
+    return [
+        fact.title,
+        fact.summary,
+        readString(fact.metadata.value),
+        readString(fact.metadata.evidence),
+        Array.isArray(fact.metadata.labels) ? fact.metadata.labels.join(' ') : '',
+    ].filter(Boolean).join(' ').toLowerCase();
+}
+export function isLowValueFeatureOrSpecText(text) {
+    const lower = text.toLowerCase();
+    const magicRemoteDetail = /\bmagic remote\b/.test(lower) || /\bbluetooth\b/.test(lower);
+    if (isTruncatedManualFragment(lower))
+        return true;
+    if (/\b(items? supplied|supplied items?|included accessories|optional extras?|sold separately|separate purchase|accessories may vary|contents? of (this )?manual|may be changed|may change|subject to change|without prior notice|available menus? and options?|certified cable|unapproved items?)\b/.test(lower)) {
+        return true;
+    }
+    if (/\b(new features? may be added|features? may be added|specifications? may change|product upgrades?|due to product upgrades?)\b/.test(lower)) {
+        return true;
+    }
+    if (/\b(recommended hdmi cable types?|hdmi cable types?|ultra high speed hdmi cables?|usb extension cable|extension cable|physically fit)\b/.test(lower)) {
+        return true;
+    }
+    if (/\b(button|buttons|remote control)\b/.test(lower) && /[\u25b2\u25bc\u25c4\u25ba]|[▲▼◄►]|\\u25/.test(text)) {
+        return true;
+    }
+    if (!magicRemoteDetail && /\b(may vary|depending (upon|on) (the )?model|depending on country|depending on region)\b/.test(lower)) {
+        return true;
+    }
+    if (/\b(fasten|screws?|stand|tip over|overturn|fall over|transporting|move the tv|moving the tv|oils?|lubricants?|cleaning cloth|dry cloth|power cord|electric shock|fire hazard|near water|ventilation|antenna grounding|qualified personnel|customer service|servicing|repair is required|refer all servicing)\b/.test(lower)) {
+        return true;
+    }
+    if (/\bbatter(y|ies)\b/.test(lower) && /\b(remote|magic remote|button)\b/.test(lower)) {
+        return true;
+    }
+    if (/\b(bezel|less than \d+(?:\.\d+)?\s*(mm|cm|inches?)|does not fit|will not fit|fit your tv'?s usb port|usb port may not fit)\b/.test(lower)) {
+        return true;
+    }
+    if (/\b(warning|caution|risk|hazard|do not|never)\b/.test(lower) && !/\b(feature|supports?|hdmi|usb|hdr|remote|bluetooth)\b/.test(lower)) {
+        return true;
+    }
+    return false;
+}
+function isTruncatedManualFragment(value) {
+    const trimmed = value.trim();
+    if (trimmed.length === 0)
+        return false;
+    const openParens = trimmed.match(/\(/g)?.length ?? 0;
+    const closeParens = trimmed.match(/\)/g)?.length ?? 0;
+    if (openParens > closeParens && /[\w\d]$/.test(trimmed))
+        return true;
+    return false;
+}
+export function hasConcreteFeatureSignal(text) {
+    return /\b(hdmi|usb|hdr|hdr10|dolby|vision|earc|arc|bluetooth|wi-?fi|ethernet|voice|remote|game|filmmaker|airplay|chromecast|resolution|4k|8k|refresh|ports?|speakers?|audio|display|screen|apps?|streaming|matter|energy monitoring|scheduling|sensor|battery|z-?wave|zigbee|thread|motion|temperature|humidity|camera|recording|lock|garage|local control|api|automation)\b/.test(text.toLowerCase());
+}
+export function isUsefulHomeGraphPageFact(fact) {
+    if (fact.status === 'stale')
+        return false;
+    if (fact.metadata.semanticKind !== 'fact')
+        return false;
+    const kind = readString(fact.metadata.factKind) ?? 'note';
+    if (!USEFUL_PAGE_FACT_KINDS.has(kind))
+        return false;
+    const text = semanticFactText(fact);
+    if (isLowValueFeatureOrSpecText(text))
+        return false;
+    const extractor = readString(fact.metadata.extractor);
+    const confidence = typeof fact.confidence === 'number' ? fact.confidence : 0;
+    if (extractor === 'deterministic' && confidence <= 60 && ['feature', 'capability', 'specification', 'compatibility', 'configuration'].includes(kind)) {
+        return hasConcreteFeatureSignal(text);
+    }
+    return true;
+}

package/dist/_internal/platform/version.js

@@ -1,6 +1,6 @@
 import { readFileSync } from 'node:fs';
 import { join } from 'node:path';
-let version = '0.27.6';
+let version = '0.27.8';
 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.27.6",
+  "version": "0.27.8",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/mgd34msu/goodvibes-sdk.git"