@pellux/goodvibes-sdk 0.27.1 → 0.27.3

package/dist/_internal/platform/knowledge/home-graph/auto-link.js

@@ -0,0 +1,236 @@
+import { buildHomeGraphMetadata, edgeIsActive, isGeneratedPageSource, readRecord, uniqueStrings, } from './helpers.js';
+const MIN_AUTO_LINK_SCORE = 90;
+const MIN_SOURCE_TEXT_CHARS = 16;
+const MAX_TEXT_FIELD_CHARS = 32_768;
+const GENERIC_TOKENS = new Set(['device', 'home', 'assistant', 'smart', 'manual', 'owner', 'guide', 'user', 'the']);
+export async function autoLinkHomeGraphSource(input) {
+    if (isGeneratedPageSource(input.source) || shouldSkipAutoLink(input.source))
+        return undefined;
+    if (hasActiveSourceLink(input.source.id, input.state.edges))
+        return undefined;
+    const candidates = scoreCandidates(input.source, input.extraction, input.state);
+    const best = candidates[0];
+    if (!best || best.score < MIN_AUTO_LINK_SCORE)
+        return undefined;
+    const next = candidates[1];
+    if (next && best.score - next.score < 20 && !best.reasons.some((reason) => reason.startsWith('exact-model:'))) {
+        return undefined;
+    }
+    const relation = inferRelation(input.source);
+    const edge = await input.store.upsertEdge({
+        fromKind: 'source',
+        fromId: input.source.id,
+        toKind: 'node',
+        toId: best.node.id,
+        relation,
+        weight: Math.min(5, Math.max(1, Math.round(best.score / 60))),
+        metadata: buildHomeGraphMetadata(input.spaceId, input.installationId, {
+            linkStatus: 'active',
+            linkMethod: 'homegraph-auto-link',
+            autoLinkedAt: Date.now(),
+            autoLinkScore: best.score,
+            autoLinkReasons: best.reasons,
+        }),
+    });
+    return { edge, node: best.node, relation, score: best.score, reasons: best.reasons };
+}
+export async function autoLinkHomeGraphSources(input) {
+    const linked = [];
+    for (const source of input.sources) {
+        const result = await autoLinkHomeGraphSource({
+            store: input.store,
+            spaceId: input.spaceId,
+            installationId: input.installationId,
+            source,
+            extraction: input.extractionBySourceId.get(source.id),
+            state: {
+                ...input.state,
+                edges: [...input.state.edges, ...linked.map((entry) => entry.edge)],
+            },
+        });
+        if (result)
+            linked.push(result);
+    }
+    return linked;
+}
+function scoreCandidates(source, extraction, state) {
+    const sourceText = sourceEvidenceText(source, extraction);
+    if (sourceText.length < MIN_SOURCE_TEXT_CHARS)
+        return [];
+    const lower = sourceText.toLowerCase();
+    const sourceTokens = new Set(tokenize(sourceText));
+    return state.nodes
+        .filter((node) => isAutoLinkCandidateNode(node))
+        .map((node) => {
+        const reasons = [];
+        let score = 0;
+        const identity = nodeIdentity(node, state);
+        for (const model of identity.models) {
+            if (model.length >= 4 && includesIdentity(lower, model)) {
+                score += model.length >= 8 ? 180 : 120;
+                reasons.push(`exact-model:${model}`);
+            }
+        }
+        for (const entityId of identity.entityIds) {
+            if (includesIdentity(lower, entityId)) {
+                score += 140;
+                reasons.push(`entity-id:${entityId}`);
+            }
+        }
+        for (const deviceId of identity.deviceIds) {
+            if (includesIdentity(lower, deviceId)) {
+                score += 120;
+                reasons.push(`device-id:${deviceId}`);
+            }
+        }
+        const titleTokens = tokenize(node.title).filter((token) => !isGenericToken(token));
+        const overlap = titleTokens.filter((token) => sourceTokens.has(token));
+        if (overlap.length > 0) {
+            score += overlap.reduce((sum, token) => sum + (token.length <= 3 ? 12 : 18), 0);
+            reasons.push(`title:${overlap.slice(0, 5).join(',')}`);
+        }
+        const manufacturerMatches = identity.manufacturers.filter((manufacturer) => includesIdentity(lower, manufacturer));
+        if (manufacturerMatches.length > 0) {
+            score += 28;
+            reasons.push(`manufacturer:${manufacturerMatches[0]}`);
+        }
+        const relatedEntityMatches = identity.relatedEntityTokens.filter((token) => sourceTokens.has(token));
+        if (relatedEntityMatches.length > 0) {
+            score += Math.min(50, relatedEntityMatches.length * 10);
+            reasons.push(`related-entity:${relatedEntityMatches.slice(0, 5).join(',')}`);
+        }
+        if (node.kind === 'ha_device' && isManualLikeSource(source))
+            score += 16;
+        if (node.kind === 'ha_integration' && isIntegrationDocumentationSource(source))
+            score += 40;
+        if (node.kind === 'ha_integration' && isManualLikeSource(source))
+            score -= 45;
+        return { node, score, reasons };
+    })
+        .filter((entry) => entry.score > 0)
+        .sort((left, right) => right.score - left.score || left.node.id.localeCompare(right.node.id));
+}
+function shouldSkipAutoLink(source) {
+    const kind = typeof source.metadata.homeGraphSourceKind === 'string' ? source.metadata.homeGraphSourceKind : '';
+    return kind === 'snapshot' || kind === 'generated-page';
+}
+function hasActiveSourceLink(sourceId, edges) {
+    return edges.some((edge) => edgeIsActive(edge) && ((edge.fromKind === 'source' && edge.fromId === sourceId && edge.toKind === 'node')
+        || (edge.fromKind === 'node' && edge.toKind === 'source' && edge.toId === sourceId)));
+}
+function isAutoLinkCandidateNode(node) {
+    return node.kind === 'ha_device'
+        || node.kind === 'ha_entity'
+        || node.kind === 'ha_integration'
+        || node.kind === 'ha_area'
+        || node.kind === 'ha_room';
+}
+function sourceEvidenceText(source, extraction) {
+    const structure = readRecord(extraction?.structure);
+    return uniqueStrings([
+        source.title,
+        source.summary,
+        source.description,
+        source.sourceUri,
+        source.canonicalUri,
+        source.tags.join(' '),
+        extraction?.title,
+        extraction?.summary,
+        extraction?.excerpt,
+        ...(extraction?.sections ?? []),
+        readString(structure.searchText),
+    ]).join('\n').slice(0, MAX_TEXT_FIELD_CHARS);
+}
+function nodeIdentity(node, state) {
+    const homeAssistant = readRecord(node.metadata.homeAssistant);
+    const relatedEntities = node.kind === 'ha_device'
+        ? relatedEntityNodes(node.id, state)
+        : [];
+    return {
+        models: uniqueStrings([
+            readString(node.metadata.model),
+            readString(node.metadata.modelId),
+            readString(node.metadata.model_id),
+        ]),
+        manufacturers: uniqueStrings([
+            readString(node.metadata.manufacturer),
+            readString(node.metadata.vendor),
+        ]),
+        entityIds: uniqueStrings([
+            readString(homeAssistant.entityId),
+            ...relatedEntities.map((entity) => readString(readRecord(entity.metadata.homeAssistant).entityId)),
+        ]),
+        deviceIds: uniqueStrings([
+            readString(homeAssistant.deviceId),
+            node.kind === 'ha_device' ? readString(homeAssistant.objectId) : undefined,
+        ]),
+        relatedEntityTokens: uniqueStrings(relatedEntities.flatMap((entity) => [
+            ...tokenize(entity.title),
+            ...tokenize(readString(readRecord(entity.metadata.homeAssistant).entityId) ?? ''),
+            readString(entity.metadata.domain),
+            readString(entity.metadata.platform),
+        ])),
+    };
+}
+function relatedEntityNodes(deviceNodeId, state) {
+    const entityIds = new Set(state.edges.filter((edge) => (edgeIsActive(edge)
+        && edge.fromKind === 'node'
+        && edge.toKind === 'node'
+        && edge.toId === deviceNodeId
+        && edge.relation === 'belongs_to_device')).map((edge) => edge.fromId));
+    return state.nodes.filter((node) => entityIds.has(node.id) && node.kind === 'ha_entity');
+}
+function inferRelation(source) {
+    const tags = source.tags.map((tag) => tag.toLowerCase());
+    const text = [source.sourceType, source.title, source.sourceUri, ...tags].join(' ').toLowerCase();
+    if (text.includes('receipt'))
+        return 'has_receipt';
+    if (text.includes('warranty'))
+        return 'has_warranty';
+    if (isManualLikeSource(source))
+        return 'has_manual';
+    return 'source_for';
+}
+function isManualLikeSource(source) {
+    const tags = source.tags.map((tag) => tag.toLowerCase());
+    const text = [source.sourceType, source.title, source.sourceUri, ...tags].join(' ').toLowerCase();
+    return source.sourceType === 'manual'
+        || tags.includes('manual')
+        || tags.includes('artifact')
+        || tags.includes('document')
+        || /\bmanual\b|\.pdf\b|owner.?s guide|user guide/.test(text);
+}
+function isIntegrationDocumentationSource(source) {
+    const tags = source.tags.map((tag) => tag.toLowerCase());
+    const kind = typeof source.metadata.homeGraphSourceKind === 'string'
+        ? source.metadata.homeGraphSourceKind.toLowerCase()
+        : '';
+    return tags.includes('integration') || tags.includes('documentation') || kind === 'documentation-candidate';
+}
+function tokenize(value) {
+    return uniqueStrings(value.toLowerCase().split(/[^a-z0-9_.:-]+/).filter((token) => token.length >= 2));
+}
+function isGenericToken(value) {
+    return GENERIC_TOKENS.has(value);
+}
+function includesIdentity(haystack, identity) {
+    const normalized = identity.trim().toLowerCase();
+    if (!normalized)
+        return false;
+    if (/^[a-z0-9_.:-]+$/.test(normalized)) {
+        return new RegExp(`(?:^|[^a-z0-9])${escapeRegExp(normalized)}(?:$|[^a-z0-9])`).test(haystack);
+    }
+    return haystack.includes(normalized);
+}
+function readString(value) {
+    if (typeof value === 'string') {
+        const trimmed = value.trim();
+        return trimmed.length > 0 ? trimmed : undefined;
+    }
+    if (typeof value === 'number' && Number.isFinite(value))
+        return String(value);
+    return undefined;
+}
+function escapeRegExp(value) {
+    return value.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+}

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

@@ -0,0 +1,2 @@
+export declare function isUnusableHomeGraphExtractionText(value: string | undefined): boolean;
+//# sourceMappingURL=extraction-quality.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"extraction-quality.d.ts","sourceRoot":"","sources":["../../../../../src/_internal/platform/knowledge/home-graph/extraction-quality.ts"],"names":[],"mappings":"AAAA,wBAAgB,iCAAiC,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAYpF"}

package/dist/_internal/platform/knowledge/home-graph/extraction-quality.js

@@ -0,0 +1,52 @@
+export function isUnusableHomeGraphExtractionText(value) {
+    const text = value?.trim() ?? '';
+    if (!text)
+        return true;
+    const normalized = text.toLowerCase();
+    if (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 true;
+    }
+    if (looksLikeRawPdfPayload(text))
+        return true;
+    return looksBinaryLike(text);
+}
+function looksLikeRawPdfPayload(value) {
+    const lower = value.toLowerCase();
+    return lower.includes('%pdf')
+        || /\b\d+\s+\d+\s+obj\b/.test(lower)
+        || (lower.includes(' endobj') && lower.includes(' stream'))
+        || (lower.includes('/filter') && lower.includes('/flatedecode'));
+}
+function looksBinaryLike(value) {
+    const sample = value.slice(0, 4_096);
+    if (sample.length < 120)
+        return false;
+    let control = 0;
+    let extended = 0;
+    let letters = 0;
+    let whitespace = 0;
+    let punctuation = 0;
+    for (const char of sample) {
+        const code = char.charCodeAt(0);
+        if ((code < 32 && char !== '\n' && char !== '\r' && char !== '\t') || code === 65533)
+            control += 1;
+        if (code > 126)
+            extended += 1;
+        if (/[a-z0-9]/i.test(char))
+            letters += 1;
+        if (/\s/.test(char))
+            whitespace += 1;
+        if (/[^a-z0-9\s]/i.test(char))
+            punctuation += 1;
+    }
+    const length = sample.length;
+    const extendedRatio = extended / length;
+    const usefulRatio = (letters + whitespace) / length;
+    const punctuationRatio = punctuation / length;
+    return control > 0
+        || (extendedRatio > 0.18 && usefulRatio < 0.78)
+        || (punctuationRatio > 0.42 && whitespace / length < 0.08);
+}

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

@@ -10,6 +10,7 @@ interface HomeGraphPageContext {
 export declare function generateAutomaticHomeGraphPages(context: HomeGraphPageContext & {
     readonly input: HomeGraphSnapshotInput;
 }): Promise<HomeGraphGeneratedPagesSummary>;
+export declare function refreshAutomaticHomeGraphPages(context: HomeGraphPageContext): Promise<HomeGraphGeneratedPagesSummary>;
 export declare function refreshHomeGraphDevicePassport(context: HomeGraphPageContext & {
     readonly input: HomeGraphProjectionInput;
 }): Promise<HomeGraphDevicePassportResult & {

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,CAoEzC;AAED,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,CA0EhF;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;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,CA0EhF;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

@@ -3,13 +3,19 @@ import { HOME_GRAPH_CONNECTOR_ID, buildHomeGraphMetadata, edgeIsActive, homeGrap
 import { findHomeAssistantNode, missingDevicePassportFields, readHomeGraphState, renderHomeGraphState, safeHomeGraphFilename, sourcesLinkedToNode, } from './state.js';
 import { renderDevicePassportPage, renderPacketPage, renderRoomPage, } from './rendering.js';
 export async function generateAutomaticHomeGraphPages(context) {
-    const options = context.input.pageAutomation ?? {};
+    return generateHomeGraphPagesForCurrentState(context, context.input.pageAutomation ?? {});
+}
+export async function refreshAutomaticHomeGraphPages(context) {
+    return generateHomeGraphPagesForCurrentState(context, {});
+}
+async function generateHomeGraphPagesForCurrentState(context, options) {
+    const effectiveOptions = options ?? {};
     const summary = createGeneratedPagesSummary();
-    if (options.enabled === false)
+    if (effectiveOptions.enabled === false)
         return summary;
     const state = readHomeGraphState(context.store, context.spaceId);
-    if (options.devicePassports !== false) {
-        const devices = limitRecords(state.nodes.filter((node) => node.kind === 'ha_device' && node.status !== 'stale').sort(compareByTitle), options.maxDevicePassports);
+    if (effectiveOptions.devicePassports !== false) {
+        const devices = limitRecords(state.nodes.filter((node) => node.kind === 'ha_device' && node.status !== 'stale').sort(compareByTitle), effectiveOptions.maxDevicePassports);
         for (const device of devices) {
             const deviceId = readHomeAssistantObjectId(device, 'objectId', 'deviceId') ?? device.id;
             try {
@@ -36,10 +42,10 @@ export async function generateAutomaticHomeGraphPages(context) {
             }
         }
     }
-    if (options.roomPages !== false) {
+    if (effectiveOptions.roomPages !== false) {
         const rooms = limitRecords(state.nodes
             .filter((node) => (node.kind === 'ha_area' || node.kind === 'ha_room') && node.status !== 'stale')
-            .sort(compareByTitle), options.maxRoomPages);
+            .sort(compareByTitle), effectiveOptions.maxRoomPages);
         for (const room of rooms) {
             const areaId = readHomeAssistantObjectId(room, 'objectId', 'areaId') ?? room.id;
             try {
@@ -109,7 +115,7 @@ export async function refreshHomeGraphDevicePassport(context) {
         relation: 'source_for',
         metadata: buildHomeGraphMetadata(spaceId, installationId),
     });
-    const markdown = renderDevicePassportPage({ spaceId, device, entities, sources, issues, missingFields });
+    const markdown = renderDevicePassportPage({ spaceId, device, entities, sources, extractions: state.extractions, issues, missingFields });
     const generated = await materializeGeneratedMarkdown({
         store,
         artifactStore,
@@ -147,7 +153,7 @@ export async function generateHomeGraphRoomPage(context) {
     const state = readHomeGraphState(store, spaceId);
     const areaId = input.areaId ?? input.roomId;
     const title = input.title ?? resolveRoomTitle(state.nodes, areaId) ?? 'Home Graph Room';
-    const markdown = renderRoomPage({ ...state, title }, areaId);
+    const markdown = renderRoomPage({ ...state, title, extractions: state.extractions }, areaId);
     const filename = `${safeHomeGraphFilename(title)}.md`;
     const targetNode = areaId
         ? findHomeAssistantNode(state.nodes, 'ha_area', areaId) ?? findHomeAssistantNode(state.nodes, 'ha_room', areaId)

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

@@ -1,4 +1,4 @@
 export { HomeGraphService } from './service.js';
 export { HOME_GRAPH_NODE_KINDS, HOME_GRAPH_RELATIONS, } from './types.js';
-export type { HomeGraphAskInput, HomeGraphAskResult, HomeGraphDevicePassportResult, HomeGraphExport, HomeGraphGeneratedPagesSummary, HomeGraphIngestArtifactInput, HomeGraphIngestNoteInput, HomeGraphIngestResult, HomeGraphIngestUrlInput, HomeGraphKnowledgeTarget, HomeGraphLinkInput, HomeGraphLinkResult, HomeGraphMapEdge, HomeGraphMapInput, HomeGraphMapNode, HomeGraphMapResult, HomeGraphNodeKind, HomeGraphObjectInput, HomeGraphObjectKind, HomeGraphPageAutomationOptions, HomeGraphProjectionInput, HomeGraphProjectionResult, HomeGraphReindexResult, HomeGraphRelation, HomeGraphReviewInput, HomeGraphSnapshotInput, HomeGraphStatus, HomeGraphSyncResult, } from './types.js';
+export type { HomeGraphAskInput, HomeGraphAskResult, HomeGraphDevicePassportResult, HomeGraphExport, HomeGraphGeneratedPagesSummary, HomeGraphIngestArtifactInput, HomeGraphIngestNoteInput, HomeGraphIngestResult, HomeGraphIngestUrlInput, HomeGraphKnowledgeTarget, HomeGraphLinkInput, HomeGraphLinkResult, HomeGraphMapEdge, HomeGraphMapHaFilterInput, HomeGraphMapInput, HomeGraphMapNode, HomeGraphMapResult, HomeGraphNodeKind, HomeGraphObjectInput, HomeGraphObjectKind, HomeGraphPageAutomationOptions, HomeGraphPageListResult, HomeGraphProjectionInput, HomeGraphProjectionResult, HomeGraphReindexResult, HomeGraphRelation, HomeGraphReviewInput, HomeGraphSnapshotInput, HomeGraphStatus, HomeGraphSyncResult, } from './types.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/_internal/platform/knowledge/home-graph/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,EACL,qBAAqB,EACrB,oBAAoB,GACrB,MAAM,YAAY,CAAC;AACpB,YAAY,EACV,iBAAiB,EACjB,kBAAkB,EAClB,6BAA6B,EAC7B,eAAe,EACf,8BAA8B,EAC9B,4BAA4B,EAC5B,wBAAwB,EACxB,qBAAqB,EACrB,uBAAuB,EACvB,wBAAwB,EACxB,kBAAkB,EAClB,mBAAmB,EACnB,gBAAgB,EAChB,iBAAiB,EACjB,gBAAgB,EAChB,kBAAkB,EAClB,iBAAiB,EACjB,oBAAoB,EACpB,mBAAmB,EACnB,8BAA8B,EAC9B,wBAAwB,EACxB,yBAAyB,EACzB,sBAAsB,EACtB,iBAAiB,EACjB,oBAAoB,EACpB,sBAAsB,EACtB,eAAe,EACf,mBAAmB,GACpB,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/_internal/platform/knowledge/home-graph/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,EACL,qBAAqB,EACrB,oBAAoB,GACrB,MAAM,YAAY,CAAC;AACpB,YAAY,EACV,iBAAiB,EACjB,kBAAkB,EAClB,6BAA6B,EAC7B,eAAe,EACf,8BAA8B,EAC9B,4BAA4B,EAC5B,wBAAwB,EACxB,qBAAqB,EACrB,uBAAuB,EACvB,wBAAwB,EACxB,kBAAkB,EAClB,mBAAmB,EACnB,gBAAgB,EAChB,yBAAyB,EACzB,iBAAiB,EACjB,gBAAgB,EAChB,kBAAkB,EAClB,iBAAiB,EACjB,oBAAoB,EACpB,mBAAmB,EACnB,8BAA8B,EAC9B,uBAAuB,EACvB,wBAAwB,EACxB,yBAAyB,EACzB,sBAAsB,EACtB,iBAAiB,EACjB,oBAAoB,EACpB,sBAAsB,EACtB,eAAe,EACf,mBAAmB,GACpB,MAAM,YAAY,CAAC"}

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

@@ -0,0 +1,11 @@
+import type { ArtifactStore } from '../../artifacts/index.js';
+import type { KnowledgeSourceRecord } from '../types.js';
+import type { HomeGraphPageListResult } from './types.js';
+export declare function listHomeGraphPages(input: {
+    readonly artifactStore: ArtifactStore;
+    readonly spaceId: string;
+    readonly sources: readonly KnowledgeSourceRecord[];
+    readonly limit: number;
+    readonly includeMarkdown: boolean;
+}): Promise<HomeGraphPageListResult>;
+//# sourceMappingURL=pages.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"pages.d.ts","sourceRoot":"","sources":["../../../../../src/_internal/platform/knowledge/home-graph/pages.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAEzD,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAE1D,wBAAsB,kBAAkB,CAAC,KAAK,EAAE;IAC9C,QAAQ,CAAC,aAAa,EAAE,aAAa,CAAC;IACtC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,SAAS,qBAAqB,EAAE,CAAC;IACnD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAC;CACnC,GAAG,OAAO,CAAC,uBAAuB,CAAC,CA0BnC"}

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

@@ -0,0 +1,44 @@
+import { isGeneratedPageSource } from './helpers.js';
+export async function listHomeGraphPages(input) {
+    const pages = [];
+    const sources = input.sources
+        .filter(isGeneratedPageSource)
+        .sort(compareGeneratedPages)
+        .slice(0, input.limit);
+    for (const source of sources) {
+        const artifact = typeof source.artifactId === 'string' ? input.artifactStore.get(source.artifactId) : undefined;
+        const markdown = input.includeMarkdown && artifact
+            ? await readMarkdown(input.artifactStore, artifact.id)
+            : undefined;
+        pages.push({
+            source,
+            ...(artifact ? {
+                artifact: {
+                    id: artifact.id,
+                    mimeType: artifact.mimeType,
+                    filename: artifact.filename,
+                    createdAt: artifact.createdAt,
+                    metadata: artifact.metadata,
+                },
+            } : {}),
+            ...(markdown ? { markdown } : {}),
+        });
+    }
+    return { ok: true, spaceId: input.spaceId, pages };
+}
+function compareGeneratedPages(left, right) {
+    const leftKind = typeof left.metadata.projectionKind === 'string' ? left.metadata.projectionKind : '';
+    const rightKind = typeof right.metadata.projectionKind === 'string' ? right.metadata.projectionKind : '';
+    return leftKind.localeCompare(rightKind)
+        || (left.title ?? left.id).localeCompare(right.title ?? right.id)
+        || left.id.localeCompare(right.id);
+}
+async function readMarkdown(artifactStore, artifactId) {
+    try {
+        const { buffer } = await artifactStore.readContent(artifactId);
+        return buffer.toString('utf-8');
+    }
+    catch {
+        return undefined;
+    }
+}

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

@@ -1,5 +1,5 @@
-import type { KnowledgeEdgeRecord, KnowledgeIssueRecord, KnowledgeNodeRecord, KnowledgeSourceRecord } from '../types.js';
-import type { HomeGraphMapResult } 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;
     readonly title: 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,6 +15,7 @@ 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[];
 }): string;
@@ -23,8 +25,5 @@ export declare function renderPacketPage(state: HomeGraphRenderState, options?:
     readonly includeFields?: readonly string[];
     readonly excludeFields?: readonly string[];
 }): string;
-export declare function renderHomeGraphMap(state: HomeGraphRenderState, options?: {
-    readonly limit?: number;
-    readonly includeSources?: boolean;
-}): HomeGraphMapResult;
+export declare function renderHomeGraphMap(state: HomeGraphRenderState, options?: HomeGraphMapInput): HomeGraphMapResult;
 //# sourceMappingURL=rendering.d.ts.map

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,EACpB,mBAAmB,EACnB,qBAAqB,EACtB,MAAM,aAAa,CAAC;AAGrB,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAErD,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;IACvE,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,cAAc,CAAC,EAAE,OAAO,CAAC;CAC9B,GAAG,kBAAkB,CAM1B"}
+{"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,CAiDnF;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;CAC3C,GAAG,MAAM,CA8BT;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"}