@pellux/goodvibes-sdk 0.26.9 → 0.26.11

package/dist/_internal/platform/daemon/http/home-graph-routes.js

@@ -33,12 +33,30 @@ export class HomeGraphRoutes {
                     limit: readLimit(url, 250),
                 }));
             }
+            if (url.pathname === '/api/homeassistant/home-graph/map' && req.method === 'GET') {
+                const result = await this.context.homeGraphService.map({
+                    ...readSpaceFromUrl(url),
+                    limit: readLimit(url, 500),
+                    includeSources: readBoolean(url, 'includeSources', true),
+                });
+                if (url.searchParams.get('format') === 'svg') {
+                    return new Response(result.svg, {
+                        headers: {
+                            'content-type': 'image/svg+xml; charset=utf-8',
+                        },
+                    });
+                }
+                return Response.json(result);
+            }
             if (url.pathname === '/api/homeassistant/home-graph/export' && req.method === 'POST') {
                 return Response.json(await this.context.homeGraphService.exportSpace(await this.readOptionalBody(req)));
             }
             if (url.pathname === '/api/homeassistant/home-graph/ask' && req.method === 'POST') {
                 return Response.json(await this.context.homeGraphService.ask(await this.readBody(req)));
             }
+            if (url.pathname === '/api/homeassistant/home-graph/reindex' && req.method === 'POST') {
+                return await this.admin(req, async () => Response.json(await this.context.homeGraphService.reindex(await this.readOptionalBody(req))));
+            }
             if (url.pathname === '/api/homeassistant/home-graph/sync' && req.method === 'POST') {
                 return await this.admin(req, async () => Response.json(await this.context.homeGraphService.syncSnapshot(await this.readBody(req))));
             }
@@ -118,3 +136,9 @@ function readLimit(url, fallback) {
     const parsed = Number(url.searchParams.get('limit') ?? fallback);
     return Number.isFinite(parsed) ? Math.max(1, Math.trunc(parsed)) : fallback;
 }
+function readBoolean(url, key, fallback) {
+    const value = url.searchParams.get(key);
+    if (value === null)
+        return fallback;
+    return !['0', 'false', 'no', 'off'].includes(value.trim().toLowerCase());
+}

package/dist/_internal/platform/daemon/http/router-route-contexts.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"router-route-contexts.d.ts","sourceRoot":"","sources":["../../../../../src/_internal/platform/daemon/http/router-route-contexts.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"router-route-contexts.d.ts","sourceRoot":"","sources":["../../../../../src/_internal/platform/daemon/http/router-route-contexts.ts"],"names":[],"mappings":"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"}

package/dist/_internal/platform/daemon/http/router-route-contexts.js

@@ -132,6 +132,7 @@ export function buildKnowledgeRouteContext(input) {
             setScheduleEnabled: (id, enabled) => input.knowledgeService.setScheduleEnabled(id, enabled),
             renderProjection: (projection) => input.knowledgeService.renderProjection(projection),
             materializeProjection: (projection) => input.knowledgeService.materializeProjection(projection),
+            map: (mapInput) => input.knowledgeService.map(mapInput),
         },
         knowledgeGraphqlService: input.knowledgeGraphqlService,
     };

package/dist/_internal/platform/knowledge/extractors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"extractors.d.ts","sourceRoot":"","sources":["../../../../src/_internal/platform/knowledge/extractors.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAsB,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAGhF,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,YAAY,CAAC;AAI5D,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,yBAAyB,CAAC;IAC3C,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC5C,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC5C;AA6hBD,wBAAsB,wBAAwB,CAC5C,QAAQ,EAAE,IAAI,CAAC,cAAc,EAAE,IAAI,GAAG,UAAU,GAAG,UAAU,CAAC,EAC9D,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,yBAAyB,CAAC,CA4CpC"}
+{"version":3,"file":"extractors.d.ts","sourceRoot":"","sources":["../../../../src/_internal/platform/knowledge/extractors.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAsB,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAGhF,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,YAAY,CAAC;AAI5D,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,yBAAyB,CAAC;IAC3C,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC5C,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC5C;AAmmBD,wBAAsB,wBAAwB,CAC5C,QAAQ,EAAE,IAAI,CAAC,cAAc,EAAE,IAAI,GAAG,UAAU,GAAG,UAAU,CAAC,EAC9D,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,yBAAyB,CAAC,CA4CpC"}

package/dist/_internal/platform/knowledge/extractors.js

@@ -306,7 +306,79 @@ function extractYaml(buffer) {
         metadata: {},
     };
 }
-function extractPdf(buffer) {
+async function extractPdf(buffer) {
+    const parsed = await extractPdfWithPdfJs(buffer);
+    if (parsed)
+        return parsed;
+    return extractPdfRawStreams(buffer);
+}
+async function extractPdfWithPdfJs(buffer) {
+    try {
+        const pdfjs = await import('pdfjs-dist/legacy/build/pdf.mjs');
+        const loadingTask = pdfjs.getDocument({
+            data: new Uint8Array(buffer),
+            useSystemFonts: true,
+        });
+        const document = await loadingTask.promise;
+        const pageCount = document.numPages;
+        const pageTexts = [];
+        for (let pageNumber = 1; pageNumber <= pageCount; pageNumber += 1) {
+            const page = await document.getPage(pageNumber);
+            const content = await page.getTextContent();
+            const lines = textContentItemsToLines(content.items);
+            if (lines.length > 0)
+                pageTexts.push(lines.join('\n'));
+            page.cleanup();
+        }
+        await document.destroy();
+        const text = cleanText(pageTexts.join('\n\n'));
+        if (!text)
+            return undefined;
+        const searchText = searchTextPayload(text);
+        return {
+            extractorId: 'pdfjs',
+            format: 'pdf',
+            title: firstNonEmptyLine(text) ?? 'PDF document',
+            summary: summarizeText(text) ?? 'PDF document.',
+            excerpt: excerptText(text),
+            sections: uniqueStrings(text.split(/\n+/), 24),
+            links: uniqueStrings(Array.from(text.matchAll(/\bhttps?:\/\/[^\s)]+/g), (match) => match[0]), 50),
+            estimatedTokens: estimateTokens(text),
+            structure: {
+                pageCount,
+                extractedTextChars: text.length,
+                ...(searchText ? { searchText } : {}),
+            },
+            metadata: {
+                limitations: ['PDF text extraction does not perform OCR for scanned images.'],
+            },
+        };
+    }
+    catch {
+        return undefined;
+    }
+}
+function textContentItemsToLines(items) {
+    const lines = [];
+    let current = '';
+    for (const item of items) {
+        const record = unknownRecord(item);
+        const text = typeof record.str === 'string' ? cleanText(record.str) : '';
+        if (text)
+            current = current ? `${current} ${text}` : text;
+        if (record.hasEOL === true && current) {
+            lines.push(current);
+            current = '';
+        }
+    }
+    if (current)
+        lines.push(current);
+    return lines;
+}
+function unknownRecord(value) {
+    return value && typeof value === 'object' ? value : {};
+}
+function extractPdfRawStreams(buffer) {
     const body = buffer.toString('latin1');
     const texts = [];
     const streamRe = /stream\r?\n([\s\S]*?)\r?\nendstream/g;

package/dist/_internal/platform/knowledge/generated-projections.d.ts

@@ -0,0 +1,38 @@
+import type { ArtifactDescriptor } from '../artifacts/types.js';
+import type { ArtifactStore } from '../artifacts/index.js';
+import type { KnowledgeStore } from './store.js';
+import type { KnowledgeEdgeRecord, KnowledgeReferenceKind, KnowledgeSourceRecord, KnowledgeSourceType } from './types.js';
+export interface GeneratedKnowledgeProjectionInput {
+    readonly store: KnowledgeStore;
+    readonly artifactStore: ArtifactStore;
+    readonly connectorId: string;
+    readonly sourceId: string;
+    readonly sourceType?: KnowledgeSourceType;
+    readonly canonicalUri: string;
+    readonly title: string;
+    readonly summary?: string;
+    readonly tags?: readonly string[];
+    readonly filename: string;
+    readonly markdown: string;
+    readonly projectionKind: string;
+    readonly metadata?: Record<string, unknown>;
+    readonly sourceMetadata?: Record<string, unknown>;
+    readonly artifactMetadata?: Record<string, unknown>;
+    readonly edgeMetadata?: Record<string, unknown>;
+    readonly target?: {
+        readonly kind: KnowledgeReferenceKind;
+        readonly id: string;
+        readonly relation?: string;
+    };
+}
+export interface GeneratedKnowledgeProjectionResult {
+    readonly artifact: ArtifactDescriptor;
+    readonly source: KnowledgeSourceRecord;
+    readonly linked?: KnowledgeEdgeRecord;
+    readonly artifactCreated: boolean;
+}
+export declare function generatedKnowledgeSourceId(kind: string, value: string): string;
+export declare function generatedKnowledgeCanonicalUri(kind: string, value: string): string;
+export declare function isGeneratedKnowledgeSource(source: KnowledgeSourceRecord): boolean;
+export declare function materializeGeneratedKnowledgeProjection(input: GeneratedKnowledgeProjectionInput): Promise<GeneratedKnowledgeProjectionResult>;
+//# sourceMappingURL=generated-projections.d.ts.map

package/dist/_internal/platform/knowledge/generated-projections.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generated-projections.d.ts","sourceRoot":"","sources":["../../../../src/_internal/platform/knowledge/generated-projections.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAChE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,KAAK,EACV,mBAAmB,EACnB,sBAAsB,EACtB,qBAAqB,EACrB,mBAAmB,EACpB,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,iCAAiC;IAChD,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC;IAC/B,QAAQ,CAAC,aAAa,EAAE,aAAa,CAAC;IACtC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,UAAU,CAAC,EAAE,mBAAmB,CAAC;IAC1C,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC5C,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClD,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACpD,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChD,QAAQ,CAAC,MAAM,CAAC,EAAE;QAChB,QAAQ,CAAC,IAAI,EAAE,sBAAsB,CAAC;QACtC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;QACpB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;KAC5B,CAAC;CACH;AAED,MAAM,WAAW,kCAAkC;IACjD,QAAQ,CAAC,QAAQ,EAAE,kBAAkB,CAAC;IACtC,QAAQ,CAAC,MAAM,EAAE,qBAAqB,CAAC;IACvC,QAAQ,CAAC,MAAM,CAAC,EAAE,mBAAmB,CAAC;IACtC,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAC;CACnC;AAED,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAE9E;AAED,wBAAgB,8BAA8B,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAElF;AAED,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,qBAAqB,GAAG,OAAO,CAKjF;AAED,wBAAsB,uCAAuC,CAC3D,KAAK,EAAE,iCAAiC,GACvC,OAAO,CAAC,kCAAkC,CAAC,CA+D7C"}

package/dist/_internal/platform/knowledge/generated-projections.js

@@ -0,0 +1,106 @@
+import { createHash } from 'node:crypto';
+export function generatedKnowledgeSourceId(kind, value) {
+    return `kg-gen-${stableHash(`${kind}:${value}`)}`;
+}
+export function generatedKnowledgeCanonicalUri(kind, value) {
+    return `knowledge://generated/${encodeURIComponent(kind)}/${stableHash(value, 20)}`;
+}
+export function isGeneratedKnowledgeSource(source) {
+    return source.metadata.generatedKnowledgePage === true
+        || source.metadata.generatedProjection === true
+        || source.metadata.homeGraphGeneratedPage === true
+        || source.metadata.homeGraphSourceKind === 'generated-page';
+}
+export async function materializeGeneratedKnowledgeProjection(input) {
+    const generatedAt = Date.now();
+    const projectionMetadata = {
+        generatedKnowledgePage: true,
+        generatedProjection: true,
+        projectionKind: input.projectionKind,
+        generatedAt,
+        pageEditable: true,
+        ...(input.metadata ?? {}),
+    };
+    const existing = input.store.getSource(input.sourceId);
+    const reusedArtifact = await findReusableGeneratedArtifact(input.artifactStore, existing, input.markdown);
+    const artifact = reusedArtifact ?? await input.artifactStore.create({
+        kind: 'document',
+        mimeType: 'text/markdown',
+        filename: input.filename,
+        text: input.markdown,
+        retentionMs: 0,
+        metadata: {
+            ...projectionMetadata,
+            ...(input.artifactMetadata ?? {}),
+        },
+    });
+    const source = await input.store.upsertSource({
+        id: input.sourceId,
+        connectorId: input.connectorId,
+        sourceType: input.sourceType ?? 'document',
+        title: input.title,
+        sourceUri: input.canonicalUri,
+        canonicalUri: input.canonicalUri,
+        ...(input.summary ? { summary: input.summary } : {}),
+        tags: uniqueStrings(input.tags ?? []),
+        status: 'indexed',
+        artifactId: artifact.id,
+        lastCrawledAt: generatedAt,
+        metadata: {
+            ...projectionMetadata,
+            artifactId: artifact.id,
+            filename: artifact.filename,
+            ...(input.sourceMetadata ?? {}),
+        },
+    });
+    const linked = input.target
+        ? await input.store.upsertEdge({
+            fromKind: 'source',
+            fromId: source.id,
+            toKind: input.target.kind,
+            toId: input.target.id,
+            relation: input.target.relation ?? 'source_for',
+            metadata: {
+                generatedKnowledgePage: true,
+                generatedProjection: true,
+                projectionKind: input.projectionKind,
+                ...(input.edgeMetadata ?? {}),
+            },
+        })
+        : undefined;
+    return {
+        artifact,
+        source,
+        ...(linked ? { linked } : {}),
+        artifactCreated: !reusedArtifact,
+    };
+}
+async function findReusableGeneratedArtifact(artifactStore, source, markdown) {
+    if (!source?.artifactId)
+        return undefined;
+    const artifact = artifactStore.get(source.artifactId);
+    if (!artifact)
+        return undefined;
+    try {
+        const { buffer } = await artifactStore.readContent(artifact.id);
+        return buffer.toString('utf-8') === markdown ? artifact : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+function stableHash(value, length = 24) {
+    return createHash('sha256').update(value).digest('hex').slice(0, length);
+}
+function uniqueStrings(values) {
+    const seen = new Set();
+    const result = [];
+    for (const value of values) {
+        const trimmed = typeof value === 'string' ? value.trim() : '';
+        if (!trimmed || seen.has(trimmed))
+            continue;
+        seen.add(trimmed);
+        result.push(trimmed);
+    }
+    return result;
+}

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

@@ -0,0 +1,29 @@
+import type { ArtifactStore } from '../../artifacts/index.js';
+import type { KnowledgeStore } from '../store.js';
+import type { HomeGraphDevicePassportResult, HomeGraphGeneratedPagesSummary, HomeGraphProjectionInput, HomeGraphProjectionResult, HomeGraphSnapshotInput } from './types.js';
+interface HomeGraphPageContext {
+    readonly store: KnowledgeStore;
+    readonly artifactStore: ArtifactStore;
+    readonly spaceId: string;
+    readonly installationId: string;
+}
+export declare function generateAutomaticHomeGraphPages(context: HomeGraphPageContext & {
+    readonly input: HomeGraphSnapshotInput;
+}): Promise<HomeGraphGeneratedPagesSummary>;
+export declare function refreshHomeGraphDevicePassport(context: HomeGraphPageContext & {
+    readonly input: HomeGraphProjectionInput;
+}): Promise<HomeGraphDevicePassportResult & {
+    readonly artifactCreated: boolean;
+}>;
+export declare function generateHomeGraphRoomPage(context: HomeGraphPageContext & {
+    readonly input: HomeGraphProjectionInput;
+}): Promise<HomeGraphProjectionResult & {
+    readonly artifactCreated: boolean;
+}>;
+export declare function generateHomeGraphPacket(context: HomeGraphPageContext & {
+    readonly input: HomeGraphProjectionInput;
+}): Promise<HomeGraphProjectionResult & {
+    readonly artifactCreated: boolean;
+}>;
+export {};
+//# sourceMappingURL=generated-pages.d.ts.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,296 @@
+import { materializeGeneratedKnowledgeProjection, } from '../generated-projections.js';
+import { HOME_GRAPH_CONNECTOR_ID, buildHomeGraphMetadata, edgeIsActive, homeGraphNodeId, homeGraphSourceId, isGeneratedPageSource, namespacedCanonicalUri, readRecord, uniqueStrings, } from './helpers.js';
+import { findHomeAssistantNode, missingDevicePassportFields, readHomeGraphState, renderHomeGraphState, safeHomeGraphFilename, sourcesLinkedToNode, } from './state.js';
+import { renderDevicePassportPage, renderPacketPage, renderRoomPage, } from './rendering.js';
+export async function generateAutomaticHomeGraphPages(context) {
+    const options = context.input.pageAutomation ?? {};
+    const summary = createGeneratedPagesSummary();
+    if (options.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);
+        for (const device of devices) {
+            const deviceId = readHomeAssistantObjectId(device, 'objectId', 'deviceId') ?? device.id;
+            try {
+                const page = await refreshHomeGraphDevicePassport({
+                    ...context,
+                    input: {
+                        knowledgeSpaceId: context.spaceId,
+                        deviceId,
+                        metadata: { automation: 'snapshot-sync' },
+                    },
+                });
+                summary.devicePassports += 1;
+                if (page.artifactCreated)
+                    summary.artifacts += 1;
+                if (page.source)
+                    summary.sources += 1;
+            }
+            catch (error) {
+                summary.errors.push({
+                    kind: 'device-passport',
+                    targetId: deviceId,
+                    error: error instanceof Error ? error.message : String(error),
+                });
+            }
+        }
+    }
+    if (options.roomPages !== false) {
+        const rooms = limitRecords(state.nodes
+            .filter((node) => (node.kind === 'ha_area' || node.kind === 'ha_room') && node.status !== 'stale')
+            .sort(compareByTitle), options.maxRoomPages);
+        for (const room of rooms) {
+            const areaId = readHomeAssistantObjectId(room, 'objectId', 'areaId') ?? room.id;
+            try {
+                const page = await generateHomeGraphRoomPage({
+                    ...context,
+                    input: {
+                        knowledgeSpaceId: context.spaceId,
+                        areaId,
+                        title: room.title,
+                        metadata: { automation: 'snapshot-sync' },
+                    },
+                });
+                summary.roomPages += 1;
+                if (page.artifactCreated)
+                    summary.artifacts += 1;
+                if (page.source)
+                    summary.sources += 1;
+            }
+            catch (error) {
+                summary.errors.push({
+                    kind: 'room-page',
+                    targetId: areaId,
+                    error: error instanceof Error ? error.message : String(error),
+                });
+            }
+        }
+    }
+    return summary;
+}
+export async function refreshHomeGraphDevicePassport(context) {
+    const { store, artifactStore, spaceId, installationId, input } = context;
+    if (!input.deviceId)
+        throw new Error('refreshDevicePassport requires deviceId.');
+    const state = readHomeGraphState(store, spaceId);
+    const device = findHomeAssistantNode(state.nodes, 'ha_device', input.deviceId);
+    if (!device)
+        throw new Error(`Unknown Home Assistant device: ${input.deviceId}`);
+    const entities = state.nodes.filter((node) => (node.kind === 'ha_entity' && state.edges.some((edge) => (edgeIsActive(edge)
+        && edge.fromKind === 'node'
+        && edge.fromId === node.id
+        && edge.toKind === 'node'
+        && edge.toId === device.id
+        && edge.relation === 'belongs_to_device'))));
+    const sources = sourcesLinkedToNode(device.id, state).filter((source) => !isGeneratedPageSource(source));
+    const issues = state.issues.filter((issue) => issue.nodeId === device.id);
+    const missingFields = missingDevicePassportFields(device, sources);
+    const passport = await store.upsertNode({
+        id: homeGraphNodeId(spaceId, 'ha_device_passport', input.deviceId),
+        kind: 'ha_device_passport',
+        slug: `${device.slug}-passport`,
+        title: `${device.title} passport`,
+        summary: `Living device profile for ${device.title}.`,
+        aliases: [`${device.title} passport`],
+        confidence: 80,
+        metadata: buildHomeGraphMetadata(spaceId, installationId, {
+            homeAssistant: { installationId, objectKind: 'device_passport', objectId: input.deviceId },
+            deviceId: input.deviceId,
+            missingFields,
+            refreshedAt: Date.now(),
+        }),
+    });
+    await store.upsertEdge({
+        fromKind: 'node',
+        fromId: passport.id,
+        toKind: 'node',
+        toId: device.id,
+        relation: 'source_for',
+        metadata: buildHomeGraphMetadata(spaceId, installationId),
+    });
+    const markdown = renderDevicePassportPage({ spaceId, device, entities, sources, issues, missingFields });
+    const generated = await materializeGeneratedMarkdown({
+        store,
+        artifactStore,
+        spaceId,
+        installationId,
+        filename: `${safeHomeGraphFilename(device.title)}-passport.md`,
+        markdown,
+        projectionKind: 'device-passport',
+        canonicalValue: `device-passport:${input.deviceId}`,
+        title: `${device.title} passport`,
+        summary: `Living device profile for ${device.title}.`,
+        tags: ['homeassistant', 'home-graph', 'generated-page', 'device-passport'],
+        targetNodeId: passport.id,
+        metadata: {
+            ...(input.metadata ?? {}),
+            deviceId: input.deviceId,
+        },
+    });
+    return {
+        ok: true,
+        spaceId,
+        title: `${device.title} passport`,
+        markdown,
+        artifact: generated.artifact,
+        source: generated.source,
+        ...(generated.linked ? { linked: generated.linked } : {}),
+        device,
+        passport,
+        missingFields,
+        artifactCreated: generated.artifactCreated,
+    };
+}
+export async function generateHomeGraphRoomPage(context) {
+    const { store, artifactStore, spaceId, installationId, input } = 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 filename = `${safeHomeGraphFilename(title)}.md`;
+    const targetNode = areaId
+        ? findHomeAssistantNode(state.nodes, 'ha_area', areaId) ?? findHomeAssistantNode(state.nodes, 'ha_room', areaId)
+        : undefined;
+    const generated = await materializeGeneratedMarkdown({
+        store,
+        artifactStore,
+        spaceId,
+        installationId,
+        filename,
+        markdown,
+        projectionKind: 'room-page',
+        canonicalValue: `room-page:${areaId ?? 'home'}`,
+        title,
+        summary: `Living Home Graph room page for ${title}.`,
+        tags: ['homeassistant', 'home-graph', 'generated-page', 'room-page'],
+        ...(targetNode ? { targetNodeId: targetNode.id } : {}),
+        metadata: {
+            ...(input.metadata ?? {}),
+            ...(areaId ? { areaId } : {}),
+        },
+    });
+    return {
+        ok: true,
+        spaceId,
+        title,
+        markdown,
+        artifact: generated.artifact,
+        source: generated.source,
+        ...(generated.linked ? { linked: generated.linked } : {}),
+        artifactCreated: generated.artifactCreated,
+    };
+}
+export async function generateHomeGraphPacket(context) {
+    const { store, artifactStore, spaceId, installationId, input } = context;
+    const title = input.title ?? `${input.packetKind ?? 'home'} packet`;
+    const markdown = renderPacketPage(renderHomeGraphState(store, spaceId, title), input);
+    const generated = await materializeGeneratedMarkdown({
+        store,
+        artifactStore,
+        spaceId,
+        installationId,
+        filename: `${safeHomeGraphFilename(title)}.md`,
+        markdown,
+        projectionKind: 'packet',
+        canonicalValue: `packet:${input.packetKind ?? 'home'}:${input.sharingProfile ?? 'default'}`,
+        title,
+        summary: `Generated ${title} packet for ${input.sharingProfile ?? 'default'} sharing.`,
+        tags: ['homeassistant', 'home-graph', 'generated-page', 'packet'],
+        metadata: {
+            ...(input.metadata ?? {}),
+            packetKind: input.packetKind ?? 'home',
+            sharingProfile: input.sharingProfile ?? 'default',
+            includeFields: input.includeFields ? [...input.includeFields] : [],
+            excludeFields: input.excludeFields ? [...input.excludeFields] : [],
+        },
+    });
+    return { ok: true, spaceId, title, markdown, artifact: generated.artifact, source: generated.source, artifactCreated: generated.artifactCreated };
+}
+async function materializeGeneratedMarkdown(input) {
+    const generatedAt = Date.now();
+    const regeneration = readRecord(input.metadata).automation === 'snapshot-sync' ? 'automatic' : 'manual';
+    const metadata = {
+        ...(input.metadata ?? {}),
+        homeGraphSourceKind: 'generated-page',
+        homeGraphGeneratedPage: true,
+        projectionKind: input.projectionKind,
+        generatedAt,
+        pageEditable: true,
+        regeneration,
+    };
+    const homeGraphMetadata = buildHomeGraphMetadata(input.spaceId, input.installationId, metadata);
+    const generated = await materializeGeneratedKnowledgeProjection({
+        store: input.store,
+        artifactStore: input.artifactStore,
+        connectorId: HOME_GRAPH_CONNECTOR_ID,
+        sourceId: homeGraphSourceId(input.spaceId, 'generated-page', input.canonicalValue),
+        sourceType: 'document',
+        canonicalUri: namespacedCanonicalUri(input.spaceId, 'generated-page', input.canonicalValue),
+        title: input.title,
+        summary: input.summary,
+        tags: uniqueStrings(input.tags),
+        filename: input.filename,
+        markdown: input.markdown,
+        projectionKind: input.projectionKind,
+        metadata: homeGraphMetadata,
+        sourceMetadata: homeGraphMetadata,
+        artifactMetadata: homeGraphMetadata,
+        edgeMetadata: buildHomeGraphMetadata(input.spaceId, input.installationId, {
+            homeGraphGeneratedPage: true,
+            projectionKind: input.projectionKind,
+        }),
+        ...(input.targetNodeId
+            ? { target: { kind: 'node', id: input.targetNodeId, relation: input.relation ?? 'source_for' } }
+            : {}),
+    });
+    return {
+        artifact: projectionArtifact(generated.artifact),
+        source: generated.source,
+        ...(generated.linked ? { linked: generated.linked } : {}),
+        artifactCreated: generated.artifactCreated,
+    };
+}
+function projectionArtifact(artifact) {
+    return {
+        id: artifact.id,
+        mimeType: artifact.mimeType,
+        filename: artifact.filename,
+        createdAt: artifact.createdAt,
+        metadata: artifact.metadata,
+    };
+}
+function createGeneratedPagesSummary() {
+    return {
+        devicePassports: 0,
+        roomPages: 0,
+        artifacts: 0,
+        sources: 0,
+        errors: [],
+    };
+}
+function compareByTitle(left, right) {
+    return left.title.localeCompare(right.title) || left.id.localeCompare(right.id);
+}
+function limitRecords(records, limit) {
+    if (typeof limit !== 'number')
+        return records;
+    if (!Number.isFinite(limit))
+        return records;
+    return records.slice(0, Math.max(0, Math.trunc(limit)));
+}
+function readHomeAssistantObjectId(node, ...keys) {
+    const homeAssistant = readRecord(node.metadata.homeAssistant);
+    for (const key of keys) {
+        const value = homeAssistant[key];
+        if (typeof value === 'string' && value.trim())
+            return value.trim();
+    }
+    return undefined;
+}
+function resolveRoomTitle(nodes, areaId) {
+    if (!areaId)
+        return undefined;
+    return (findHomeAssistantNode(nodes, 'ha_area', areaId)
+        ?? findHomeAssistantNode(nodes, 'ha_room', areaId))?.title;
+}

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

@@ -1,4 +1,4 @@
-import type { KnowledgeEdgeRecord, KnowledgeNodeKind, KnowledgeReferenceKind, KnowledgeIssueUpsertInput } from '../types.js';
+import type { KnowledgeEdgeRecord, KnowledgeNodeKind, KnowledgeSourceRecord, KnowledgeReferenceKind, KnowledgeIssueUpsertInput } from '../types.js';
 import type { HomeGraphKnowledgeTarget, HomeGraphNodeKind, HomeGraphObjectInput, HomeGraphObjectKind, HomeGraphSpaceInput } from './types.js';
 export declare const HOME_GRAPH_CONNECTOR_ID = "homeassistant";
 export declare function resolveHomeGraphSpace(input?: HomeGraphSpaceInput): {
@@ -23,6 +23,7 @@ export declare function buildHomeGraphNodeInput(spaceId: string, installationId:
     readonly metadata: Record<string, unknown>;
 };
 export declare function edgeIsActive(edge: KnowledgeEdgeRecord): boolean;
+export declare function isGeneratedPageSource(source: KnowledgeSourceRecord): boolean;
 export declare function belongsToSpace(record: {
     readonly metadata?: Record<string, unknown>;
 } | undefined | null, spaceId: string): boolean;