@pellux/goodvibes-sdk 0.27.2 → 0.27.4

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

@@ -1,4 +1,4 @@
-import type { KnowledgeEdgeRecord, KnowledgeIssueRecord, KnowledgeNodeRecord, KnowledgeSourceRecord } from '../types.js';
+import type { KnowledgeEdgeRecord, KnowledgeExtractionRecord, KnowledgeIssueRecord, KnowledgeNodeRecord, KnowledgeSourceRecord } from '../types.js';
 import type { HomeGraphMapInput, HomeGraphMapResult } from './types.js';
 export interface HomeGraphRenderState {
     readonly spaceId: string;
@@ -7,6 +7,7 @@ export interface HomeGraphRenderState {
     readonly nodes: readonly KnowledgeNodeRecord[];
     readonly edges: readonly KnowledgeEdgeRecord[];
     readonly issues: readonly KnowledgeIssueRecord[];
+    readonly extractions?: readonly KnowledgeExtractionRecord[];
 }
 export declare function renderRoomPage(state: HomeGraphRenderState, areaId?: string): string;
 export declare function renderDevicePassportPage(input: {
@@ -14,8 +15,10 @@ export declare function renderDevicePassportPage(input: {
     readonly device: KnowledgeNodeRecord;
     readonly entities: readonly KnowledgeNodeRecord[];
     readonly sources: readonly KnowledgeSourceRecord[];
+    readonly extractions?: readonly KnowledgeExtractionRecord[];
     readonly issues: readonly KnowledgeIssueRecord[];
     readonly missingFields: readonly string[];
+    readonly semanticFacts?: readonly KnowledgeNodeRecord[];
 }): string;
 export declare function renderPacketPage(state: HomeGraphRenderState, options?: {
     readonly packetKind?: string;

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,oBAAoB,EAEpB,mBAAmB,EACnB,qBAAqB,EACtB,MAAM,aAAa,CAAC;AAIrB,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;CAClD;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,oBAAoB,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAuCnF;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,MAAM,EAAE,SAAS,oBAAoB,EAAE,CAAC;IACjD,QAAQ,CAAC,aAAa,EAAE,SAAS,MAAM,EAAE,CAAC;CAC3C,GAAG,MAAM,CAoBT;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;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"}

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

@@ -1,6 +1,7 @@
 import { renderKnowledgeMap } from '../map.js';
 import { countFacet, normalizeStringArray, readString } from '../map-filters.js';
-import { edgeIsActive, isGeneratedPageSource } from './helpers.js';
+import { isUnusableHomeGraphExtractionText } from './extraction-quality.js';
+import { edgeIsActive, isGeneratedPageSource, readRecord, uniqueStrings } from './helpers.js';
 export function renderRoomPage(state, areaId) {
     const area = areaId
         ? findNodeByHaId(state.nodes, 'ha_area', areaId) ?? findNodeByHaId(state.nodes, 'ha_room', areaId)
@@ -23,38 +24,61 @@ export function renderRoomPage(state, areaId) {
         ...scripts.map((node) => node.id),
     ]);
     const sources = relatedSources(state.sources, state.edges, relatedNodeIds);
+    const semanticFacts = semanticFactsLinkedToSources(sources, state.nodes, state.edges);
     return [
         `# ${title}`,
         '',
         `Knowledge space: \`${state.spaceId}\``,
         '',
+        renderRoomOverview(title, devices, entities, automations, scenes, scripts),
         renderNodeList('Devices', devices),
         renderNodeList('Entities', entities),
         renderNodeList('Automations', automations),
         renderNodeList('Scenes', scenes),
         renderNodeList('Scripts', scripts),
+        renderSourceEvidence('Source-Backed Knowledge', sources, state.extractions ?? [], {
+            tokens: uniqueStrings([
+                title,
+                ...devices.map((node) => node.title),
+                ...entities.map((node) => node.title),
+            ].flatMap(tokenizeEvidence)),
+            maxSources: 12,
+            maxSnippetsPerSource: 2,
+        }),
+        renderSemanticFacts('Extracted Facts', semanticFacts),
         renderSourceList('Linked Sources', sources),
         renderIssueList('Open Issues', state.issues.filter((issue) => issue.status === 'open')),
     ].filter(Boolean).join('\n');
 }
 export function renderDevicePassportPage(input) {
+    const deviceTokens = deviceEvidenceTokens(input.device, input.entities);
     return [
         `# ${input.device.title}`,
         '',
         `Knowledge space: \`${input.spaceId}\``,
         '',
-        '## Profile',
+        '## Overview',
+        '',
+        renderDeviceOverview(input.device, input.entities, input.sources),
+        '',
+        '## Home Assistant Profile',
         '',
         renderMetadataField('Manufacturer', input.device.metadata.manufacturer),
         renderMetadataField('Model', input.device.metadata.model),
         renderMetadataField('Area', readHa(input.device, 'areaId')),
         renderMetadataField('Device id', readHa(input.device, 'deviceId')),
         '',
-        renderNodeList('Entities', input.entities),
+        renderNodeList('Entities Exposed To Home Assistant', input.entities),
+        renderSemanticFacts('Extracted Device Facts', input.semanticFacts ?? []),
+        renderSourceEvidence('Source-Backed Features And Notes', input.sources, input.extractions ?? [], {
+            tokens: deviceTokens,
+            maxSources: 8,
+            maxSnippetsPerSource: 4,
+        }),
         renderSourceList('Sources', input.sources),
         renderIssueList('Issues', input.issues),
         input.missingFields.length > 0
-            ? ['## Missing Fields', '', ...input.missingFields.map((field) => `- ${field}`), ''].join('\n')
+            ? ['## Open Questions', '', ...input.missingFields.map((field) => `- ${field}`), ''].join('\n')
             : '',
     ].filter(Boolean).join('\n');
 }
@@ -215,6 +239,142 @@ function renderNodeList(title, nodes) {
         '',
     ].join('\n');
 }
+function renderRoomOverview(title, devices, entities, automations, scenes, scripts) {
+    return [
+        '## Overview',
+        '',
+        `${title} currently has ${devices.length} device(s), ${entities.length} entity record(s), ${automations.length} automation(s), ${scenes.length} scene(s), and ${scripts.length} script(s) in the Home Graph.`,
+        '',
+    ].join('\n');
+}
+function renderDeviceOverview(device, entities, sources) {
+    const identity = uniqueStrings([
+        readMetadataString(device, 'manufacturer'),
+        readMetadataString(device, 'model'),
+        readHa(device, 'areaId') ? `area ${readHa(device, 'areaId')}` : undefined,
+    ]);
+    const details = identity.length > 0 ? ` ${identity.join(' - ')}.` : '.';
+    return `${device.title}${details} The Home Graph links this device to ${entities.length} Home Assistant entity record(s) and ${sources.length} source(s).`;
+}
+function renderSourceEvidence(title, sources, extractions, options) {
+    const extractionBySourceId = new Map(extractions.map((extraction) => [extraction.sourceId, extraction]));
+    const entries = sources
+        .map((source) => ({
+        source,
+        snippets: sourceEvidenceSnippets(source, extractionBySourceId.get(source.id), options.tokens, options.maxSnippetsPerSource),
+    }))
+        .filter((entry) => entry.snippets.length > 0)
+        .slice(0, options.maxSources);
+    if (entries.length === 0) {
+        return [
+            `## ${title}`,
+            '',
+            'No linked source-backed details have been extracted yet.',
+            '',
+        ].join('\n');
+    }
+    return [
+        `## ${title}`,
+        '',
+        ...entries.flatMap((entry) => [
+            `### ${entry.source.title ?? entry.source.sourceUri ?? entry.source.id}`,
+            '',
+            ...entry.snippets.map((snippet) => `- ${snippet}`),
+            '',
+        ]),
+    ].join('\n');
+}
+function sourceEvidenceSnippets(source, extraction, tokens, limit) {
+    const structure = readRecord(extraction?.structure);
+    const searchText = typeof structure.searchText === 'string' ? structure.searchText : undefined;
+    const candidates = uniqueStrings([
+        extraction?.summary,
+        extraction?.excerpt,
+        ...(extraction?.sections ?? []),
+        ...evidenceWindows(searchText, tokens),
+        ...featureSentences(searchText),
+        source.summary,
+        source.description,
+    ]).filter((entry) => !isUnusableHomeGraphExtractionText(entry)).slice(0, 80);
+    const scored = candidates
+        .map((text) => ({ text: clampEvidence(text), score: evidenceScore(text, tokens) }))
+        .filter((entry) => entry.text.length > 0)
+        .sort((left, right) => right.score - left.score || left.text.length - right.text.length);
+    return uniqueStrings(scored.map((entry) => entry.text)).slice(0, limit);
+}
+function evidenceWindows(value, tokens) {
+    const text = normalizeWhitespace(value ?? '');
+    if (!text)
+        return [];
+    const lower = text.toLowerCase();
+    const windows = [];
+    for (const token of tokens) {
+        if (token.length < 3)
+            continue;
+        const index = lower.indexOf(token.toLowerCase());
+        if (index < 0)
+            continue;
+        const start = Math.max(0, index - 180);
+        const end = Math.min(text.length, index + 420);
+        windows.push(`${start > 0 ? '...' : ''}${text.slice(start, end).trim()}${end < text.length ? '...' : ''}`);
+    }
+    return windows;
+}
+function featureSentences(value) {
+    const text = normalizeWhitespace(value ?? '');
+    if (!text)
+        return [];
+    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))
+        .slice(0, 24);
+}
+function evidenceScore(value, tokens) {
+    const lower = value.toLowerCase();
+    let score = 0;
+    for (const token of tokens) {
+        if (token.length >= 3 && lower.includes(token.toLowerCase()))
+            score += 10;
+    }
+    if (/\b(feature|features|support|supports|mode|hdmi|hdr|dolby|voice|remote)\b/i.test(value))
+        score += 25;
+    return score;
+}
+function deviceEvidenceTokens(device, entities) {
+    return uniqueStrings([
+        device.title,
+        ...device.aliases,
+        readMetadataString(device, 'manufacturer'),
+        readMetadataString(device, 'model'),
+        readHa(device, 'deviceId'),
+        ...entities.flatMap((entity) => [
+            entity.title,
+            readHa(entity, 'entityId'),
+            readMetadataString(entity, 'domain'),
+            readMetadataString(entity, 'platform'),
+        ]),
+    ].flatMap(tokenizeEvidence));
+}
+function tokenizeEvidence(value) {
+    if (!value)
+        return [];
+    return value.toLowerCase()
+        .split(/[^a-z0-9_.:-]+/)
+        .map((entry) => entry.trim())
+        .filter((entry) => entry.length >= 2 && !['the', 'and', 'home', 'assistant', 'device'].includes(entry));
+}
+function clampEvidence(value) {
+    const normalized = normalizeWhitespace(value);
+    return normalized.length <= 420 ? normalized : `${normalized.slice(0, 419).trim()}...`;
+}
+function normalizeWhitespace(value) {
+    return value.replace(/\s+/g, ' ').trim();
+}
+function readMetadataString(node, key) {
+    const value = node.metadata[key];
+    return typeof value === 'string' && value.trim().length > 0 ? value.trim() : undefined;
+}
 function renderSourceList(title, sources) {
     if (sources.length === 0)
         return '';
@@ -228,6 +388,57 @@ function renderSourceList(title, sources) {
         '',
     ].join('\n');
 }
+function renderSemanticFacts(title, facts) {
+    const entries = facts
+        .filter((node) => node.metadata.semanticKind === 'fact')
+        .sort((left, right) => semanticFactSortKey(left).localeCompare(semanticFactSortKey(right)) || left.title.localeCompare(right.title))
+        .slice(0, 80);
+    if (entries.length === 0)
+        return '';
+    const groups = new Map();
+    for (const fact of entries) {
+        const kind = readString(fact.metadata.factKind) ?? 'fact';
+        groups.set(kind, [...(groups.get(kind) ?? []), fact]);
+    }
+    return [
+        `## ${title}`,
+        '',
+        ...[...groups.entries()].flatMap(([kind, group]) => [
+            `### ${titleCase(kind)}`,
+            '',
+            ...group.slice(0, 24).map((fact) => {
+                const value = readString(fact.metadata.value);
+                const evidence = readString(fact.metadata.evidence);
+                const detail = fact.summary ?? evidence;
+                return `- ${fact.title}${value ? `: ${value}` : ''}${detail ? ` - ${detail}` : ''}`;
+            }),
+            '',
+        ]),
+    ].join('\n');
+}
+function semanticFactsLinkedToSources(sources, nodes, edges) {
+    const sourceIds = new Set(sources.map((source) => source.id));
+    const factIds = new Set(edges.filter((edge) => (edgeIsActive(edge)
+        && edge.fromKind === 'source'
+        && sourceIds.has(edge.fromId)
+        && edge.toKind === 'node'
+        && edge.relation === 'supports_fact')).map((edge) => edge.toId));
+    return nodes.filter((node) => factIds.has(node.id));
+}
+function semanticFactSortKey(node) {
+    const order = {
+        feature: '01',
+        capability: '02',
+        specification: '03',
+        configuration: '04',
+        compatibility: '05',
+        procedure: '06',
+        maintenance: '07',
+        troubleshooting: '08',
+        warning: '09',
+    };
+    return order[readString(node.metadata.factKind) ?? ''] ?? '99';
+}
 function renderIssueList(title, issues) {
     if (issues.length === 0)
         return '';

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

@@ -2,11 +2,15 @@ import type { ArtifactStore } from '../../artifacts/index.js';
 import type { KnowledgeStore } from '../store.js';
 import type { KnowledgeEdgeRecord, KnowledgeIssueRecord, KnowledgeNodeRecord, KnowledgeSourceRecord } from '../types.js';
 import { type HomeGraphReviewResult } from './review.js';
-import type { HomeGraphAskInput, HomeGraphAskResult, HomeGraphDevicePassportResult, HomeGraphExport, HomeGraphIngestArtifactInput, HomeGraphIngestNoteInput, HomeGraphIngestResult, HomeGraphIngestUrlInput, HomeGraphLinkInput, HomeGraphLinkResult, HomeGraphMapInput, HomeGraphMapResult, HomeGraphProjectionInput, HomeGraphProjectionResult, HomeGraphReindexResult, HomeGraphReviewInput, HomeGraphSpaceInput, HomeGraphSnapshotInput, HomeGraphStatus, HomeGraphSyncResult } from './types.js';
+import type { KnowledgeSemanticService } from '../semantic/index.js';
+import type { HomeGraphAskInput, HomeGraphAskResult, HomeGraphDevicePassportResult, HomeGraphExport, HomeGraphIngestArtifactInput, HomeGraphIngestNoteInput, HomeGraphIngestResult, HomeGraphIngestUrlInput, HomeGraphLinkInput, HomeGraphLinkResult, HomeGraphMapInput, HomeGraphMapResult, HomeGraphProjectionInput, HomeGraphProjectionResult, HomeGraphPageListResult, HomeGraphReindexResult, HomeGraphReviewInput, HomeGraphSpaceInput, HomeGraphSnapshotInput, HomeGraphStatus, HomeGraphSyncResult } from './types.js';
 export declare class HomeGraphService {
     private readonly store;
     private readonly artifactStore;
-    constructor(store: KnowledgeStore, artifactStore: ArtifactStore);
+    private readonly options;
+    constructor(store: KnowledgeStore, artifactStore: ArtifactStore, options?: {
+        readonly semanticService?: KnowledgeSemanticService;
+    });
     status(input?: {
         readonly installationId?: string;
         readonly knowledgeSpaceId?: string;
@@ -41,6 +45,10 @@ export declare class HomeGraphService {
         readonly spaceId: string;
         readonly sources: readonly KnowledgeSourceRecord[];
     }>;
+    listPages(input?: HomeGraphSpaceInput & {
+        readonly limit?: number;
+        readonly includeMarkdown?: boolean;
+    }): Promise<HomeGraphPageListResult>;
     browse(input?: HomeGraphSpaceInput & {
         readonly limit?: number;
     }): Promise<{
@@ -68,11 +76,13 @@ export declare class HomeGraphService {
     }>;
     private ingestCreatedArtifact;
     private extractArtifact;
+    private autoLinkExistingSources;
     private upsertHomeNode;
     private upsertSnapshotObjects;
     private linkSnapshotObjectRelations;
     private tryLinkNode;
     private refreshQualityIssues;
+    private enrichSpaceSources;
     private resolveLinkSource;
     private ensureTarget;
 }

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

@@ -1 +1 @@
-{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../../../../src/_internal/platform/knowledge/home-graph/service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAG9D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,KAAK,EACV,mBAAmB,EAEnB,oBAAoB,EACpB,mBAAmB,EAEnB,qBAAqB,EAEtB,MAAM,aAAa,CAAC;AAmBrB,OAAO,EAAuB,KAAK,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAwB9E,OAAO,KAAK,EACV,iBAAiB,EAAE,kBAAkB,EAAE,6BAA6B,EAAE,eAAe,EACrF,4BAA4B,EAAE,wBAAwB,EAAE,qBAAqB,EAAE,uBAAuB,EAC5E,kBAAkB,EAAE,mBAAmB,EACjE,iBAAiB,EAAE,kBAAkB,EAAE,wBAAwB,EAAE,yBAAyB,EAC1F,sBAAsB,EAAE,oBAAoB,EAAE,mBAAmB,EACjE,sBAAsB,EAAE,eAAe,EAAE,mBAAmB,EAC7D,MAAM,YAAY,CAAC;AAGpB,qBAAa,gBAAgB;IAEzB,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,aAAa;gBADb,KAAK,EAAE,cAAc,EACrB,aAAa,EAAE,aAAa;IAGzC,MAAM,CAAC,KAAK,GAAE;QAAE,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAA;KAAO,GAAG,OAAO,CAAC,eAAe,CAAC;IAqBtH,YAAY,CAAC,KAAK,EAAE,sBAAsB,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAiDzE,SAAS,CAAC,KAAK,EAAE,uBAAuB,GAAG,OAAO,CAAC,qBAAqB,CAAC;IA0BzE,UAAU,CAAC,KAAK,EAAE,wBAAwB,GAAG,OAAO,CAAC,qBAAqB,CAAC;IA6B3E,cAAc,CAAC,KAAK,EAAE,4BAA4B,GAAG,OAAO,CAAC,qBAAqB,CAAC;IA8BnF,aAAa,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAoBtE,eAAe,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAYxE,GAAG,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAiC1D,OAAO,CAAC,KAAK,GAAE,mBAAwB,GAAG,OAAO,CAAC,sBAAsB,CAAC;YAajE,2BAA2B;IA0BnC,qBAAqB,CAAC,KAAK,EAAE,wBAAwB,GAAG,OAAO,CAAC,6BAA6B,CAAC;IAY9F,gBAAgB,CAAC,KAAK,EAAE,wBAAwB,GAAG,OAAO,CAAC,yBAAyB,CAAC;IAYrF,cAAc,CAAC,KAAK,EAAE,wBAAwB,GAAG,OAAO,CAAC,yBAAyB,CAAC;IAYnF,UAAU,CAAC,KAAK,EAAE,mBAAmB,GAAG;QAC5C,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QACzB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;QAC3B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QACvB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;KACzB,GAAG,OAAO,CAAC;QAAE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;QAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,MAAM,EAAE,SAAS,oBAAoB,EAAE,CAAA;KAAE,CAAC;IAYxG,UAAU,CAAC,KAAK,EAAE,oBAAoB,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAMvE,WAAW,CAAC,KAAK,GAAE,mBAAmB,GAAG;QAAE,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAO,GAAG,OAAO,CAAC;QACxF,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;QAClB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;QACzB,QAAQ,CAAC,OAAO,EAAE,SAAS,qBAAqB,EAAE,CAAC;KACpD,CAAC;IAMI,MAAM,CAAC,KAAK,GAAE,mBAAmB,GAAG;QAAE,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAO,GAAG,OAAO,CAAC;QACnF,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;QAClB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;QACzB,QAAQ,CAAC,KAAK,EAAE,SAAS,mBAAmB,EAAE,CAAC;QAC/C,QAAQ,CAAC,KAAK,EAAE,SAAS,mBAAmB,EAAE,CAAC;QAC/C,QAAQ,CAAC,OAAO,EAAE,SAAS,qBAAqB,EAAE,CAAC;QACnD,QAAQ,CAAC,MAAM,EAAE,SAAS,oBAAoB,EAAE,CAAC;KAClD,CAAC;IAeI,GAAG,CAAC,KAAK,GAAE,iBAAsB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAS/D,WAAW,CAAC,KAAK,GAAE,mBAAwB,GAAG,OAAO,CAAC,eAAe,CAAC;IAiBtE,WAAW,CAAC,KAAK,EAAE,mBAAmB,GAAG;QAAE,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAA;KAAE,GAAG,OAAO,CAAC;QAC1F,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;QAClB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;QACzB,QAAQ,CAAC,QAAQ,EAAE;YAAE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;YAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;YAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;YAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;YAAC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;SAAE,CAAC;KACxJ,CAAC;YA+BY,qBAAqB;YA0CrB,eAAe;YAgCf,cAAc;YAmBd,qBAAqB;YAkDrB,2BAA2B;YAiB3B,WAAW;YAoBX,oBAAoB;IAIlC,OAAO,CAAC,iBAAiB;YAcX,YAAY;CAkC3B"}
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../../../../src/_internal/platform/knowledge/home-graph/service.ts"],"names":[],"mappings":"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"}

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

@@ -3,10 +3,13 @@ import { HOME_GRAPH_CONNECTOR_ID, belongsToSpace, buildHomeGraphMetadata, buildH
 import { upsertIntegrationDocumentationCandidates } from './documentation.js';
 import { refreshHomeGraphQualityIssues } from './quality.js';
 import { reviewHomeGraphFact } from './review.js';
-import { collectLinkedObjects, inferHomeGraphSourceType, readHomeGraphState, renderAskAnswer, renderHomeGraphState, safeHomeGraphFilename, } from './state.js';
+import { inferHomeGraphSourceType, readHomeGraphState, renderHomeGraphState, safeHomeGraphFilename, } from './state.js';
+import { answerHomeGraphQuery } from './ask.js';
 import { renderHomeGraphMap } from './rendering.js';
-import { generateAutomaticHomeGraphPages, generateHomeGraphPacket, generateHomeGraphRoomPage, refreshHomeGraphDevicePassport, } from './generated-pages.js';
+import { autoLinkHomeGraphSource, autoLinkHomeGraphSources, } from './auto-link.js';
+import { generateAutomaticHomeGraphPages, generateHomeGraphPacket, generateHomeGraphRoomPage, refreshAutomaticHomeGraphPages, refreshHomeGraphDevicePassport, } from './generated-pages.js';
 import { reindexHomeGraphSources } from './reindex.js';
+import { listHomeGraphPages } from './pages.js';
 import { isUnusableHomeGraphExtractionText } from './extraction-quality.js';
 import { readHomeGraphSearchState, scoreHomeGraphResults, selectHomeGraphExtractionRepairCandidates, } from './search.js';
 import { resolveReadableHomeGraphSpace } from './space-selection.js';
@@ -14,9 +17,11 @@ import { HOME_GRAPH_CAPABILITIES } from './types.js';
 export class HomeGraphService {
     store;
     artifactStore;
-    constructor(store, artifactStore) {
+    options;
+    constructor(store, artifactStore, options = {}) {
         this.store = store;
         this.artifactStore = artifactStore;
+        this.options = options;
     }
     async status(input = {}) {
         await this.store.init();
@@ -62,6 +67,7 @@ export class HomeGraphService {
         const beforeNodeIds = new Set(readHomeGraphState(this.store, spaceId).nodes.map((node) => node.id));
         const beforeEdgeIds = new Set(readHomeGraphState(this.store, spaceId).edges.map((edge) => edge.id));
         const groups = await this.upsertSnapshotObjects(spaceId, installationId, input, home.id, source.id);
+        await this.autoLinkExistingSources(spaceId, installationId);
         const issues = await this.refreshQualityIssues(spaceId, installationId);
         const generated = await generateAutomaticHomeGraphPages({
             store: this.store,
@@ -207,34 +213,34 @@ export class HomeGraphService {
             state = readHomeGraphSearchState(this.store, spaceId);
         }
         const results = scoreHomeGraphResults(input.query, state.sources, state.nodes, state.edges, (sourceId) => state.extractionBySourceId.get(sourceId), input.limit ?? 8);
-        const sources = results.flatMap((result) => result.source ? [result.source] : []);
-        const linkedObjects = collectLinkedObjects(results, state);
-        const confidence = Math.min(100, Math.max(10, results[0]?.score ?? 10));
-        return {
-            ok: true,
-            spaceId,
-            query: input.query,
-            answer: {
-                text: renderAskAnswer(input.query, results, input.mode ?? 'standard'),
-                mode: input.mode ?? 'standard',
-                confidence,
-                sources: input.includeSources === false ? [] : sources,
-                linkedObjects: input.includeLinkedObjects === false ? [] : linkedObjects,
-            },
-            results,
-        };
+        return answerHomeGraphQuery({ store: this.store, semanticService: this.options.semanticService, spaceId, query: input, state, results });
     }
     async reindex(input = {}) {
         await this.store.init();
         const { spaceId, installationId } = resolveReadableHomeGraphSpace(this.store, input);
         const state = readHomeGraphSearchState(this.store, spaceId);
-        return reindexHomeGraphSources({
+        const reindex = await reindexHomeGraphSources({
             spaceId,
             sources: state.sources,
             extractionBySourceId: state.extractionBySourceId,
             artifactStore: this.artifactStore,
             extract: (source, artifact) => this.extractArtifact(source, artifact, spaceId, installationId),
         });
+        const linked = await this.autoLinkExistingSources(spaceId, installationId);
+        const semantic = await this.options.semanticService?.reindex({
+            knowledgeSpaceId: spaceId,
+            sourceIds: state.sources.map((source) => source.id),
+            force: false,
+        });
+        const generated = reindex.reparsed > 0 || linked.length > 0
+            ? await refreshAutomaticHomeGraphPages({ store: this.store, artifactStore: this.artifactStore, spaceId, installationId })
+            : undefined;
+        return {
+            ...reindex,
+            ...(linked.length > 0 ? { linked } : {}),
+            ...(semantic ? { semantic } : {}),
+            ...(generated ? { generated } : {}),
+        };
     }
     async repairWeakExtractionsForAsk(spaceId, installationId, query, state) {
         const candidates = selectHomeGraphExtractionRepairCandidates(query, state.sources, state.nodes, state.edges, (sourceId) => state.extractionBySourceId.get(sourceId), 8);
@@ -247,6 +253,16 @@ export class HomeGraphService {
             if (!artifact)
                 continue;
             const extraction = await this.extractArtifact(source, artifact, spaceId, installationId);
+            if (extraction) {
+                await autoLinkHomeGraphSource({
+                    store: this.store,
+                    spaceId,
+                    installationId,
+                    source,
+                    extraction,
+                    state: readHomeGraphState(this.store, spaceId),
+                });
+            }
             if (extraction && extractionHasSearchableText(extraction))
                 repaired += 1;
         }
@@ -255,6 +271,7 @@ export class HomeGraphService {
     async refreshDevicePassport(input) {
         await this.store.init();
         const { spaceId, installationId } = resolveHomeGraphSpace(input);
+        await this.enrichSpaceSources(spaceId);
         return refreshHomeGraphDevicePassport({
             store: this.store,
             artifactStore: this.artifactStore,
@@ -266,6 +283,7 @@ export class HomeGraphService {
     async generateRoomPage(input) {
         await this.store.init();
         const { spaceId, installationId } = resolveHomeGraphSpace(input);
+        await this.enrichSpaceSources(spaceId);
         return generateHomeGraphRoomPage({
             store: this.store,
             artifactStore: this.artifactStore,
@@ -277,6 +295,7 @@ export class HomeGraphService {
     async generatePacket(input) {
         await this.store.init();
         const { spaceId, installationId } = resolveHomeGraphSpace(input);
+        await this.enrichSpaceSources(spaceId);
         return generateHomeGraphPacket({
             store: this.store,
             artifactStore: this.artifactStore,
@@ -306,6 +325,18 @@ export class HomeGraphService {
         const { spaceId } = resolveReadableHomeGraphSpace(this.store, input);
         return { ok: true, spaceId, sources: readHomeGraphState(this.store, spaceId).sources.slice(0, Math.max(1, input.limit ?? 100)) };
     }
+    async listPages(input = {}) {
+        await this.store.init();
+        const { spaceId } = resolveReadableHomeGraphSpace(this.store, input);
+        const state = readHomeGraphState(this.store, spaceId);
+        return listHomeGraphPages({
+            artifactStore: this.artifactStore,
+            spaceId,
+            sources: state.sources,
+            limit: Math.max(1, input.limit ?? 100),
+            includeMarkdown: input.includeMarkdown !== false,
+        });
+    }
     async browse(input = {}) {
         await this.store.init();
         const { spaceId } = resolveReadableHomeGraphSpace(this.store, input);
@@ -395,7 +426,15 @@ export class HomeGraphService {
         const extraction = await this.extractArtifact(source, input.artifact, input.spaceId, input.installationId);
         const linked = input.target
             ? (await this.linkKnowledge({ knowledgeSpaceId: input.spaceId, sourceId: source.id, target: input.target })).edge
-            : undefined;
+            : (await autoLinkHomeGraphSource({
+                store: this.store,
+                spaceId: input.spaceId,
+                installationId: input.installationId,
+                source,
+                ...(extraction ? { extraction } : {}),
+                state: readHomeGraphState(this.store, input.spaceId),
+            }))?.edge;
+        void this.options.semanticService?.enrichSource(source.id, { knowledgeSpaceId: input.spaceId }).catch(() => { });
         return {
             ok: true,
             spaceId: input.spaceId,
@@ -433,6 +472,18 @@ export class HomeGraphService {
             return undefined;
         }
     }
+    async autoLinkExistingSources(spaceId, installationId) {
+        const state = readHomeGraphState(this.store, spaceId);
+        const extractionBySourceId = new Map(state.extractions.map((extraction) => [extraction.sourceId, extraction]));
+        return autoLinkHomeGraphSources({
+            store: this.store,
+            spaceId,
+            installationId,
+            sources: state.sources,
+            extractionBySourceId,
+            state,
+        });
+    }
     async upsertHomeNode(spaceId, installationId, input) {
         return this.store.upsertNode({
             id: homeGraphNodeId(spaceId, 'ha_home', input.homeId ?? installationId),
@@ -517,6 +568,12 @@ export class HomeGraphService {
     async refreshQualityIssues(spaceId, installationId) {
         return refreshHomeGraphQualityIssues(this.store, spaceId, installationId);
     }
+    async enrichSpaceSources(spaceId) {
+        if (!this.options.semanticService)
+            return;
+        const sources = readHomeGraphSearchState(this.store, spaceId).sources;
+        await this.options.semanticService.enrichSources(sources, { knowledgeSpaceId: spaceId });
+    }
     resolveLinkSource(spaceId, input) {
         if (input.sourceId) {
             const source = this.store.getSource(input.sourceId);

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

@@ -3,7 +3,7 @@ export declare const HOME_GRAPH_NODE_KINDS: readonly ["ha_home", "ha_entity", "h
 export type HomeGraphNodeKind = typeof HOME_GRAPH_NODE_KINDS[number];
 export declare const HOME_GRAPH_RELATIONS: readonly ["controls", "located_in", "belongs_to_device", "has_manual", "has_receipt", "has_warranty", "has_issue", "fixed_by", "uses_battery", "connected_via", "part_of_network", "mentioned_by", "source_for"];
 export type HomeGraphRelation = typeof HOME_GRAPH_RELATIONS[number];
-export declare const HOME_GRAPH_CAPABILITIES: readonly ["knowledge-space-isolation", "snapshot-sync", "source-backed-ingest", "knowledge-linking", "ask-home-graph", "device-passports", "room-pages", "automatic-page-generation", "visual-knowledge-map", "packets", "source-inventory", "review-queue", "durable-review-decisions", "quality-rule-heuristics", "documentation-candidates", "export-import", "namespace-aware-graph-browse"];
+export declare const HOME_GRAPH_CAPABILITIES: readonly ["knowledge-space-isolation", "snapshot-sync", "source-backed-ingest", "semantic-enrichment", "llm-answer-synthesis", "knowledge-linking", "ask-home-graph", "device-passports", "room-pages", "automatic-page-generation", "visual-knowledge-map", "packets", "source-inventory", "review-queue", "durable-review-decisions", "quality-rule-heuristics", "documentation-candidates", "export-import", "namespace-aware-graph-browse"];
 export type HomeGraphObjectKind = 'home' | 'entity' | 'device' | 'area' | 'automation' | 'script' | 'scene' | 'label' | 'integration' | 'room' | 'device_passport' | 'maintenance_item' | 'troubleshooting_case' | 'purchase' | 'network_node';
 export interface HomeGraphSpaceInput {
     readonly installationId?: string;
@@ -163,6 +163,9 @@ export interface HomeGraphAskResult {
         readonly confidence: number;
         readonly sources: readonly KnowledgeSourceRecord[];
         readonly linkedObjects: readonly KnowledgeNodeRecord[];
+        readonly facts?: readonly KnowledgeNodeRecord[];
+        readonly gaps?: readonly KnowledgeNodeRecord[];
+        readonly synthesized?: boolean;
     };
     readonly results: readonly HomeGraphSearchResult[];
 }
@@ -216,6 +219,24 @@ export interface HomeGraphReindexResult {
         readonly sourceId: string;
         readonly error: string;
     }[];
+    readonly linked?: readonly {
+        readonly edge: KnowledgeEdgeRecord;
+        readonly node: KnowledgeNodeRecord;
+        readonly relation: string;
+        readonly score: number;
+        readonly reasons: readonly string[];
+    }[];
+    readonly generated?: HomeGraphGeneratedPagesSummary;
+    readonly semantic?: {
+        readonly scanned: number;
+        readonly enriched: number;
+        readonly skipped: number;
+        readonly failed: number;
+        readonly errors: readonly {
+            readonly sourceId: string;
+            readonly error: string;
+        }[];
+    };
 }
 export interface HomeGraphSearchResult {
     readonly kind: 'source' | 'node';
@@ -258,6 +279,15 @@ export interface HomeGraphDevicePassportResult extends HomeGraphProjectionResult
     readonly passport: KnowledgeNodeRecord;
     readonly missingFields: readonly string[];
 }
+export interface HomeGraphPageListResult {
+    readonly ok: true;
+    readonly spaceId: string;
+    readonly pages: readonly {
+        readonly source: KnowledgeSourceRecord;
+        readonly artifact?: HomeGraphProjectionResult['artifact'];
+        readonly markdown?: string;
+    }[];
+}
 export interface HomeGraphReviewInput extends HomeGraphSpaceInput {
     readonly issueId?: string;
     readonly nodeId?: string;