@pellux/goodvibes-sdk 0.27.1 → 0.27.3

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

@@ -1,5 +1,7 @@
 import { renderKnowledgeMap } from '../map.js';
-import { edgeIsActive, isGeneratedPageSource } from './helpers.js';
+import { countFacet, normalizeStringArray, readString } from '../map-filters.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)
@@ -27,33 +29,53 @@ export function renderRoomPage(state, areaId) {
         '',
         `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,
+        }),
         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),
+        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');
 }
@@ -77,11 +99,132 @@ export function renderPacketPage(state, options = {}) {
     ].filter(Boolean).join('\n');
 }
 export function renderHomeGraphMap(state, options = {}) {
-    return renderKnowledgeMap(state, {
+    const filtered = applyHomeGraphMapFilters(state, options.ha);
+    const result = renderKnowledgeMap(filtered, {
         ...options,
         title: state.title,
         spaceId: state.spaceId,
     });
+    return {
+        ...result,
+        facets: {
+            ...result.facets,
+            homeAssistant: buildHomeAssistantMapFacets(state),
+        },
+    };
+}
+function applyHomeGraphMapFilters(state, input) {
+    const filters = normalizeHomeGraphMapFilters(input);
+    if (!hasHomeGraphFilters(filters))
+        return state;
+    const nodes = state.nodes.filter((node) => matchesHomeGraphNode(node, state.edges, filters, state.nodes));
+    const nodeIds = new Set(nodes.map((node) => node.id));
+    const sourceIds = sourceIdsLinkedToNodes(state.edges, nodeIds);
+    const sources = state.sources.filter((source) => sourceIds.has(source.id) || matchesHomeGraphSource(source, filters));
+    const sourceSet = new Set(sources.map((source) => source.id));
+    const issues = state.issues.filter((issue) => ((issue.nodeId && nodeIds.has(issue.nodeId))
+        || (issue.sourceId && sourceSet.has(issue.sourceId))));
+    const visibleIds = new Set([...nodeIds, ...sourceSet, ...issues.map((issue) => issue.id)]);
+    const edges = state.edges.filter((edge) => visibleIds.has(edge.fromId) && visibleIds.has(edge.toId));
+    return { ...state, nodes, sources, issues, edges };
+}
+function buildHomeAssistantMapFacets(state) {
+    return {
+        objectKinds: countFacet(state.nodes.map((node) => readHomeAssistantRecord(node).objectKind ?? node.kind)),
+        entityIds: countFacet(state.nodes.map((node) => readHomeAssistantRecord(node).entityId)),
+        deviceIds: countFacet(state.nodes.map((node) => readHomeAssistantRecord(node).deviceId)),
+        areaIds: countFacet(state.nodes.map((node) => readHomeAssistantRecord(node).areaId)),
+        integrationIds: countFacet(state.nodes.map((node) => readHomeAssistantRecord(node).integrationId)),
+        integrationDomains: countFacet(state.nodes.map((node) => readIntegrationDomain(node))),
+        domains: countFacet(state.nodes.map((node) => readEntityDomain(node))),
+        deviceClasses: countFacet(state.nodes.map((node) => readDeviceClass(node))),
+        labels: countFacet(state.nodes.flatMap((node) => normalizeStringArray(node.metadata.labels))),
+    };
+}
+function normalizeHomeGraphMapFilters(input) {
+    return {
+        objectKinds: normalizeStringArray(input?.objectKinds),
+        entityIds: normalizeStringArray(input?.entityIds),
+        deviceIds: normalizeStringArray(input?.deviceIds),
+        areaIds: normalizeStringArray(input?.areaIds),
+        integrationIds: normalizeStringArray(input?.integrationIds),
+        integrationDomains: normalizeStringArray(input?.integrationDomains),
+        domains: normalizeStringArray(input?.domains),
+        deviceClasses: normalizeStringArray(input?.deviceClasses),
+        labels: normalizeStringArray(input?.labels),
+    };
+}
+function hasHomeGraphFilters(filters) {
+    return Object.values(filters).some((value) => value.length > 0);
+}
+function matchesHomeGraphNode(node, edges, filters, nodes) {
+    const ha = readHomeAssistantRecord(node);
+    return matchesFilter(filters.objectKinds, String(ha.objectKind ?? node.kind), node.kind)
+        && matchesFilter(filters.entityIds, readString(ha.entityId), readString(ha.objectId))
+        && matchesFilter(filters.deviceIds, readString(ha.deviceId), node.kind === 'ha_device' ? readString(ha.objectId) : undefined)
+        && matchesAreaFilter(filters.areaIds, node, edges, nodes)
+        && matchesFilter(filters.integrationIds, readString(ha.integrationId), node.kind === 'ha_integration' ? readString(ha.objectId) : undefined)
+        && matchesFilter(filters.integrationDomains, readIntegrationDomain(node))
+        && matchesFilter(filters.domains, readEntityDomain(node))
+        && matchesFilter(filters.deviceClasses, readDeviceClass(node))
+        && matchesAny(filters.labels, normalizeStringArray(node.metadata.labels));
+}
+function matchesHomeGraphSource(source, filters) {
+    return matchesAny(filters.labels, [...source.tags, ...normalizeStringArray(source.metadata.labels)]);
+}
+function matchesAreaFilter(areaIds, node, edges, nodes) {
+    if (areaIds.length === 0)
+        return true;
+    const ha = readHomeAssistantRecord(node);
+    if (matchesFilter(areaIds, readString(ha.areaId), node.kind === 'ha_area' || node.kind === 'ha_room' ? readString(ha.objectId) : undefined)) {
+        return true;
+    }
+    const targetAreaNodeIds = new Set(nodes
+        .filter((candidate) => (candidate.kind === 'ha_area' || candidate.kind === 'ha_room')
+        && matchesFilter(areaIds, readString(readHomeAssistantRecord(candidate).objectId), readString(readHomeAssistantRecord(candidate).areaId)))
+        .map((candidate) => candidate.id));
+    return edges.some((edge) => edgeIsActive(edge)
+        && edge.fromId === node.id
+        && edge.relation === 'located_in'
+        && targetAreaNodeIds.has(edge.toId));
+}
+function sourceIdsLinkedToNodes(edges, nodeIds) {
+    const sourceIds = new Set();
+    for (const edge of edges) {
+        if (edge.fromKind === 'source' && edge.toKind === 'node' && nodeIds.has(edge.toId))
+            sourceIds.add(edge.fromId);
+        if (edge.fromKind === 'node' && nodeIds.has(edge.fromId) && edge.toKind === 'source')
+            sourceIds.add(edge.toId);
+    }
+    return sourceIds;
+}
+function readHomeAssistantRecord(node) {
+    const value = node.metadata.homeAssistant;
+    return value && typeof value === 'object' && !Array.isArray(value) ? value : {};
+}
+function readIntegrationDomain(node) {
+    const ha = readHomeAssistantRecord(node);
+    return readString(ha.integrationId)
+        ?? readString(node.metadata.integrationDomain)
+        ?? readString(node.metadata.platform)
+        ?? readString(node.metadata.domain);
+}
+function readEntityDomain(node) {
+    const entityId = readString(readHomeAssistantRecord(node).entityId);
+    const fromEntity = entityId?.includes('.') ? entityId.split('.')[0] : undefined;
+    return fromEntity ?? readString(node.metadata.domain);
+}
+function readDeviceClass(node) {
+    const attributes = node.metadata.attributes && typeof node.metadata.attributes === 'object' && !Array.isArray(node.metadata.attributes)
+        ? node.metadata.attributes
+        : {};
+    return readString(node.metadata.deviceClass) ?? readString(node.metadata.device_class) ?? readString(attributes.device_class);
+}
+function matchesFilter(allowed, ...values) {
+    return allowed.length === 0 || values.some((value) => value !== undefined && allowed.includes(value));
+}
+function matchesAny(allowed, values) {
+    return allowed.length === 0 || values.some((value) => allowed.includes(value));
 }
 function renderNodeList(title, nodes) {
     if (nodes.length === 0)
@@ -93,6 +236,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 '';

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;AAErB,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAqGxD,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,CAmFzB;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;AAuMD,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;AAGrB,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAqGxD,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,CAmFzB;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;AAwMD,wBAAgB,8BAA8B,CAAC,UAAU,EAAE,yBAAyB,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,CAWhH"}

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

@@ -1,4 +1,5 @@
 import { belongsToSpace, edgeIsActive, isGeneratedPageSource, readRecord } from './helpers.js';
+import { isUnusableHomeGraphExtractionText } from './extraction-quality.js';
 const MAX_FIELD_CHARS = 4_096;
 const MAX_SECTION_COUNT = 32;
 const MAX_SEARCH_TEXT_CHARS = 64 * 1024;
@@ -258,12 +259,13 @@ function readSearchText(extraction) {
         return undefined;
     const structure = readRecord(extraction.structure);
     const metadata = readRecord(extraction.metadata);
-    return firstBoundedText([
+    const text = firstBoundedText([
         structure.searchText,
         structure.text,
         structure.content,
         metadata.searchText,
     ], MAX_SEARCH_TEXT_CHARS);
+    return isUnusableHomeGraphExtractionText(text) ? undefined : text;
 }
 function readNodeMetadataText(node) {
     const homeAssistant = readRecord(node.metadata.homeAssistant);
@@ -520,11 +522,7 @@ function usefulExtractionSummary(extraction) {
     return summary && !isLowInformationExtractionText(summary) ? summary : undefined;
 }
 function isLowInformationExtractionText(value) {
-    const normalized = value.toLowerCase();
-    return normalized.includes('pdf extraction produced limited text')
-        || normalized.includes('no readable text streams')
-        || normalized.includes('no specialized extractor matched')
-        || normalized.includes('has no specialized in-core extractor');
+    return isUnusableHomeGraphExtractionText(value);
 }
 function sentenceChunks(value) {
     const text = cleanWhitespace(value ?? '');

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

@@ -2,7 +2,7 @@ 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 { 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;
@@ -41,6 +41,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,6 +72,7 @@ export declare class HomeGraphService {
     }>;
     private ingestCreatedArtifact;
     private extractArtifact;
+    private autoLinkExistingSources;
     private upsertHomeNode;
     private upsertSnapshotObjects;
     private linkSnapshotObjectRelations;

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;AAuB9E,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

@@ -5,8 +5,11 @@ import { refreshHomeGraphQualityIssues } from './quality.js';
 import { reviewHomeGraphFact } from './review.js';
 import { collectLinkedObjects, inferHomeGraphSourceType, readHomeGraphState, renderAskAnswer, renderHomeGraphState, safeHomeGraphFilename, } from './state.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';
 import { HOME_GRAPH_CAPABILITIES } from './types.js';
@@ -61,6 +64,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,
@@ -227,13 +231,22 @@ export class HomeGraphService {
         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 generated = reindex.reparsed > 0 || linked.length > 0
+            ? await refreshAutomaticHomeGraphPages({ store: this.store, artifactStore: this.artifactStore, spaceId, installationId })
+            : undefined;
+        return {
+            ...reindex,
+            ...(linked.length > 0 ? { linked } : {}),
+            ...(generated ? { generated } : {}),
+        };
     }
     async repairWeakExtractionsForAsk(spaceId, installationId, query, state) {
         const candidates = selectHomeGraphExtractionRepairCandidates(query, state.sources, state.nodes, state.edges, (sourceId) => state.extractionBySourceId.get(sourceId), 8);
@@ -246,6 +259,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;
         }
@@ -305,6 +328,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);
@@ -323,8 +358,8 @@ export class HomeGraphService {
         await this.store.init();
         const { spaceId } = resolveReadableHomeGraphSpace(this.store, input);
         return renderHomeGraphMap(renderHomeGraphState(this.store, spaceId, 'Home Graph Map'), {
-            limit: input.limit,
-            includeSources: input.includeSources,
+            ...input,
+            knowledgeSpaceId: spaceId,
         });
     }
     async exportSpace(input = {}) {
@@ -394,7 +429,14 @@ 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;
         return {
             ok: true,
             spaceId: input.spaceId,
@@ -432,6 +474,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),
@@ -565,5 +619,5 @@ export class HomeGraphService {
 }
 function extractionHasSearchableText(extraction) {
     const structure = readRecord(extraction.structure);
-    return typeof structure.searchText === 'string' && structure.searchText.trim().length > 0;
+    return typeof structure.searchText === 'string' && !isUnusableHomeGraphExtractionText(structure.searchText);
 }

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

@@ -1,4 +1,4 @@
-import type { KnowledgeEdgeRecord, KnowledgeExtractionRecord, KnowledgeIssueRecord, KnowledgeMapEdge, KnowledgeMapNode, KnowledgeMapResult, KnowledgeNodeRecord, KnowledgeSourceRecord } from '../types.js';
+import type { KnowledgeEdgeRecord, KnowledgeExtractionRecord, KnowledgeIssueRecord, KnowledgeMapFilterInput, KnowledgeMapEdge, KnowledgeMapNode, KnowledgeMapResult, KnowledgeNodeRecord, KnowledgeSourceRecord } from '../types.js';
 export declare const HOME_GRAPH_NODE_KINDS: readonly ["ha_home", "ha_entity", "ha_device", "ha_area", "ha_automation", "ha_script", "ha_scene", "ha_label", "ha_integration", "ha_room", "ha_device_passport", "ha_maintenance_item", "ha_troubleshooting_case", "ha_purchase", "ha_network_node"];
 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"];
@@ -169,6 +169,35 @@ export interface HomeGraphAskResult {
 export interface HomeGraphMapInput extends HomeGraphSpaceInput {
     readonly limit?: number;
     readonly includeSources?: boolean;
+    readonly includeIssues?: boolean;
+    readonly includeGenerated?: boolean;
+    readonly filters?: KnowledgeMapFilterInput;
+    readonly query?: string;
+    readonly recordKinds?: readonly ('source' | 'node' | 'issue')[];
+    readonly ids?: readonly string[];
+    readonly linkedToIds?: readonly string[];
+    readonly nodeKinds?: readonly string[];
+    readonly sourceTypes?: readonly string[];
+    readonly sourceStatuses?: readonly string[];
+    readonly nodeStatuses?: readonly string[];
+    readonly issueCodes?: readonly string[];
+    readonly issueStatuses?: readonly string[];
+    readonly issueSeverities?: readonly string[];
+    readonly edgeRelations?: readonly string[];
+    readonly tags?: readonly string[];
+    readonly minConfidence?: number;
+    readonly ha?: HomeGraphMapHaFilterInput;
+}
+export interface HomeGraphMapHaFilterInput {
+    readonly objectKinds?: readonly string[];
+    readonly entityIds?: readonly string[];
+    readonly deviceIds?: readonly string[];
+    readonly areaIds?: readonly string[];
+    readonly integrationIds?: readonly string[];
+    readonly integrationDomains?: readonly string[];
+    readonly domains?: readonly string[];
+    readonly deviceClasses?: readonly string[];
+    readonly labels?: readonly string[];
 }
 export type HomeGraphMapNode = KnowledgeMapNode;
 export type HomeGraphMapEdge = KnowledgeMapEdge;
@@ -187,6 +216,14 @@ 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;
 }
 export interface HomeGraphSearchResult {
     readonly kind: 'source' | 'node';
@@ -229,6 +266,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;