@pellux/goodvibes-sdk 0.28.21 → 0.28.22

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

@@ -3,7 +3,7 @@
   "product": {
     "id": "goodvibes",
     "surface": "operator",
-    "version": "0.28.21"
+    "version": "0.28.22"
   },
   "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.21";
+    readonly productVersion: "0.28.22";
     readonly operatorMethodCount: 265;
     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.21",
+    "productVersion": "0.28.22",
     "operatorMethodCount": 265,
     "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.21"
+        "version": "0.28.22"
     },
     "auth": {
         "modes": [

package/dist/_internal/platform/knowledge/home-graph/ask-page-refresh.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ask-page-refresh.d.ts","sourceRoot":"","sources":["../../../../../src/_internal/platform/knowledge/home-graph/ask-page-refresh.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAGlD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAErD,wBAAsB,iCAAiC,CAAC,KAAK,EAAE;IAC7D,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;IAChC,QAAQ,CAAC,MAAM,EAAE,kBAAkB,CAAC;CACrC,GAAG,OAAO,CAAC;IAAE,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC,CAwBvE"}
+{"version":3,"file":"ask-page-refresh.d.ts","sourceRoot":"","sources":["../../../../../src/_internal/platform/knowledge/home-graph/ask-page-refresh.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAKlD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAErD,wBAAsB,iCAAiC,CAAC,KAAK,EAAE;IAC7D,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;IAChC,QAAQ,CAAC,MAAM,EAAE,kBAAkB,CAAC;CACrC,GAAG,OAAO,CAAC;IAAE,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC,CAmCvE"}

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

@@ -1,9 +1,22 @@
-import { readRecord } from './helpers.js';
+import { isUsefulHomeGraphPageFact } from '../semantic/fact-quality.js';
+import { buildHomeGraphMetadata, isGeneratedPageSource, readRecord } from './helpers.js';
 import { refreshHomeGraphDevicePassport } from './generated-pages.js';
 export async function refreshDevicePagesForHomeGraphAsk(input) {
     if ((input.answer.answer.facts?.length ?? 0) === 0 && input.answer.answer.sources.length === 0)
         return { requested: false, refreshed: 0 };
     const devices = input.answer.answer.linkedObjects.filter((node) => node.kind === 'ha_device').slice(0, 2);
+    try {
+        await persistAnswerFactSubjectLinks({
+            store: input.store,
+            spaceId: input.spaceId,
+            installationId: input.installationId,
+            devices,
+            facts: input.answer.answer.facts ?? [],
+        });
+    }
+    catch {
+        // Ask should still return even if page enrichment bookkeeping fails.
+    }
     let refreshed = 0;
     for (const device of devices) {
         const deviceId = readHomeAssistantObjectId(device) ?? device.id;
@@ -27,8 +40,134 @@ export async function refreshDevicePagesForHomeGraphAsk(input) {
     }
     return { requested: devices.length > 0, refreshed };
 }
+async function persistAnswerFactSubjectLinks(input) {
+    if (input.devices.length === 0 || input.facts.length === 0)
+        return;
+    const devicesById = new Map(input.devices.map((device) => [device.id, device]));
+    for (const fact of input.facts) {
+        if (!isUsefulHomeGraphPageFact(fact) || !fact.sourceId)
+            continue;
+        const source = input.store.getSource(fact.sourceId);
+        if (!source || source.status === 'stale' || isGeneratedPageSource(source))
+            continue;
+        const targets = answerFactTargetDevices(fact, devicesById);
+        if (targets.length === 0)
+            continue;
+        const existing = input.store.getNode(fact.id) ?? fact;
+        const sourceId = existing.sourceId ?? fact.sourceId;
+        const subjectIds = uniqueStrings([
+            ...readStringArray(existing.metadata.subjectIds),
+            ...readStringArray(existing.metadata.linkedObjectIds),
+            ...targets.map((device) => device.id),
+        ]).filter((id) => devicesById.has(id));
+        const targetHints = uniqueTargetHints([
+            ...targets.map((device) => ({
+                id: device.id,
+                kind: device.kind,
+                title: device.title,
+                ...(device.summary ? { summary: device.summary } : {}),
+            })),
+            ...readTargetHints(existing.metadata.targetHints),
+        ]).filter((hint) => devicesById.has(readString(hint.id) ?? ''));
+        const updatedFact = await input.store.upsertNode({
+            id: existing.id,
+            kind: existing.kind,
+            slug: existing.slug,
+            title: existing.title,
+            ...(existing.summary ? { summary: existing.summary } : {}),
+            aliases: existing.aliases,
+            status: existing.status,
+            confidence: existing.confidence,
+            ...(sourceId ? { sourceId } : {}),
+            metadata: buildHomeGraphMetadata(input.spaceId, input.installationId, {
+                ...existing.metadata,
+                semanticKind: 'fact',
+                subject: targets[0]?.title,
+                subjectIds,
+                linkedObjectIds: subjectIds,
+                targetHints,
+                sourceId,
+                linkedBy: 'homegraph-ask-page-refresh',
+            }),
+        });
+        await input.store.upsertEdge({
+            fromKind: 'source',
+            fromId: source.id,
+            toKind: 'node',
+            toId: updatedFact.id,
+            relation: 'supports_fact',
+            weight: 0.82,
+            metadata: buildHomeGraphMetadata(input.spaceId, input.installationId, {
+                linkedBy: 'homegraph-ask-page-refresh',
+            }),
+        });
+        for (const device of targets) {
+            await input.store.upsertEdge({
+                fromKind: 'node',
+                fromId: updatedFact.id,
+                toKind: 'node',
+                toId: device.id,
+                relation: 'describes',
+                weight: 0.8,
+                metadata: buildHomeGraphMetadata(input.spaceId, input.installationId, {
+                    linkedBy: 'homegraph-ask-page-refresh',
+                    sourceId: source.id,
+                }),
+            });
+        }
+    }
+}
+function answerFactTargetDevices(fact, devicesById) {
+    const ids = uniqueStrings([
+        ...readStringArray(fact.linkedObjectIds),
+        ...readStringArray(fact.subjectIds),
+        ...readStringArray(fact.metadata.linkedObjectIds),
+        ...readStringArray(fact.metadata.subjectIds),
+    ]);
+    const explicit = ids.map((id) => devicesById.get(id)).filter((device) => Boolean(device));
+    if (explicit.length > 0)
+        return explicit;
+    return devicesById.size === 1 ? [...devicesById.values()] : [];
+}
 function readHomeAssistantObjectId(node) {
     const homeAssistant = readRecord(node.metadata.homeAssistant);
     const value = homeAssistant.objectId ?? homeAssistant.deviceId;
     return typeof value === 'string' && value.trim().length > 0 ? value.trim() : undefined;
 }
+function readString(value) {
+    return typeof value === 'string' && value.trim().length > 0 ? value.trim() : undefined;
+}
+function readStringArray(value) {
+    if (!Array.isArray(value))
+        return [];
+    return value.map((entry) => readString(entry)).filter((entry) => Boolean(entry));
+}
+function readTargetHints(value) {
+    if (!Array.isArray(value))
+        return [];
+    return value.filter((entry) => Boolean(entry && typeof entry === 'object' && !Array.isArray(entry)));
+}
+function uniqueStrings(values) {
+    const seen = new Set();
+    const result = [];
+    for (const value of values) {
+        const trimmed = typeof value === 'string' ? value.trim() : '';
+        if (!trimmed || seen.has(trimmed))
+            continue;
+        seen.add(trimmed);
+        result.push(trimmed);
+    }
+    return result;
+}
+function uniqueTargetHints(values) {
+    const seen = new Set();
+    const result = [];
+    for (const value of values) {
+        const id = readString(value.id);
+        if (!id || seen.has(id))
+            continue;
+        seen.add(id);
+        result.push(value);
+    }
+    return result;
+}

package/dist/_internal/platform/version.js

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