@pellux/goodvibes-sdk 0.30.2 → 0.33.0

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

@@ -1,4 +1,4 @@
-import type { KnowledgeEdgeRecord, KnowledgeNodeKind, KnowledgeSourceRecord, KnowledgeReferenceKind, KnowledgeIssueUpsertInput } from '../types.js';
+import type { KnowledgeEdgeRecord, KnowledgeNodeKind, KnowledgeNodeRecord, 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): {
@@ -18,12 +18,13 @@ export declare function buildHomeGraphNodeInput(spaceId: string, installationId:
     readonly kind: KnowledgeNodeKind;
     readonly slug: string;
     readonly title: string;
-    readonly summary?: string;
+    readonly summary?: string | undefined;
     readonly aliases: readonly string[];
     readonly metadata: Record<string, unknown>;
 };
 export declare function edgeIsActive(edge: KnowledgeEdgeRecord): boolean;
 export declare function isGeneratedPageSource(source: KnowledgeSourceRecord): boolean;
+export declare function factSourceIds(fact: KnowledgeNodeRecord): string[];
 export declare function belongsToSpace(record: {
     readonly metadata?: Record<string, unknown>;
 } | undefined | null, spaceId: string): boolean;
@@ -32,7 +33,7 @@ export declare function homeAssistantSpaceComponent(spaceId: string): string | u
 export declare function targetToReference(target: HomeGraphKnowledgeTarget): {
     readonly kind: KnowledgeReferenceKind;
     readonly id: string;
-    readonly nodeKind?: HomeGraphNodeKind;
+    readonly nodeKind?: HomeGraphNodeKind | undefined;
 };
 export declare function buildIssue(spaceId: string, installationId: string, code: string, message: string, subject: {
     readonly nodeId?: string;

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

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

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

@@ -1,5 +1,6 @@
 import { createHash } from 'node:crypto';
 import { isGeneratedKnowledgeSource, } from '../generated-projections.js';
+import { isActiveKnowledgeEdge } from '../projection-utils.js';
 import { HOME_ASSISTANT_KNOWLEDGE_SPACE_PREFIX, getKnowledgeSpaceId, homeAssistantKnowledgeSpaceId, knowledgeSpaceMetadata, normalizeHomeAssistantInstallationId, normalizeKnowledgeSpaceId, normalizeSpaceComponent, } from '../spaces.js';
 export const HOME_GRAPH_CONNECTOR_ID = 'homeassistant';
 const NODE_KIND_BY_OBJECT = {
@@ -118,11 +119,18 @@ function homeGraphObjectId(kind, object) {
     }
 }
 export function edgeIsActive(edge) {
-    return edge.metadata.linkStatus !== 'unlinked';
+    return isActiveKnowledgeEdge(edge);
 }
 export function isGeneratedPageSource(source) {
     return isGeneratedKnowledgeSource(source);
 }
+export function factSourceIds(fact) {
+    return uniqueStrings([
+        ...readStringArray(fact.metadata.sourceIds),
+        readString(fact.metadata.sourceId),
+        fact.sourceId,
+    ]);
+}
 export function belongsToSpace(record, spaceId) {
     if (!record)
         return false;
@@ -310,8 +318,7 @@ function stableJson(value) {
             return Object.fromEntries(Object.entries(entry).sort(([left], [right]) => left.localeCompare(right)));
         });
     }
-    catch (error) {
-        void error;
+    catch {
         return String(value);
     }
 }

package/dist/platform/knowledge/home-graph/import-export.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"import-export.d.ts","sourceRoot":"","sources":["../../../../src/platform/knowledge/home-graph/import-export.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAGlD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElD,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,cAAc,EACrB,KAAK,EAAE;IAAE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAA;CAAE,GACnE,eAAe,CAajB;AAED,wBAAsB,oBAAoB,CACxC,KAAK,EAAE,cAAc,EACrB,KAAK,EAAE;IAAE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAA;CAAE,GACnG,OAAO,CAAC;IACT,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAClB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE;QAAE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC;CACxJ,CAAC,CA2BD"}
+{"version":3,"file":"import-export.d.ts","sourceRoot":"","sources":["../../../../src/platform/knowledge/home-graph/import-export.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAGlD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElD,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,cAAc,EACrB,KAAK,EAAE;IAAE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAA;CAAE,GACnE,eAAe,CAajB;AAED,wBAAsB,oBAAoB,CACxC,KAAK,EAAE,cAAc,EACrB,KAAK,EAAE;IAAE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAA;CAAE,GACnG,OAAO,CAAC;IACT,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAClB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE;QAAE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC;CACxJ,CAAC,CA6BD"}

package/dist/platform/knowledge/home-graph/import-export.js

@@ -20,25 +20,27 @@ export async function importHomeGraphSpace(store, input) {
     let edges = 0;
     let issues = 0;
     let extractions = 0;
-    for (const source of input.data.sources ?? []) {
-        await store.upsertSource({ ...source, metadata: buildHomeGraphMetadata(input.spaceId, input.installationId, source.metadata) });
-        sources += 1;
-    }
-    for (const node of input.data.nodes ?? []) {
-        await store.upsertNode({ ...node, metadata: buildHomeGraphMetadata(input.spaceId, input.installationId, node.metadata) });
-        nodes += 1;
-    }
-    for (const edge of input.data.edges ?? []) {
-        await store.upsertEdge({ ...edge, metadata: buildHomeGraphMetadata(input.spaceId, input.installationId, edge.metadata) });
-        edges += 1;
-    }
-    for (const issue of input.data.issues ?? []) {
-        await store.upsertIssue({ ...issue, metadata: buildHomeGraphMetadata(input.spaceId, input.installationId, issue.metadata) });
-        issues += 1;
-    }
-    for (const extraction of input.data.extractions ?? []) {
-        await store.upsertExtraction({ ...extraction, metadata: buildHomeGraphMetadata(input.spaceId, input.installationId, extraction.metadata) });
-        extractions += 1;
-    }
+    await store.batch(async () => {
+        for (const source of input.data.sources ?? []) {
+            await store.upsertSource({ ...source, metadata: buildHomeGraphMetadata(input.spaceId, input.installationId, source.metadata) });
+            sources += 1;
+        }
+        for (const node of input.data.nodes ?? []) {
+            await store.upsertNode({ ...node, metadata: buildHomeGraphMetadata(input.spaceId, input.installationId, node.metadata) });
+            nodes += 1;
+        }
+        for (const edge of input.data.edges ?? []) {
+            await store.upsertEdge({ ...edge, metadata: buildHomeGraphMetadata(input.spaceId, input.installationId, edge.metadata) });
+            edges += 1;
+        }
+        for (const issue of input.data.issues ?? []) {
+            await store.upsertIssue({ ...issue, metadata: buildHomeGraphMetadata(input.spaceId, input.installationId, issue.metadata) });
+            issues += 1;
+        }
+        for (const extraction of input.data.extractions ?? []) {
+            await store.upsertExtraction({ ...extraction, metadata: buildHomeGraphMetadata(input.spaceId, input.installationId, extraction.metadata) });
+            extractions += 1;
+        }
+    });
     return { ok: true, spaceId: input.spaceId, imported: { sources, nodes, edges, issues, extractions } };
 }

package/dist/platform/knowledge/home-graph/inventory.d.ts

@@ -3,7 +3,7 @@ import type { KnowledgeEdgeRecord, KnowledgeIssueRecord, KnowledgeNodeRecord, Kn
 import type { HomeGraphSpaceInput } from './types.js';
 export declare function listHomeGraphSources(input: HomeGraphSpaceInput & {
     readonly store: KnowledgeStore;
-    readonly limit?: number;
+    readonly limit?: number | undefined;
 }): Promise<{
     readonly ok: true;
     readonly spaceId: string;
@@ -11,7 +11,7 @@ export declare function listHomeGraphSources(input: HomeGraphSpaceInput & {
 }>;
 export declare function browseHomeGraph(input: HomeGraphSpaceInput & {
     readonly store: KnowledgeStore;
-    readonly limit?: number;
+    readonly limit?: number | undefined;
 }): Promise<{
     readonly ok: true;
     readonly spaceId: string;

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

@@ -1 +1 @@
-{"version":3,"file":"inventory.d.ts","sourceRoot":"","sources":["../../../../src/platform/knowledge/home-graph/inventory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,KAAK,EACV,mBAAmB,EACnB,oBAAoB,EACpB,mBAAmB,EACnB,qBAAqB,EACtB,MAAM,aAAa,CAAC;AAGrB,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAEtD,wBAAsB,oBAAoB,CAAC,KAAK,EAAE,mBAAmB,GAAG;IACtE,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC;IAC/B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB,GAAG,OAAO,CAAC;IAAE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,SAAS,qBAAqB,EAAE,CAAA;CAAE,CAAC,CAI/G;AAED,wBAAsB,eAAe,CAAC,KAAK,EAAE,mBAAmB,GAAG;IACjE,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC;IAC/B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB,GAAG,OAAO,CAAC;IACV,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAClB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,SAAS,mBAAmB,EAAE,CAAC;IAC/C,QAAQ,CAAC,KAAK,EAAE,SAAS,mBAAmB,EAAE,CAAC;IAC/C,QAAQ,CAAC,OAAO,EAAE,SAAS,qBAAqB,EAAE,CAAC;IACnD,QAAQ,CAAC,MAAM,EAAE,SAAS,oBAAoB,EAAE,CAAC;CAClD,CAAC,CAaD"}
+{"version":3,"file":"inventory.d.ts","sourceRoot":"","sources":["../../../../src/platform/knowledge/home-graph/inventory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,KAAK,EACV,mBAAmB,EACnB,oBAAoB,EACpB,mBAAmB,EACnB,qBAAqB,EACtB,MAAM,aAAa,CAAC;AAGrB,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAEtD,wBAAsB,oBAAoB,CAAC,KAAK,EAAE,mBAAmB,GAAG;IACtE,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC;IAC/B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACrC,GAAG,OAAO,CAAC;IAAE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,SAAS,qBAAqB,EAAE,CAAA;CAAE,CAAC,CAI/G;AAED,wBAAsB,eAAe,CAAC,KAAK,EAAE,mBAAmB,GAAG;IACjE,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC;IAC/B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACrC,GAAG,OAAO,CAAC;IACV,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAClB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,SAAS,mBAAmB,EAAE,CAAC;IAC/C,QAAQ,CAAC,KAAK,EAAE,SAAS,mBAAmB,EAAE,CAAC;IAC/C,QAAQ,CAAC,OAAO,EAAE,SAAS,qBAAqB,EAAE,CAAC;IACnD,QAAQ,CAAC,MAAM,EAAE,SAAS,oBAAoB,EAAE,CAAC;CAClD,CAAC,CAaD"}

package/dist/platform/knowledge/home-graph/link-node.d.ts

@@ -5,9 +5,9 @@ export declare function linkHomeGraphSnapshotObjectReferences(store: KnowledgeSt
     readonly installationId: string;
     readonly node: KnowledgeNodeRecord;
     readonly object: {
-        readonly deviceId?: string;
-        readonly areaId?: string;
-        readonly integrationId?: string;
+        readonly deviceId?: string | undefined;
+        readonly areaId?: string | undefined;
+        readonly integrationId?: string | undefined;
     };
 }): Promise<void>;
 export declare function linkHomeGraphNodeReference(store: KnowledgeStore, input: {

package/dist/platform/knowledge/home-graph/link-node.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"link-node.d.ts","sourceRoot":"","sources":["../../../../src/platform/knowledge/home-graph/link-node.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAGvD,wBAAsB,qCAAqC,CACzD,KAAK,EAAE,cAAc,EACrB,KAAK,EAAE;IACL,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,IAAI,EAAE,mBAAmB,CAAC;IACnC,QAAQ,CAAC,MAAM,EAAE;QAAE,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAC5G,GACA,OAAO,CAAC,IAAI,CAAC,CA4Bf;AAED,wBAAsB,0BAA0B,CAC9C,KAAK,EAAE,cAAc,EACrB,KAAK,EAAE;IACL,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B,GACA,OAAO,CAAC,IAAI,CAAC,CAYf"}
+{"version":3,"file":"link-node.d.ts","sourceRoot":"","sources":["../../../../src/platform/knowledge/home-graph/link-node.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAGvD,wBAAsB,qCAAqC,CACzD,KAAK,EAAE,cAAc,EACrB,KAAK,EAAE;IACL,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,IAAI,EAAE,mBAAmB,CAAC;IACnC,QAAQ,CAAC,MAAM,EAAE;QAAE,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QAAC,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;KAAE,CAAC;CAChJ,GACA,OAAO,CAAC,IAAI,CAAC,CA4Bf;AAED,wBAAsB,0BAA0B,CAC9C,KAAK,EAAE,cAAc,EACrB,KAAK,EAAE;IACL,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B,GACA,OAAO,CAAC,IAAI,CAAC,CAYf"}

package/dist/platform/knowledge/home-graph/refinement.d.ts

@@ -4,10 +4,10 @@ import type { KnowledgeRefinementTaskRecord } from '../types.js';
 import type { HomeGraphSpaceInput } from './types.js';
 export declare function listHomeGraphRefinementTasks(input: HomeGraphSpaceInput & {
     readonly store: KnowledgeStore;
-    readonly limit?: number;
-    readonly state?: string;
-    readonly subjectId?: string;
-    readonly gapId?: string;
+    readonly limit?: number | undefined;
+    readonly state?: string | undefined;
+    readonly subjectId?: string | undefined;
+    readonly gapId?: string | undefined;
 }): Promise<{
     readonly ok: true;
     readonly spaceId: string;
@@ -23,22 +23,22 @@ export declare function getHomeGraphRefinementTask(input: HomeGraphSpaceInput &
 }>;
 export declare function runHomeGraphRefinement(input: HomeGraphSpaceInput & {
     readonly store: KnowledgeStore;
-    readonly semanticService?: KnowledgeSemanticService;
-    readonly gapIds?: readonly string[];
-    readonly sourceIds?: readonly string[];
-    readonly limit?: number;
-    readonly maxRunMs?: number;
-    readonly force?: boolean;
+    readonly semanticService?: KnowledgeSemanticService | undefined;
+    readonly gapIds?: readonly string[] | undefined;
+    readonly sourceIds?: readonly string[] | undefined;
+    readonly limit?: number | undefined;
+    readonly maxRunMs?: number | undefined;
+    readonly force?: boolean | undefined;
 }): Promise<{
     ok: boolean;
     spaceId: string;
     error: string;
-    result?: undefined;
+    result?: never;
 } | {
     ok: boolean;
     spaceId: string;
     result: import("../semantic/types.js").KnowledgeSemanticSelfImproveResult;
-    error?: undefined;
+    error?: never;
 }>;
 export declare function cancelHomeGraphRefinementTask(input: HomeGraphSpaceInput & {
     readonly store: KnowledgeStore;
@@ -47,11 +47,11 @@ export declare function cancelHomeGraphRefinementTask(input: HomeGraphSpaceInput
     ok: boolean;
     spaceId: string;
     error: string;
-    task?: undefined;
+    task?: never;
 } | {
     ok: boolean;
     spaceId: string;
     task: KnowledgeRefinementTaskRecord;
-    error?: undefined;
+    error?: never;
 }>;
 //# sourceMappingURL=refinement.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"refinement.d.ts","sourceRoot":"","sources":["../../../../src/platform/knowledge/home-graph/refinement.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,sBAAsB,CAAC;AACrE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,aAAa,CAAC;AAEjE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAEtD,wBAAsB,4BAA4B,CAAC,KAAK,EAAE,mBAAmB,GAAG;IAC9E,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC;IAC/B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB,GAAG,OAAO,CAAC;IAAE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,SAAS,6BAA6B,EAAE,CAAA;CAAE,CAAC,CAcrH;AAED,wBAAsB,0BAA0B,CAAC,KAAK,EAAE,mBAAmB,GAAG;IAC5E,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC;IAC/B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB,GAAG,OAAO,CAAC;IAAE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,6BAA6B,GAAG,IAAI,CAAA;CAAE,CAAC,CAKhH;AAED,wBAAsB,sBAAsB,CAAC,KAAK,EAAE,mBAAmB,GAAG;IACxE,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC;IAC/B,QAAQ,CAAC,eAAe,CAAC,EAAE,wBAAwB,CAAC;IACpD,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACvC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;CAC1B;;;;;;;;;;GAcA;AAED,wBAAsB,6BAA6B,CAAC,KAAK,EAAE,mBAAmB,GAAG;IAC/E,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC;IAC/B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;;;;;;;;;;GAuBA"}
+{"version":3,"file":"refinement.d.ts","sourceRoot":"","sources":["../../../../src/platform/knowledge/home-graph/refinement.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,sBAAsB,CAAC;AACrE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,aAAa,CAAC;AAEjE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAEtD,wBAAsB,4BAA4B,CAAC,KAAK,EAAE,mBAAmB,GAAG;IAC9E,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC;IAC/B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACxC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACrC,GAAG,OAAO,CAAC;IAAE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,SAAS,6BAA6B,EAAE,CAAA;CAAE,CAAC,CAcrH;AAED,wBAAsB,0BAA0B,CAAC,KAAK,EAAE,mBAAmB,GAAG;IAC5E,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC;IAC/B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB,GAAG,OAAO,CAAC;IAAE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,6BAA6B,GAAG,IAAI,CAAA;CAAE,CAAC,CAKhH;AAED,wBAAsB,sBAAsB,CAAC,KAAK,EAAE,mBAAmB,GAAG;IACxE,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC;IAC/B,QAAQ,CAAC,eAAe,CAAC,EAAE,wBAAwB,GAAG,SAAS,CAAC;IAChE,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,CAAC;IAChD,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,CAAC;IACnD,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACvC,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CACtC;;;;;;;;;;GAcA;AAED,wBAAsB,6BAA6B,CAAC,KAAK,EAAE,mBAAmB,GAAG;IAC/E,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC;IAC/B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;;;;;;;;;;GAuBA"}

package/dist/platform/knowledge/home-graph/reindex.d.ts

@@ -8,7 +8,7 @@ import type { HomeGraphReindexInput, HomeGraphReindexResult } from './types.js';
 export interface HomeGraphReindexContext {
     readonly store: KnowledgeStore;
     readonly artifactStore: ArtifactStore;
-    readonly semanticService?: KnowledgeSemanticService;
+    readonly semanticService?: KnowledgeSemanticService | undefined;
     readonly extract: (source: KnowledgeSourceRecord, artifact: ArtifactDescriptor, spaceId: string, installationId: string) => Promise<KnowledgeExtractionRecord | undefined>;
     readonly autoLinkExistingSources: (spaceId: string, installationId: string, sourceIds?: readonly string[]) => Promise<readonly HomeGraphAutoLinkResult[]>;
     readonly refreshQualityIssues: (spaceId: string, installationId: string) => Promise<readonly KnowledgeIssueRecord[]>;
@@ -21,7 +21,7 @@ export declare function reindexHomeGraphSources(input: {
     readonly extractionBySourceId: ReadonlyMap<string, KnowledgeExtractionRecord>;
     readonly artifactStore: ArtifactStore;
     readonly extract: (source: KnowledgeSourceRecord, artifact: ArtifactDescriptor) => Promise<KnowledgeExtractionRecord | undefined>;
-    readonly limit?: number;
-    readonly maxRunMs?: number;
+    readonly limit?: number | undefined;
+    readonly maxRunMs?: number | undefined;
 }): Promise<HomeGraphReindexResult>;
 //# sourceMappingURL=reindex.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"reindex.d.ts","sourceRoot":"","sources":["../../../../src/platform/knowledge/home-graph/reindex.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AACnE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,KAAK,EAAE,yBAAyB,EAAE,oBAAoB,EAAuB,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAC/H,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,sBAAsB,CAAC;AAYrE,OAAO,KAAK,EACV,uBAAuB,EACxB,MAAM,gBAAgB,CAAC;AACxB,OAAO,KAAK,EAEV,qBAAqB,EACrB,sBAAsB,EACvB,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC;IAC/B,QAAQ,CAAC,aAAa,EAAE,aAAa,CAAC;IACtC,QAAQ,CAAC,eAAe,CAAC,EAAE,wBAAwB,CAAC;IACpD,QAAQ,CAAC,OAAO,EAAE,CAChB,MAAM,EAAE,qBAAqB,EAC7B,QAAQ,EAAE,kBAAkB,EAC5B,OAAO,EAAE,MAAM,EACf,cAAc,EAAE,MAAM,KACnB,OAAO,CAAC,yBAAyB,GAAG,SAAS,CAAC,CAAC;IACpD,QAAQ,CAAC,uBAAuB,EAAE,CAChC,OAAO,EAAE,MAAM,EACf,cAAc,EAAE,MAAM,EACtB,SAAS,CAAC,EAAE,SAAS,MAAM,EAAE,KAC1B,OAAO,CAAC,SAAS,uBAAuB,EAAE,CAAC,CAAC;IACjD,QAAQ,CAAC,oBAAoB,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,KAAK,OAAO,CAAC,SAAS,oBAAoB,EAAE,CAAC,CAAC;CACtH;AAED,wBAAgB,+BAA+B,CAC7C,KAAK,EAAE,cAAc,EACrB,KAAK,EAAE,qBAAqB,GAC3B,sBAAsB,CAexB;AAED,wBAAsB,mBAAmB,CACvC,OAAO,EAAE,uBAAuB,EAChC,KAAK,GAAE,qBAA0B,GAChC,OAAO,CAAC,sBAAsB,CAAC,CAmEjC;AAED,wBAAsB,uBAAuB,CAAC,KAAK,EAAE;IACnD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,SAAS,qBAAqB,EAAE,CAAC;IACnD,QAAQ,CAAC,oBAAoB,EAAE,WAAW,CAAC,MAAM,EAAE,yBAAyB,CAAC,CAAC;IAC9E,QAAQ,CAAC,aAAa,EAAE,aAAa,CAAC;IACtC,QAAQ,CAAC,OAAO,EAAE,CAAC,MAAM,EAAE,qBAAqB,EAAE,QAAQ,EAAE,kBAAkB,KAAK,OAAO,CAAC,yBAAyB,GAAG,SAAS,CAAC,CAAC;IAClI,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC5B,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAgDlC"}
+{"version":3,"file":"reindex.d.ts","sourceRoot":"","sources":["../../../../src/platform/knowledge/home-graph/reindex.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AACnE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,KAAK,EAAE,yBAAyB,EAAE,oBAAoB,EAAuB,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAC/H,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,sBAAsB,CAAC;AAYrE,OAAO,KAAK,EACV,uBAAuB,EACxB,MAAM,gBAAgB,CAAC;AACxB,OAAO,KAAK,EAEV,qBAAqB,EACrB,sBAAsB,EACvB,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC;IAC/B,QAAQ,CAAC,aAAa,EAAE,aAAa,CAAC;IACtC,QAAQ,CAAC,eAAe,CAAC,EAAE,wBAAwB,GAAG,SAAS,CAAC;IAChE,QAAQ,CAAC,OAAO,EAAE,CAChB,MAAM,EAAE,qBAAqB,EAC7B,QAAQ,EAAE,kBAAkB,EAC5B,OAAO,EAAE,MAAM,EACf,cAAc,EAAE,MAAM,KACnB,OAAO,CAAC,yBAAyB,GAAG,SAAS,CAAC,CAAC;IACpD,QAAQ,CAAC,uBAAuB,EAAE,CAChC,OAAO,EAAE,MAAM,EACf,cAAc,EAAE,MAAM,EACtB,SAAS,CAAC,EAAE,SAAS,MAAM,EAAE,KAC1B,OAAO,CAAC,SAAS,uBAAuB,EAAE,CAAC,CAAC;IACjD,QAAQ,CAAC,oBAAoB,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,KAAK,OAAO,CAAC,SAAS,oBAAoB,EAAE,CAAC,CAAC;CACtH;AAED,wBAAgB,+BAA+B,CAC7C,KAAK,EAAE,cAAc,EACrB,KAAK,EAAE,qBAAqB,GAC3B,sBAAsB,CAexB;AAED,wBAAsB,mBAAmB,CACvC,OAAO,EAAE,uBAAuB,EAChC,KAAK,GAAE,qBAA0B,GAChC,OAAO,CAAC,sBAAsB,CAAC,CAmEjC;AAED,wBAAsB,uBAAuB,CAAC,KAAK,EAAE;IACnD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,SAAS,qBAAqB,EAAE,CAAC;IACnD,QAAQ,CAAC,oBAAoB,EAAE,WAAW,CAAC,MAAM,EAAE,yBAAyB,CAAC,CAAC;IAC9E,QAAQ,CAAC,aAAa,EAAE,aAAa,CAAC;IACtC,QAAQ,CAAC,OAAO,EAAE,CAAC,MAAM,EAAE,qBAAqB,EAAE,QAAQ,EAAE,kBAAkB,KAAK,OAAO,CAAC,yBAAyB,GAAG,SAAS,CAAC,CAAC;IAClI,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACxC,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAgDlC"}

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

@@ -16,13 +16,13 @@ export declare function renderDevicePassportPage(input: {
     readonly sources: readonly KnowledgeSourceRecord[];
     readonly issues: readonly KnowledgeIssueRecord[];
     readonly missingFields: readonly string[];
-    readonly semanticFacts?: readonly KnowledgeNodeRecord[];
+    readonly semanticFacts?: readonly KnowledgeNodeRecord[] | undefined;
 }): string;
 export declare function renderPacketPage(state: HomeGraphRenderState, options?: {
-    readonly packetKind?: string;
-    readonly sharingProfile?: string;
-    readonly includeFields?: readonly string[];
-    readonly excludeFields?: readonly string[];
+    readonly packetKind?: string | undefined;
+    readonly sharingProfile?: string | undefined;
+    readonly includeFields?: readonly string[] | undefined;
+    readonly excludeFields?: readonly string[] | undefined;
 }): string;
 export declare function renderHomeGraphMap(state: HomeGraphRenderState, options?: HomeGraphMapInput): HomeGraphMapResult;
 export declare function issuesForScope(issues: readonly KnowledgeIssueRecord[], edges: readonly KnowledgeEdgeRecord[], nodeIds: ReadonlySet<string>, sources: readonly KnowledgeSourceRecord[]): KnowledgeIssueRecord[];

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

@@ -1 +1 @@
-{"version":3,"file":"rendering.d.ts","sourceRoot":"","sources":["../../../../src/platform/knowledge/home-graph/rendering.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,mBAAmB,EACnB,oBAAoB,EAEpB,mBAAmB,EACnB,qBAAqB,EACtB,MAAM,aAAa,CAAC;AAIrB,OAAO,KAAK,EAA6B,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAInG,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,CA2CnF;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;IAC1C,QAAQ,CAAC,aAAa,CAAC,EAAE,SAAS,mBAAmB,EAAE,CAAC;CACzD,GAAG,MAAM,CAyBT;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;AAobD,wBAAgB,cAAc,CAC5B,MAAM,EAAE,SAAS,oBAAoB,EAAE,EACvC,KAAK,EAAE,SAAS,mBAAmB,EAAE,EACrC,OAAO,EAAE,WAAW,CAAC,MAAM,CAAC,EAC5B,OAAO,EAAE,SAAS,qBAAqB,EAAE,GACxC,oBAAoB,EAAE,CAUxB"}
+{"version":3,"file":"rendering.d.ts","sourceRoot":"","sources":["../../../../src/platform/knowledge/home-graph/rendering.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,mBAAmB,EACnB,oBAAoB,EAEpB,mBAAmB,EACnB,qBAAqB,EACtB,MAAM,aAAa,CAAC;AAIrB,OAAO,KAAK,EAA6B,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAInG,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,CA2CnF;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;IAC1C,QAAQ,CAAC,aAAa,CAAC,EAAE,SAAS,mBAAmB,EAAE,GAAG,SAAS,CAAC;CACrE,GAAG,MAAM,CAyBT;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,oBAAoB,EAAE,OAAO,GAAE;IACrE,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACzC,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7C,QAAQ,CAAC,aAAa,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,CAAC;IACvD,QAAQ,CAAC,aAAa,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,CAAC;CACnD,GAAG,MAAM,CAkBd;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,oBAAoB,EAAE,OAAO,GAAE,iBAAsB,GAAG,kBAAkB,CAcnH;AAmdD,wBAAgB,cAAc,CAC5B,MAAM,EAAE,SAAS,oBAAoB,EAAE,EACvC,KAAK,EAAE,SAAS,mBAAmB,EAAE,EACrC,OAAO,EAAE,WAAW,CAAC,MAAM,CAAC,EAC5B,OAAO,EAAE,SAAS,qBAAqB,EAAE,GACxC,oBAAoB,EAAE,CAUxB"}

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

@@ -1,6 +1,6 @@
 import { renderKnowledgeMap } from '../map.js';
 import { countFacet, normalizeStringArray, readString } from '../map-filters.js';
-import { edgeIsActive, isGeneratedPageSource, uniqueStrings } from './helpers.js';
+import { edgeIsActive, factSourceIds, isGeneratedPageSource, uniqueStrings } from './helpers.js';
 import { isLowValueFeatureOrSpecText } from '../semantic/fact-quality.js';
 import { isUsefulHomeGraphPageFact, isUsefulHomeGraphPageSource } from './page-quality.js';
 export function renderRoomPage(state, areaId) {
@@ -24,8 +24,8 @@ export function renderRoomPage(state, areaId) {
         ...scenes.map((node) => node.id),
         ...scripts.map((node) => node.id),
     ]);
-    const sources = relatedSources(state.sources, state.edges, relatedNodeIds);
-    const semanticFacts = semanticFactsLinkedToSources(sources, state.nodes, state.edges);
+    const sources = relatedSources(state.sources, state.edges, state.nodes, relatedNodeIds);
+    const semanticFacts = semanticFactsLinkedToSources(sources, state.nodes, state.edges, relatedNodeIds);
     const issues = issuesForScope(state.issues, state.edges, relatedNodeIds, sources);
     return [
         `# ${title}`,
@@ -112,7 +112,7 @@ function applyHomeGraphMapFilters(state, input) {
         .map((node) => node.id));
     const nodeIds = expandHomeGraphMapNodeIds(state.edges, matchedNodeIds);
     const nodes = state.nodes.filter((node) => nodeIds.has(node.id));
-    const sourceIds = sourceIdsLinkedToNodes(state.edges, nodeIds);
+    const sourceIds = sourceIdsLinkedToNodes(state.edges, state.nodes, 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))
@@ -205,7 +205,7 @@ function matchesAreaFilter(areaIds, node, edges, nodes) {
         && edge.relation === 'located_in'
         && targetAreaNodeIds.has(edge.toId));
 }
-function sourceIdsLinkedToNodes(edges, nodeIds) {
+function sourceIdsLinkedToNodes(edges, nodes, nodeIds) {
     const sourceIds = new Set();
     const factIds = new Set();
     for (const edge of edges) {
@@ -226,6 +226,12 @@ function sourceIdsLinkedToNodes(edges, nodeIds) {
             sourceIds.add(edge.fromId);
         }
     }
+    for (const fact of nodes) {
+        if (!factIds.has(fact.id))
+            continue;
+        for (const sourceId of factSourceIds(fact))
+            sourceIds.add(sourceId);
+    }
     return sourceIds;
 }
 function readHomeAssistantRecord(node) {
@@ -342,14 +348,13 @@ function renderPageFactLine(fact) {
         return '';
     const value = cleanPageFactDetail(readString(fact.metadata.value));
     const summary = cleanPageFactDetail(fact.summary);
-    const evidence = cleanPageFactDetail(readString(fact.metadata.evidence));
-    const canonicalValue = selectPageFactValue(title, value, summary, evidence);
-    const detail = selectPageFactDetail(title, canonicalValue, summary, evidence);
+    const canonicalValue = selectPageFactValue(title, value, summary);
+    const detail = selectPageFactDetail(title, canonicalValue, summary);
     const line = normalizePageFactLine(`- ${title}${canonicalValue ? `: ${canonicalValue}` : ''}${detail ? ` - ${detail}` : ''}`);
     return isLowValueFeatureOrSpecText(line) ? '' : line;
 }
-function selectPageFactValue(title, value, summary, evidence) {
-    for (const candidate of [value, extractSummaryValue(title, summary), extractSummaryValue(title, evidence)]) {
+function selectPageFactValue(title, value, summary) {
+    for (const candidate of [value, extractSummaryValue(title, summary)]) {
         if (!candidate)
             continue;
         if (isLowValueFeatureOrSpecText(candidate))
@@ -360,18 +365,15 @@ function selectPageFactValue(title, value, summary, evidence) {
     }
     return undefined;
 }
-function selectPageFactDetail(title, value, summary, evidence) {
-    for (const detail of [summary, evidence]) {
-        if (!detail)
-            continue;
-        const normalized = normalizePageFactText(detail);
-        if (!normalized)
-            continue;
-        if (isRedundantPageFactDetail(title, value, detail))
-            continue;
-        return detail;
-    }
-    return undefined;
+function selectPageFactDetail(title, value, summary) {
+    if (!summary)
+        return undefined;
+    const normalized = normalizePageFactText(summary);
+    if (!normalized)
+        return undefined;
+    if (isRedundantPageFactDetail(title, value, summary))
+        return undefined;
+    return summary;
 }
 function extractSummaryValue(title, detail) {
     if (!detail)
@@ -449,14 +451,30 @@ function normalizePageFactText(value) {
 function escapeRegExp(value) {
     return value.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
 }
-function semanticFactsLinkedToSources(sources, nodes, edges) {
+function semanticFactsLinkedToSources(sources, nodes, edges, nodeIds) {
     const sourceIds = new Set(sources.map((source) => source.id));
+    const describedFactIds = nodeIds ? factIdsDescribingNodes(edges, nodeIds) : undefined;
     const factIds = new Set(edges.filter((edge) => (edgeIsActive(edge)
         && edge.fromKind === 'source'
         && sourceIds.has(edge.fromId)
         && edge.toKind === 'node'
         && edge.relation === 'supports_fact')).map((edge) => edge.toId));
-    return nodes.filter((node) => factIds.has(node.id) && isUsefulHomeGraphPageFact(node));
+    return nodes.filter((node) => ((factIds.has(node.id) || factSourceIds(node).some((sourceId) => sourceIds.has(sourceId)))
+        && (!nodeIds || factHasSubjectLink(node, nodeIds, describedFactIds))
+        && isUsefulHomeGraphPageFact(node)));
+}
+function factIdsDescribingNodes(edges, nodeIds) {
+    return new Set(edges.filter((edge) => (edgeIsActive(edge)
+        && edge.fromKind === 'node'
+        && edge.toKind === 'node'
+        && edge.relation === 'describes'
+        && nodeIds.has(edge.toId))).map((edge) => edge.fromId));
+}
+function factHasSubjectLink(fact, nodeIds, describedFactIds) {
+    if (describedFactIds?.has(fact.id))
+        return true;
+    return normalizeStringArray(fact.metadata.subjectIds).some((id) => nodeIds.has(id))
+        || normalizeStringArray(fact.metadata.linkedObjectIds).some((id) => nodeIds.has(id));
 }
 function semanticFactSortKey(node) {
     const order = {
@@ -529,14 +547,11 @@ function isIssueRelation(relation) {
 function renderMetadataField(label, value) {
     return typeof value === 'string' && value.trim().length > 0 ? `- ${label}: ${value.trim()}` : '';
 }
-function relatedSources(sources, edges, nodeIds) {
+function relatedSources(sources, edges, nodes, nodeIds) {
     const visibleSources = sources.filter((source) => !isGeneratedPageSource(source) && isUsefulHomeGraphPageSource(source));
     if (nodeIds.size === 0)
         return visibleSources;
-    const sourceIds = new Set(edges.filter((edge) => (edgeIsActive(edge)
-        && edge.fromKind === 'source'
-        && edge.toKind === 'node'
-        && nodeIds.has(edge.toId))).map((edge) => edge.fromId));
+    const sourceIds = sourceIdsLinkedToNodes(edges, nodes, nodeIds);
     return visibleSources.filter((source) => sourceIds.has(source.id));
 }
 function filterNodesForArea(nodes, edges, kind, areaNodeId) {

package/dist/platform/knowledge/home-graph/review.d.ts

@@ -4,11 +4,11 @@ import type { HomeGraphReviewInput } from './types.js';
 export interface HomeGraphReviewResult {
     readonly ok: true;
     readonly spaceId: string;
-    readonly issue?: KnowledgeIssueRecord;
-    readonly node?: KnowledgeNodeRecord;
-    readonly source?: KnowledgeSourceRecord;
-    readonly suppression?: Record<string, unknown>;
-    readonly appliedFacts?: Record<string, unknown>;
+    readonly issue?: KnowledgeIssueRecord | undefined;
+    readonly node?: KnowledgeNodeRecord | undefined;
+    readonly source?: KnowledgeSourceRecord | undefined;
+    readonly suppression?: Record<string, unknown> | undefined;
+    readonly appliedFacts?: Record<string, unknown> | undefined;
 }
 export declare function reviewHomeGraphFact(store: KnowledgeStore, spaceId: string, installationId: string, input: HomeGraphReviewInput): Promise<HomeGraphReviewResult>;
 //# sourceMappingURL=review.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"review.d.ts","sourceRoot":"","sources":["../../../../src/platform/knowledge/home-graph/review.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,oBAAoB,EACpB,mBAAmB,EACnB,qBAAqB,EACtB,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAElD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAEvD,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAClB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,CAAC,EAAE,oBAAoB,CAAC;IACtC,QAAQ,CAAC,IAAI,CAAC,EAAE,mBAAmB,CAAC;IACpC,QAAQ,CAAC,MAAM,CAAC,EAAE,qBAAqB,CAAC;IACxC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/C,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjD;AAED,wBAAsB,mBAAmB,CACvC,KAAK,EAAE,cAAc,EACrB,OAAO,EAAE,MAAM,EACf,cAAc,EAAE,MAAM,EACtB,KAAK,EAAE,oBAAoB,GAC1B,OAAO,CAAC,qBAAqB,CAAC,CAqGhC"}
+{"version":3,"file":"review.d.ts","sourceRoot":"","sources":["../../../../src/platform/knowledge/home-graph/review.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,oBAAoB,EACpB,mBAAmB,EACnB,qBAAqB,EACtB,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAElD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAEvD,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAClB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,CAAC,EAAE,oBAAoB,GAAG,SAAS,CAAC;IAClD,QAAQ,CAAC,IAAI,CAAC,EAAE,mBAAmB,GAAG,SAAS,CAAC;IAChD,QAAQ,CAAC,MAAM,CAAC,EAAE,qBAAqB,GAAG,SAAS,CAAC;IACpD,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;IAC3D,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;CAC7D;AAED,wBAAsB,mBAAmB,CACvC,KAAK,EAAE,cAAc,EACrB,OAAO,EAAE,MAAM,EACf,cAAc,EAAE,MAAM,EACtB,KAAK,EAAE,oBAAoB,GAC1B,OAAO,CAAC,qBAAqB,CAAC,CAqGhC"}

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

@@ -1 +1 @@
-{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../../../src/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;AAMrB,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAsIxD,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,CAoBrG;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,CAoFzB;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;AAiMD,wBAAgB,8BAA8B,CAAC,UAAU,EAAE,yBAAyB,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,CAWhH"}
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../../../src/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;AAMrB,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAsIxD,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,CAqBrG;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,CAoFzB;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;AAiMD,wBAAgB,8BAA8B,CAAC,UAAU,EAAE,yBAAyB,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,CAWhH"}

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

@@ -127,7 +127,8 @@ const HOME_GRAPH_ANCHOR_KINDS = new Set([
 ]);
 const INTEGRATION_QUERY_TOKENS = new Set(['automation', 'automations', 'homeassistant', 'integration', 'integrations', 'webostv']);
 export function readHomeGraphSearchState(store, spaceId) {
-    const sources = store.listSourcesInSpace(spaceId).filter((source) => !isGeneratedPageSource(source));
+    const sources = store.listSourcesInSpace(spaceId)
+        .filter((source) => source.status !== 'stale' && !isGeneratedPageSource(source));
     const nodes = store.listNodesInSpace(spaceId).filter((node) => node.status !== 'stale');
     const sourceIds = new Set(sources.map((source) => source.id));
     const nodeIds = new Set(nodes.map((node) => node.id));
@@ -155,7 +156,7 @@ export function scoreHomeGraphResults(query, sources, nodes, edges, extractionBy
     const sourceAnchors = selectSourceAnchors(anchorTokens, anchors.map((anchor) => anchor.node), isSingularObjectQuery(query, tokens));
     const anchorIds = new Set(sourceAnchors.map((node) => node.id));
     const anchorIdentityTokens = collectAnchorIdentityTokens(sourceAnchors);
-    const sourceLinks = buildSourceLinkIndex(edges);
+    const sourceLinks = buildSourceLinkIndex(edges, nodes);
     const useAnchorScope = sourceAnchors.length > 0 && sourceAnchors.length <= ANCHOR_SCOPE_LIMIT;
     const objectScopedQuery = sourceAnchors.length > 0;
     const sourceEvidenceQuery = queryNeedsSourceEvidence(expandedTokens);
@@ -192,7 +193,7 @@ export function scoreHomeGraphResults(query, sources, nodes, edges, extractionBy
         const linkBoost = linkedToAnchor ? 120 + relationBoost(source.id, anchorIds, edges) : 0;
         const inferredAnchorBoost = !linkedToAnchor && anchorIdentityScore > 0 ? Math.min(90, 30 + anchorIdentityScore) : 0;
         const manualBoost = isManualLikeSource(source) ? 24 : 0;
-        const indexedBoost = source.status === 'indexed' ? 18 : source.status === 'stale' ? 6 : 0;
+        const indexedBoost = source.status === 'indexed' ? 18 : 0;
         const extractionBoost = extraction ? 20 : 0;
         const score = baseScore > 0 || linkBoost > 0 || inferredAnchorBoost > 0
             ? baseScore + linkBoost + inferredAnchorBoost + manualBoost + indexedBoost + extractionBoost
@@ -240,7 +241,7 @@ export function selectHomeGraphExtractionRepairCandidates(query, sources, nodes,
     const sourceAnchors = selectSourceAnchors(tokens, anchors.map((anchor) => anchor.node), isSingularObjectQuery(query, tokens));
     const anchorIds = new Set(sourceAnchors.map((anchor) => anchor.id));
     const anchorIdentityTokens = collectAnchorIdentityTokens(sourceAnchors);
-    const sourceLinks = buildSourceLinkIndex(edges);
+    const sourceLinks = buildSourceLinkIndex(edges, nodes);
     return sources
         .map((source) => {
         if (!source.artifactId || !homeGraphExtractionNeedsRepair(extractionBySourceId(source.id)))

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

@@ -32,10 +32,10 @@ export declare class HomeGraphService {
     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;
+        readonly status?: string | undefined;
+        readonly severity?: string | undefined;
+        readonly code?: string | undefined;
+        readonly limit?: number | undefined;
     }): Promise<{
         readonly ok: true;
         readonly spaceId: string;
@@ -54,10 +54,10 @@ export declare class HomeGraphService {
         readonly includeMarkdown?: boolean;
     }): Promise<HomeGraphPageListResult>;
     listRefinementTasks(input?: HomeGraphSpaceInput & {
-        readonly limit?: number;
-        readonly state?: string;
-        readonly subjectId?: string;
-        readonly gapId?: string;
+        readonly limit?: number | undefined;
+        readonly state?: string | undefined;
+        readonly subjectId?: string | undefined;
+        readonly gapId?: string | undefined;
     }): Promise<{
         readonly ok: true;
         readonly spaceId: string;
@@ -71,21 +71,21 @@ export declare class HomeGraphService {
         readonly task: import("../types.js").KnowledgeRefinementTaskRecord | null;
     }>;
     runRefinement(input?: HomeGraphSpaceInput & {
-        readonly gapIds?: readonly string[];
-        readonly sourceIds?: readonly string[];
-        readonly limit?: number;
-        readonly maxRunMs?: number;
-        readonly force?: boolean;
+        readonly gapIds?: readonly string[] | undefined;
+        readonly sourceIds?: readonly string[] | undefined;
+        readonly limit?: number | undefined;
+        readonly maxRunMs?: number | undefined;
+        readonly force?: boolean | undefined;
     }): Promise<{
         ok: boolean;
         spaceId: string;
         error: string;
-        result?: undefined;
+        result?: never;
     } | {
         ok: boolean;
         spaceId: string;
         result: import("../semantic/types.js").KnowledgeSemanticSelfImproveResult;
-        error?: undefined;
+        error?: never;
     }>;
     cancelRefinementTask(input: HomeGraphSpaceInput & {
         readonly taskId: string;
@@ -93,12 +93,12 @@ export declare class HomeGraphService {
         ok: boolean;
         spaceId: string;
         error: string;
-        task?: undefined;
+        task?: never;
     } | {
         ok: boolean;
         spaceId: string;
         task: import("../types.js").KnowledgeRefinementTaskRecord;
-        error?: undefined;
+        error?: never;
     }>;
     browse(input?: HomeGraphSpaceInput & {
         readonly limit?: number;