@pellux/goodvibes-sdk 0.25.20 → 0.26.0

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

@@ -0,0 +1,46 @@
+import type { KnowledgeEdgeRecord, KnowledgeNodeKind, KnowledgeNodeRecord, KnowledgeReferenceKind, KnowledgeIssueUpsertInput, KnowledgeSourceRecord } from '../types.js';
+import type { HomeGraphKnowledgeTarget, HomeGraphNodeKind, HomeGraphObjectInput, HomeGraphObjectKind, HomeGraphSearchResult, HomeGraphSpaceInput } from './types.js';
+export declare const HOME_GRAPH_CONNECTOR_ID = "homeassistant";
+export declare function resolveHomeGraphSpace(input?: HomeGraphSpaceInput): {
+    readonly spaceId: string;
+    readonly installationId: string;
+};
+export declare function nodeKindForHomeGraphObject(kind: HomeGraphObjectKind | HomeGraphNodeKind): HomeGraphNodeKind;
+export declare function objectKindForNodeKind(kind: HomeGraphNodeKind): HomeGraphObjectKind;
+export declare function homeGraphSourceId(spaceId: string, kind: string, value: string): string;
+export declare function homeGraphNodeId(spaceId: string, kind: string, objectId: string): string;
+export declare function homeGraphEdgeId(spaceId: string, fromId: string, relation: string, toId: string): string;
+export declare function homeGraphIssueId(spaceId: string, code: string, subjectId: string): string;
+export declare function namespacedCanonicalUri(spaceId: string, kind: string, value: string): string;
+export declare function buildHomeGraphMetadata(spaceId: string, installationId: string, metadata?: Record<string, unknown>): Record<string, unknown>;
+export declare function buildHomeGraphNodeInput(spaceId: string, installationId: string, kind: HomeGraphObjectKind | HomeGraphNodeKind, object: HomeGraphObjectInput): {
+    readonly id: string;
+    readonly kind: KnowledgeNodeKind;
+    readonly slug: string;
+    readonly title: string;
+    readonly summary?: string;
+    readonly aliases: readonly string[];
+    readonly metadata: Record<string, unknown>;
+};
+export declare function edgeIsActive(edge: KnowledgeEdgeRecord): boolean;
+export declare function belongsToSpace(record: {
+    readonly metadata?: Record<string, unknown>;
+} | undefined | null, spaceId: string): boolean;
+export declare function scoreHomeGraphResults(query: string, sources: readonly KnowledgeSourceRecord[], nodes: readonly KnowledgeNodeRecord[], extractionBySourceId: (sourceId: string) => {
+    readonly summary?: string;
+    readonly excerpt?: string;
+    readonly sections: readonly string[];
+} | null, limit: number): HomeGraphSearchResult[];
+export declare function targetToReference(target: HomeGraphKnowledgeTarget): {
+    readonly kind: KnowledgeReferenceKind;
+    readonly id: string;
+    readonly nodeKind?: HomeGraphNodeKind;
+};
+export declare function buildIssue(spaceId: string, installationId: string, code: string, message: string, subject: {
+    readonly nodeId?: string;
+    readonly sourceId?: string;
+}): KnowledgeIssueUpsertInput;
+export declare function stableHash(value: string, length?: number): string;
+export declare function uniqueStrings(values: Iterable<string | undefined | null>): string[];
+export declare function readRecord(value: unknown): Record<string, unknown>;
+//# sourceMappingURL=helpers.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../../../../src/_internal/platform/knowledge/home-graph/helpers.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,230 @@
+import { createHash } from 'node:crypto';
+import { getKnowledgeSpaceId, homeAssistantKnowledgeSpaceId, knowledgeSpaceMetadata, normalizeHomeAssistantInstallationId, normalizeKnowledgeSpaceId, normalizeSpaceComponent, } from '../spaces.js';
+export const HOME_GRAPH_CONNECTOR_ID = 'homeassistant';
+const NODE_KIND_BY_OBJECT = {
+    home: 'ha_home',
+    entity: 'ha_entity',
+    device: 'ha_device',
+    area: 'ha_area',
+    automation: 'ha_automation',
+    script: 'ha_script',
+    scene: 'ha_scene',
+    label: 'ha_label',
+    integration: 'ha_integration',
+    room: 'ha_room',
+    device_passport: 'ha_device_passport',
+    maintenance_item: 'ha_maintenance_item',
+    troubleshooting_case: 'ha_troubleshooting_case',
+    purchase: 'ha_purchase',
+    network_node: 'ha_network_node',
+};
+const OBJECT_KIND_BY_NODE = Object.fromEntries(Object.entries(NODE_KIND_BY_OBJECT).map(([objectKind, nodeKind]) => [nodeKind, objectKind]));
+export function resolveHomeGraphSpace(input = {}) {
+    const installationId = normalizeHomeAssistantInstallationId(input.installationId);
+    const spaceId = input.knowledgeSpaceId
+        ? normalizeKnowledgeSpaceId(input.knowledgeSpaceId)
+        : homeAssistantKnowledgeSpaceId(installationId);
+    return {
+        spaceId,
+        installationId: spaceId.startsWith('homeassistant:')
+            ? normalizeHomeAssistantInstallationId(spaceId.slice('homeassistant:'.length))
+            : installationId,
+    };
+}
+export function nodeKindForHomeGraphObject(kind) {
+    if (kind.startsWith('ha_'))
+        return kind;
+    return NODE_KIND_BY_OBJECT[kind] ?? 'ha_entity';
+}
+export function objectKindForNodeKind(kind) {
+    return OBJECT_KIND_BY_NODE[kind] ?? 'entity';
+}
+export function homeGraphSourceId(spaceId, kind, value) {
+    return `hg-src-${stableHash(`${spaceId}:${kind}:${value}`)}`;
+}
+export function homeGraphNodeId(spaceId, kind, objectId) {
+    return `hg-node-${stableHash(`${spaceId}:${kind}:${objectId}`)}`;
+}
+export function homeGraphEdgeId(spaceId, fromId, relation, toId) {
+    return `hg-edge-${stableHash(`${spaceId}:${fromId}:${relation}:${toId}`)}`;
+}
+export function homeGraphIssueId(spaceId, code, subjectId) {
+    return `hg-issue-${stableHash(`${spaceId}:${code}:${subjectId}`)}`;
+}
+export function namespacedCanonicalUri(spaceId, kind, value) {
+    return `homegraph://${encodeURIComponent(spaceId)}/${kind}/${stableHash(value, 16)}`;
+}
+export function buildHomeGraphMetadata(spaceId, installationId, metadata = {}) {
+    return knowledgeSpaceMetadata(spaceId, {
+        ...metadata,
+        homeGraph: true,
+        homeAssistant: {
+            ...readRecord(metadata.homeAssistant),
+            installationId,
+        },
+    });
+}
+export function buildHomeGraphNodeInput(spaceId, installationId, kind, object) {
+    const nodeKind = nodeKindForHomeGraphObject(kind);
+    const objectKind = objectKindForNodeKind(nodeKind);
+    const objectId = homeGraphObjectId(nodeKind, object);
+    const title = object.title ?? object.name ?? object.entityId ?? object.id;
+    const aliases = uniqueStrings([
+        ...(object.aliases ?? []),
+        ...(object.labels ?? []),
+        object.entityId,
+        object.name,
+    ]);
+    return {
+        id: homeGraphNodeId(spaceId, nodeKind, objectId),
+        kind: nodeKind,
+        slug: `${normalizeSpaceComponent(spaceId)}-${nodeKind}-${normalizeSpaceComponent(objectId)}`,
+        title,
+        ...(buildObjectSummary(object) ? { summary: buildObjectSummary(object) } : {}),
+        aliases,
+        metadata: buildHomeGraphMetadata(spaceId, installationId, {
+            ...(object.metadata ?? {}),
+            homeAssistant: {
+                installationId,
+                objectKind,
+                objectId,
+                ...(object.entityId ? { entityId: object.entityId } : {}),
+                ...(object.deviceId ? { deviceId: object.deviceId } : {}),
+                ...(object.areaId ? { areaId: object.areaId } : {}),
+                ...(object.integrationId ? { integrationId: object.integrationId } : {}),
+            },
+            labels: object.labels ? [...object.labels] : [],
+            ...(object.manufacturer ? { manufacturer: object.manufacturer } : {}),
+            ...(object.model ? { model: object.model } : {}),
+        }),
+    };
+}
+function homeGraphObjectId(kind, object) {
+    switch (kind) {
+        case 'ha_entity':
+            return object.entityId ?? object.id;
+        case 'ha_device':
+        case 'ha_device_passport':
+            return object.deviceId ?? object.id;
+        case 'ha_area':
+        case 'ha_room':
+            return object.areaId ?? object.id;
+        case 'ha_integration':
+            return object.integrationId ?? object.id;
+        default:
+            return object.id;
+    }
+}
+export function edgeIsActive(edge) {
+    return edge.metadata.linkStatus !== 'unlinked';
+}
+export function belongsToSpace(record, spaceId) {
+    return record ? getKnowledgeSpaceId(record) === normalizeKnowledgeSpaceId(spaceId) : false;
+}
+export function scoreHomeGraphResults(query, sources, nodes, extractionBySourceId, limit) {
+    const tokens = tokenize(query);
+    if (tokens.length === 0)
+        return [];
+    const sourceResults = sources.map((source) => {
+        const extraction = extractionBySourceId(source.id);
+        const haystack = [
+            source.title ?? '',
+            source.summary ?? '',
+            source.description ?? '',
+            source.sourceUri ?? '',
+            source.tags.join(' '),
+            extraction?.summary ?? '',
+            extraction?.excerpt ?? '',
+            extraction?.sections.join(' ') ?? '',
+        ].join(' ').toLowerCase();
+        const baseScore = scoreHaystack(haystack, tokens);
+        return {
+            kind: 'source',
+            id: source.id,
+            score: baseScore > 0 ? baseScore + (extraction ? 8 : 0) : 0,
+            title: source.title ?? source.sourceUri ?? source.id,
+            summary: extraction?.summary ?? source.summary,
+            source,
+        };
+    });
+    const nodeResults = nodes.map((node) => {
+        const haystack = [
+            node.title,
+            node.summary ?? '',
+            node.aliases.join(' '),
+            JSON.stringify(node.metadata),
+        ].join(' ').toLowerCase();
+        const baseScore = scoreHaystack(haystack, tokens);
+        return {
+            kind: 'node',
+            id: node.id,
+            score: baseScore > 0 ? baseScore + Math.round(node.confidence / 20) : 0,
+            title: node.title,
+            summary: node.summary,
+            node,
+        };
+    });
+    return [...sourceResults, ...nodeResults]
+        .filter((entry) => entry.score > 0)
+        .sort((a, b) => b.score - a.score || a.id.localeCompare(b.id))
+        .slice(0, Math.max(1, limit));
+}
+export function targetToReference(target) {
+    if (target.kind === 'source')
+        return { kind: 'source', id: target.id };
+    if (target.kind === 'node')
+        return { kind: 'node', id: target.id };
+    return {
+        kind: 'node',
+        id: target.id,
+        nodeKind: nodeKindForHomeGraphObject(target.kind),
+    };
+}
+export function buildIssue(spaceId, installationId, code, message, subject) {
+    const subjectId = subject.nodeId ?? subject.sourceId ?? message;
+    return {
+        id: homeGraphIssueId(spaceId, code, subjectId),
+        severity: 'warning',
+        code,
+        message,
+        ...subject,
+        metadata: buildHomeGraphMetadata(spaceId, installationId, {
+            namespace: `homegraph:${spaceId}:quality`,
+            subjectId,
+        }),
+    };
+}
+export function stableHash(value, length = 24) {
+    return createHash('sha256').update(value).digest('hex').slice(0, length);
+}
+export 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;
+}
+export function readRecord(value) {
+    return value && typeof value === 'object' && !Array.isArray(value) ? value : {};
+}
+function buildObjectSummary(object) {
+    const parts = uniqueStrings([
+        object.manufacturer,
+        object.model,
+        object.areaId ? `area ${object.areaId}` : undefined,
+        object.deviceId ? `device ${object.deviceId}` : undefined,
+        object.integrationId ? `integration ${object.integrationId}` : undefined,
+    ]);
+    return parts.length > 0 ? parts.join(' - ') : undefined;
+}
+function tokenize(value) {
+    return value.toLowerCase().split(/[^a-z0-9_.:-]+/).map((entry) => entry.trim()).filter(Boolean);
+}
+function scoreHaystack(haystack, tokens) {
+    return tokens.reduce((score, token) => score + (haystack.includes(token) ? 10 : 0), 0);
+}

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

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

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

@@ -0,0 +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,4BAA4B,EAC5B,wBAAwB,EACxB,qBAAqB,EACrB,uBAAuB,EACvB,wBAAwB,EACxB,kBAAkB,EAClB,mBAAmB,EACnB,iBAAiB,EACjB,oBAAoB,EACpB,mBAAmB,EACnB,wBAAwB,EACxB,yBAAyB,EACzB,iBAAiB,EACjB,oBAAoB,EACpB,sBAAsB,EACtB,eAAe,EACf,mBAAmB,GACpB,MAAM,YAAY,CAAC"}

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

@@ -0,0 +1,2 @@
+export { HomeGraphService } from './service.js';
+export { HOME_GRAPH_NODE_KINDS, HOME_GRAPH_RELATIONS, } from './types.js';

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

@@ -0,0 +1,25 @@
+import type { KnowledgeEdgeRecord, KnowledgeIssueRecord, KnowledgeNodeRecord, KnowledgeSourceRecord } from '../types.js';
+export interface HomeGraphRenderState {
+    readonly spaceId: string;
+    readonly title: string;
+    readonly sources: readonly KnowledgeSourceRecord[];
+    readonly nodes: readonly KnowledgeNodeRecord[];
+    readonly edges: readonly KnowledgeEdgeRecord[];
+    readonly issues: readonly KnowledgeIssueRecord[];
+}
+export declare function renderRoomPage(state: HomeGraphRenderState, areaId?: string): string;
+export declare function renderDevicePassportPage(input: {
+    readonly spaceId: string;
+    readonly device: KnowledgeNodeRecord;
+    readonly entities: readonly KnowledgeNodeRecord[];
+    readonly sources: readonly KnowledgeSourceRecord[];
+    readonly issues: readonly KnowledgeIssueRecord[];
+    readonly missingFields: readonly string[];
+}): string;
+export declare function renderPacketPage(state: HomeGraphRenderState, options?: {
+    readonly packetKind?: string;
+    readonly sharingProfile?: string;
+    readonly includeFields?: readonly string[];
+    readonly excludeFields?: readonly string[];
+}): string;
+//# sourceMappingURL=rendering.d.ts.map

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

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

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

@@ -0,0 +1,139 @@
+import { edgeIsActive } from './helpers.js';
+export function renderRoomPage(state, areaId) {
+    const area = areaId
+        ? findNodeByHaId(state.nodes, 'ha_area', areaId) ?? findNodeByHaId(state.nodes, 'ha_room', areaId)
+        : undefined;
+    const title = area?.title ?? state.title;
+    const areaNodeId = area?.id;
+    const entities = state.nodes.filter((node) => (node.kind === 'ha_entity'
+        && (!areaNodeId || hasActiveEdge(state.edges, node.id, 'located_in', areaNodeId))));
+    const devices = state.nodes.filter((node) => (node.kind === 'ha_device'
+        && (!areaNodeId || hasActiveEdge(state.edges, node.id, 'located_in', areaNodeId))));
+    const automations = state.nodes.filter((node) => node.kind === 'ha_automation');
+    const scenes = state.nodes.filter((node) => node.kind === 'ha_scene');
+    const scripts = state.nodes.filter((node) => node.kind === 'ha_script');
+    const sources = relatedSources(state.sources, state.edges, areaNodeId);
+    return [
+        `# ${title}`,
+        '',
+        `Knowledge space: \`${state.spaceId}\``,
+        '',
+        renderNodeList('Devices', devices),
+        renderNodeList('Entities', entities),
+        renderNodeList('Automations', automations),
+        renderNodeList('Scenes', scenes),
+        renderNodeList('Scripts', scripts),
+        renderSourceList('Linked Sources', sources),
+        renderIssueList('Open Issues', state.issues.filter((issue) => issue.status === 'open')),
+    ].filter(Boolean).join('\n');
+}
+export function renderDevicePassportPage(input) {
+    return [
+        `# ${input.device.title}`,
+        '',
+        `Knowledge space: \`${input.spaceId}\``,
+        '',
+        '## 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),
+        renderSourceList('Sources', input.sources),
+        renderIssueList('Issues', input.issues),
+        input.missingFields.length > 0
+            ? ['## Missing Fields', '', ...input.missingFields.map((field) => `- ${field}`), ''].join('\n')
+            : '',
+    ].filter(Boolean).join('\n');
+}
+export function renderPacketPage(state, options = {}) {
+    const profile = options.sharingProfile ?? 'default';
+    const title = options.packetKind ? titleCase(options.packetKind) : state.title;
+    const excluded = new Set((options.excludeFields ?? []).map((field) => field.toLowerCase()));
+    return [
+        `# ${title}`,
+        '',
+        `Sharing profile: \`${profile}\``,
+        `Knowledge space: \`${state.spaceId}\``,
+        '',
+        excluded.has('devices') ? '' : renderNodeList('Devices', state.nodes.filter((node) => node.kind === 'ha_device')),
+        excluded.has('rooms') ? '' : renderNodeList('Rooms', state.nodes.filter((node) => node.kind === 'ha_area' || node.kind === 'ha_room')),
+        excluded.has('maintenance') ? '' : renderNodeList('Maintenance', state.nodes.filter((node) => node.kind === 'ha_maintenance_item')),
+        excluded.has('troubleshooting') ? '' : renderNodeList('Troubleshooting', state.nodes.filter((node) => node.kind === 'ha_troubleshooting_case')),
+        excluded.has('network') ? '' : renderNodeList('Network', state.nodes.filter((node) => node.kind === 'ha_network_node')),
+        excluded.has('sources') ? '' : renderSourceList('Sources', state.sources),
+        excluded.has('issues') ? '' : renderIssueList('Open Issues', state.issues.filter((issue) => issue.status === 'open')),
+    ].filter(Boolean).join('\n');
+}
+function renderNodeList(title, nodes) {
+    if (nodes.length === 0)
+        return '';
+    return [
+        `## ${title}`,
+        '',
+        ...nodes.slice(0, 100).map((node) => `- ${node.title}${node.summary ? ` - ${node.summary}` : ''}`),
+        '',
+    ].join('\n');
+}
+function renderSourceList(title, sources) {
+    if (sources.length === 0)
+        return '';
+    return [
+        `## ${title}`,
+        '',
+        ...sources.slice(0, 100).map((source) => {
+            const label = source.title ?? source.sourceUri ?? source.id;
+            return `- ${label}${source.sourceUri ? ` (${source.sourceUri})` : ''}`;
+        }),
+        '',
+    ].join('\n');
+}
+function renderIssueList(title, issues) {
+    if (issues.length === 0)
+        return '';
+    return [
+        `## ${title}`,
+        '',
+        ...issues.slice(0, 100).map((issue) => `- ${issue.severity}: ${issue.message}`),
+        '',
+    ].join('\n');
+}
+function renderMetadataField(label, value) {
+    return typeof value === 'string' && value.trim().length > 0 ? `- ${label}: ${value.trim()}` : '';
+}
+function relatedSources(sources, edges, nodeId) {
+    if (!nodeId)
+        return [...sources];
+    const sourceIds = new Set(edges.filter((edge) => (edgeIsActive(edge)
+        && edge.fromKind === 'source'
+        && edge.toKind === 'node'
+        && edge.toId === nodeId)).map((edge) => edge.fromId));
+    return sources.filter((source) => sourceIds.has(source.id));
+}
+function hasActiveEdge(edges, fromId, relation, toId) {
+    return edges.some((edge) => (edgeIsActive(edge)
+        && edge.fromKind === 'node'
+        && edge.fromId === fromId
+        && edge.toKind === 'node'
+        && edge.toId === toId
+        && edge.relation === relation));
+}
+function findNodeByHaId(nodes, kind, id) {
+    return nodes.find((node) => node.kind === kind && (readHa(node, 'objectId') === id
+        || readHa(node, 'areaId') === id
+        || node.id === id));
+}
+function readHa(node, key) {
+    const homeAssistant = node.metadata.homeAssistant;
+    if (!homeAssistant || typeof homeAssistant !== 'object' || Array.isArray(homeAssistant))
+        return undefined;
+    const value = homeAssistant[key];
+    return typeof value === 'string' ? value : undefined;
+}
+function titleCase(value) {
+    return value
+        .replace(/[-_]+/g, ' ')
+        .replace(/\b\w/g, (match) => match.toUpperCase());
+}

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

@@ -0,0 +1,82 @@
+import type { ArtifactStore } from '../../artifacts/index.js';
+import type { KnowledgeStore } from '../store.js';
+import type { KnowledgeEdgeRecord, KnowledgeIssueRecord, KnowledgeNodeRecord, KnowledgeSourceRecord } from '../types.js';
+import type { HomeGraphAskInput, HomeGraphAskResult, HomeGraphDevicePassportResult, HomeGraphExport, HomeGraphIngestArtifactInput, HomeGraphIngestNoteInput, HomeGraphIngestResult, HomeGraphIngestUrlInput, HomeGraphLinkInput, HomeGraphLinkResult, HomeGraphProjectionInput, HomeGraphProjectionResult, HomeGraphReviewInput, HomeGraphSpaceInput, HomeGraphSnapshotInput, HomeGraphStatus, HomeGraphSyncResult } from './types.js';
+export declare class HomeGraphService {
+    private readonly store;
+    private readonly artifactStore;
+    constructor(store: KnowledgeStore, artifactStore: ArtifactStore);
+    status(input?: {
+        readonly installationId?: string;
+        readonly knowledgeSpaceId?: string;
+    }): Promise<HomeGraphStatus>;
+    syncSnapshot(input: HomeGraphSnapshotInput): Promise<HomeGraphSyncResult>;
+    ingestUrl(input: HomeGraphIngestUrlInput): Promise<HomeGraphIngestResult>;
+    ingestNote(input: HomeGraphIngestNoteInput): Promise<HomeGraphIngestResult>;
+    ingestArtifact(input: HomeGraphIngestArtifactInput): Promise<HomeGraphIngestResult>;
+    linkKnowledge(input: HomeGraphLinkInput): Promise<HomeGraphLinkResult>;
+    unlinkKnowledge(input: HomeGraphLinkInput): Promise<HomeGraphLinkResult>;
+    ask(input: HomeGraphAskInput): Promise<HomeGraphAskResult>;
+    refreshDevicePassport(input: HomeGraphProjectionInput): Promise<HomeGraphDevicePassportResult>;
+    generateRoomPage(input: HomeGraphProjectionInput): Promise<HomeGraphProjectionResult>;
+    generatePacket(input: HomeGraphProjectionInput): Promise<HomeGraphProjectionResult>;
+    listIssues(input: HomeGraphSpaceInput & {
+        readonly status?: string;
+        readonly severity?: string;
+        readonly code?: string;
+        readonly limit?: number;
+    }): Promise<{
+        readonly ok: true;
+        readonly spaceId: string;
+        readonly issues: readonly KnowledgeIssueRecord[];
+    }>;
+    reviewFact(input: HomeGraphReviewInput): Promise<{
+        readonly ok: true;
+        readonly spaceId: string;
+        readonly issue?: KnowledgeIssueRecord;
+        readonly node?: KnowledgeNodeRecord;
+        readonly source?: KnowledgeSourceRecord;
+    }>;
+    listSources(input?: HomeGraphSpaceInput & {
+        readonly limit?: number;
+    }): Promise<{
+        readonly ok: true;
+        readonly spaceId: string;
+        readonly sources: readonly KnowledgeSourceRecord[];
+    }>;
+    browse(input?: HomeGraphSpaceInput & {
+        readonly limit?: number;
+    }): Promise<{
+        readonly ok: true;
+        readonly spaceId: string;
+        readonly nodes: readonly KnowledgeNodeRecord[];
+        readonly edges: readonly KnowledgeEdgeRecord[];
+        readonly sources: readonly KnowledgeSourceRecord[];
+        readonly issues: readonly KnowledgeIssueRecord[];
+    }>;
+    exportSpace(input?: HomeGraphSpaceInput): Promise<HomeGraphExport>;
+    importSpace(input: HomeGraphSpaceInput & {
+        readonly data: HomeGraphExport;
+    }): Promise<{
+        readonly ok: true;
+        readonly spaceId: string;
+        readonly imported: {
+            readonly sources: number;
+            readonly nodes: number;
+            readonly edges: number;
+            readonly issues: number;
+            readonly extractions: number;
+        };
+    }>;
+    private ingestCreatedArtifact;
+    private extractArtifact;
+    private upsertHomeNode;
+    private upsertSnapshotObjects;
+    private linkSnapshotObjectRelations;
+    private tryLinkNode;
+    private refreshQualityIssues;
+    private resolveLinkSource;
+    private ensureTarget;
+    private materializeMarkdown;
+}
+//# sourceMappingURL=service.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../../../../src/_internal/platform/knowledge/home-graph/service.ts"],"names":[],"mappings":"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"}