@pellux/goodvibes-sdk 0.27.12 → 0.28.0

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

@@ -0,0 +1,23 @@
+import type { KnowledgeStore } from '../store.js';
+import type { KnowledgeEdgeRecord, KnowledgeIssueRecord, KnowledgeNodeRecord, KnowledgeSourceRecord } from '../types.js';
+import type { HomeGraphSpaceInput } from './types.js';
+export declare function listHomeGraphSources(input: HomeGraphSpaceInput & {
+    readonly store: KnowledgeStore;
+    readonly limit?: number;
+}): Promise<{
+    readonly ok: true;
+    readonly spaceId: string;
+    readonly sources: readonly KnowledgeSourceRecord[];
+}>;
+export declare function browseHomeGraph(input: HomeGraphSpaceInput & {
+    readonly store: KnowledgeStore;
+    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[];
+}>;
+//# sourceMappingURL=inventory.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"inventory.d.ts","sourceRoot":"","sources":["../../../../../src/_internal/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"}

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

@@ -0,0 +1,21 @@
+import { resolveReadableHomeGraphSpace } from './space-selection.js';
+import { readHomeGraphState } from './state.js';
+export async function listHomeGraphSources(input) {
+    await input.store.init();
+    const { spaceId } = resolveReadableHomeGraphSpace(input.store, input);
+    return { ok: true, spaceId, sources: readHomeGraphState(input.store, spaceId).sources.slice(0, Math.max(1, input.limit ?? 100)) };
+}
+export async function browseHomeGraph(input) {
+    await input.store.init();
+    const { spaceId } = resolveReadableHomeGraphSpace(input.store, input);
+    const limit = Math.max(1, input.limit ?? 250);
+    const state = readHomeGraphState(input.store, spaceId);
+    return {
+        ok: true,
+        spaceId,
+        nodes: state.nodes.slice(0, limit),
+        edges: state.edges.slice(0, limit),
+        sources: state.sources.slice(0, limit),
+        issues: state.issues.slice(0, limit),
+    };
+}

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

@@ -0,0 +1,6 @@
+import type { KnowledgeStore } from '../store.js';
+import type { HomeGraphMapInput, HomeGraphMapResult } from './types.js';
+export declare function mapHomeGraph(input: HomeGraphMapInput & {
+    readonly store: KnowledgeStore;
+}): Promise<HomeGraphMapResult>;
+//# sourceMappingURL=map-view.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"map-view.d.ts","sourceRoot":"","sources":["../../../../../src/_internal/platform/knowledge/home-graph/map-view.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAIlD,OAAO,KAAK,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAExE,wBAAsB,YAAY,CAAC,KAAK,EAAE,iBAAiB,GAAG;IAC5D,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC;CAChC,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAO9B"}

package/dist/_internal/platform/knowledge/home-graph/map-view.js

@@ -0,0 +1,11 @@
+import { renderHomeGraphMap } from './rendering.js';
+import { resolveReadableHomeGraphSpace } from './space-selection.js';
+import { renderHomeGraphState } from './state.js';
+export async function mapHomeGraph(input) {
+    await input.store.init();
+    const { spaceId } = resolveReadableHomeGraphSpace(input.store, input);
+    return renderHomeGraphMap(renderHomeGraphState(input.store, spaceId, 'Home Graph Map'), {
+        ...input,
+        knowledgeSpaceId: spaceId,
+    });
+}

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

@@ -0,0 +1,56 @@
+import type { KnowledgeSemanticService } from '../semantic/index.js';
+import type { KnowledgeStore } from '../store.js';
+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;
+}): Promise<{
+    readonly ok: true;
+    readonly spaceId: string;
+    readonly tasks: readonly KnowledgeRefinementTaskRecord[];
+}>;
+export declare function getHomeGraphRefinementTask(input: HomeGraphSpaceInput & {
+    readonly store: KnowledgeStore;
+    readonly taskId: string;
+}): Promise<{
+    readonly ok: true;
+    readonly spaceId: string;
+    readonly task: KnowledgeRefinementTaskRecord | null;
+}>;
+export declare function runHomeGraphRefinement(input: HomeGraphSpaceInput & {
+    readonly store: KnowledgeStore;
+    readonly semanticService?: KnowledgeSemanticService;
+    readonly gapIds?: readonly string[];
+    readonly sourceIds?: readonly string[];
+    readonly limit?: number;
+    readonly force?: boolean;
+}): Promise<{
+    ok: boolean;
+    spaceId: string;
+    error: string;
+    result?: undefined;
+} | {
+    ok: boolean;
+    spaceId: string;
+    result: import("../semantic/types.js").KnowledgeSemanticSelfImproveResult;
+    error?: undefined;
+}>;
+export declare function cancelHomeGraphRefinementTask(input: HomeGraphSpaceInput & {
+    readonly store: KnowledgeStore;
+    readonly taskId: string;
+}): Promise<{
+    ok: boolean;
+    spaceId: string;
+    error: string;
+    task?: undefined;
+} | {
+    ok: boolean;
+    spaceId: string;
+    task: KnowledgeRefinementTaskRecord;
+    error?: undefined;
+}>;
+//# sourceMappingURL=refinement.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"refinement.d.ts","sourceRoot":"","sources":["../../../../../src/_internal/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,KAAK,CAAC,EAAE,OAAO,CAAC;CAC1B;;;;;;;;;;GAaA;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/_internal/platform/knowledge/home-graph/refinement.js

@@ -0,0 +1,62 @@
+import { resolveReadableHomeGraphSpace } from './space-selection.js';
+export async function listHomeGraphRefinementTasks(input) {
+    await input.store.init();
+    const { spaceId } = resolveReadableHomeGraphSpace(input.store, input);
+    return {
+        ok: true,
+        spaceId,
+        tasks: input.store.listRefinementTasks(input.limit ?? 100, {
+            spaceId,
+            state: input.state,
+            subjectKind: input.subjectId ? 'node' : undefined,
+            subjectId: input.subjectId,
+            gapId: input.gapId,
+        }),
+    };
+}
+export async function getHomeGraphRefinementTask(input) {
+    await input.store.init();
+    const { spaceId } = resolveReadableHomeGraphSpace(input.store, input);
+    const task = input.store.getRefinementTask(input.taskId);
+    return { ok: true, spaceId, task: task?.spaceId === spaceId ? task : null };
+}
+export async function runHomeGraphRefinement(input) {
+    await input.store.init();
+    const { spaceId } = resolveReadableHomeGraphSpace(input.store, input);
+    if (!input.semanticService)
+        return { ok: false, spaceId, error: 'Semantic refinement is not configured.' };
+    const result = await input.semanticService.selfImprove({
+        knowledgeSpaceId: spaceId,
+        gapIds: input.gapIds,
+        sourceIds: input.sourceIds,
+        limit: input.limit,
+        force: input.force,
+        reason: 'manual',
+    });
+    return { ok: true, spaceId, result };
+}
+export async function cancelHomeGraphRefinementTask(input) {
+    await input.store.init();
+    const { spaceId } = resolveReadableHomeGraphSpace(input.store, input);
+    const task = input.store.getRefinementTask(input.taskId);
+    if (!task || task.spaceId !== spaceId)
+        return { ok: false, spaceId, error: 'Unknown Home Graph refinement task.' };
+    const cancelled = await input.store.upsertRefinementTask({
+        id: task.id,
+        spaceId: task.spaceId,
+        subjectKind: task.subjectKind,
+        subjectId: task.subjectId,
+        subjectTitle: task.subjectTitle,
+        subjectType: task.subjectType,
+        gapId: task.gapId,
+        issueId: task.issueId,
+        state: 'cancelled',
+        priority: task.priority,
+        trigger: task.trigger,
+        budget: task.budget,
+        attemptCount: task.attemptCount,
+        appendTrace: [{ at: Date.now(), state: 'cancelled', message: 'Home Graph refinement task was cancelled by request.' }],
+        metadata: task.metadata,
+    });
+    return { ok: true, spaceId, task: cancelled };
+}

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

@@ -1,4 +1,4 @@
-import type { KnowledgeEdgeRecord, KnowledgeExtractionRecord, KnowledgeIssueRecord, KnowledgeNodeRecord, KnowledgeSourceRecord } from '../types.js';
+import type { KnowledgeEdgeRecord, KnowledgeIssueRecord, KnowledgeNodeRecord, KnowledgeSourceRecord } from '../types.js';
 import type { HomeGraphMapInput, HomeGraphMapResult } from './types.js';
 export interface HomeGraphRenderState {
     readonly spaceId: string;
@@ -7,7 +7,6 @@ export interface HomeGraphRenderState {
     readonly nodes: readonly KnowledgeNodeRecord[];
     readonly edges: readonly KnowledgeEdgeRecord[];
     readonly issues: readonly KnowledgeIssueRecord[];
-    readonly extractions?: readonly KnowledgeExtractionRecord[];
 }
 export declare function renderRoomPage(state: HomeGraphRenderState, areaId?: string): string;
 export declare function renderDevicePassportPage(input: {
@@ -15,10 +14,10 @@ export declare function renderDevicePassportPage(input: {
     readonly device: KnowledgeNodeRecord;
     readonly entities: readonly KnowledgeNodeRecord[];
     readonly sources: readonly KnowledgeSourceRecord[];
-    readonly extractions?: readonly KnowledgeExtractionRecord[];
     readonly issues: readonly KnowledgeIssueRecord[];
     readonly missingFields: readonly string[];
     readonly semanticFacts?: readonly KnowledgeNodeRecord[];
+    readonly sourceBackedNotes?: readonly string[];
 }): string;
 export declare function renderPacketPage(state: HomeGraphRenderState, options?: {
     readonly packetKind?: string;
@@ -27,4 +26,5 @@ export declare function renderPacketPage(state: HomeGraphRenderState, options?:
     readonly excludeFields?: readonly string[];
 }): 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[];
 //# sourceMappingURL=rendering.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"rendering.d.ts","sourceRoot":"","sources":["../../../../../src/_internal/platform/knowledge/home-graph/rendering.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,mBAAmB,EACnB,yBAAyB,EACzB,oBAAoB,EAEpB,mBAAmB,EACnB,qBAAqB,EACtB,MAAM,aAAa,CAAC;AAKrB,OAAO,KAAK,EAA6B,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAGnG,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,SAAS,qBAAqB,EAAE,CAAC;IACnD,QAAQ,CAAC,KAAK,EAAE,SAAS,mBAAmB,EAAE,CAAC;IAC/C,QAAQ,CAAC,KAAK,EAAE,SAAS,mBAAmB,EAAE,CAAC;IAC/C,QAAQ,CAAC,MAAM,EAAE,SAAS,oBAAoB,EAAE,CAAC;IACjD,QAAQ,CAAC,WAAW,CAAC,EAAE,SAAS,yBAAyB,EAAE,CAAC;CAC7D;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,oBAAoB,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAmDnF;AAED,wBAAgB,wBAAwB,CAAC,KAAK,EAAE;IAC9C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,mBAAmB,CAAC;IACrC,QAAQ,CAAC,QAAQ,EAAE,SAAS,mBAAmB,EAAE,CAAC;IAClD,QAAQ,CAAC,OAAO,EAAE,SAAS,qBAAqB,EAAE,CAAC;IACnD,QAAQ,CAAC,WAAW,CAAC,EAAE,SAAS,yBAAyB,EAAE,CAAC;IAC5D,QAAQ,CAAC,MAAM,EAAE,SAAS,oBAAoB,EAAE,CAAC;IACjD,QAAQ,CAAC,aAAa,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1C,QAAQ,CAAC,aAAa,CAAC,EAAE,SAAS,mBAAmB,EAAE,CAAC;CACzD,GAAG,MAAM,CA+BT;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"}
+{"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,EAEpB,mBAAmB,EACnB,qBAAqB,EACtB,MAAM,aAAa,CAAC;AAIrB,OAAO,KAAK,EAA6B,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAGnG,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;IACxD,QAAQ,CAAC,iBAAiB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAChD,GAAG,MAAM,CA0BT;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;AAsRD,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/_internal/platform/knowledge/home-graph/rendering.js

@@ -1,8 +1,7 @@
 import { renderKnowledgeMap } from '../map.js';
 import { countFacet, normalizeStringArray, readString } from '../map-filters.js';
-import { isUnusableHomeGraphExtractionText } from './extraction-quality.js';
-import { edgeIsActive, isGeneratedPageSource, readRecord, uniqueStrings } from './helpers.js';
-import { isLowValueFeatureOrSpecText, isUsefulHomeGraphPageFact } from '../semantic/fact-quality.js';
+import { edgeIsActive, isGeneratedPageSource, uniqueStrings } from './helpers.js';
+import { isUsefulHomeGraphPageFact } from '../semantic/fact-quality.js';
 export function renderRoomPage(state, areaId) {
     const area = areaId
         ? findNodeByHaId(state.nodes, 'ha_area', areaId) ?? findNodeByHaId(state.nodes, 'ha_room', areaId)
@@ -26,6 +25,7 @@ export function renderRoomPage(state, areaId) {
     ]);
     const sources = relatedSources(state.sources, state.edges, relatedNodeIds);
     const semanticFacts = semanticFactsLinkedToSources(sources, state.nodes, state.edges);
+    const issues = issuesForScope(state.issues, state.edges, relatedNodeIds, sources);
     return [
         `# ${title}`,
         '',
@@ -37,22 +37,12 @@ export function renderRoomPage(state, areaId) {
         renderNodeList('Automations', automations),
         renderNodeList('Scenes', scenes),
         renderNodeList('Scripts', scripts),
-        renderSourceEvidence('Source-Backed Knowledge', sources, state.extractions ?? [], {
-            tokens: uniqueStrings([
-                title,
-                ...devices.map((node) => node.title),
-                ...entities.map((node) => node.title),
-            ].flatMap(tokenizeEvidence)),
-            maxSources: 12,
-            maxSnippetsPerSource: 2,
-        }),
         renderSemanticFacts('Extracted Facts', semanticFacts),
         renderSourceList('Linked Sources', sources),
-        renderIssueList('Open Issues', state.issues.filter((issue) => issue.status === 'open')),
+        renderIssueList('Open Issues', issues),
     ].filter(Boolean).join('\n');
 }
 export function renderDevicePassportPage(input) {
-    const deviceTokens = deviceEvidenceTokens(input.device, input.entities);
     return [
         `# ${input.device.title}`,
         '',
@@ -70,14 +60,10 @@ export function renderDevicePassportPage(input) {
         renderMetadataField('Device id', readHa(input.device, 'deviceId')),
         '',
         renderNodeList('Entities Exposed To Home Assistant', input.entities),
-        renderSemanticFacts('Extracted Device Facts', input.semanticFacts ?? []),
-        renderSourceEvidence('Source-Backed Features And Notes', input.sources, input.extractions ?? [], {
-            tokens: deviceTokens,
-            maxSources: 8,
-            maxSnippetsPerSource: 4,
-        }),
+        renderSemanticFacts('Verified Device Facts', input.semanticFacts ?? []),
+        renderTextList('Source-Backed Features And Notes', input.sourceBackedNotes ?? []),
         renderSourceList('Sources', input.sources),
-        renderIssueList('Issues', input.issues),
+        renderIssueList('Open Issues', input.issues.filter((issue) => issue.status === 'open')),
         input.missingFields.length > 0
             ? ['## Open Questions', '', ...input.missingFields.map((field) => `- ${field}`), ''].join('\n')
             : '',
@@ -257,121 +243,6 @@ function renderDeviceOverview(device, entities, sources) {
     const details = identity.length > 0 ? ` ${identity.join(' - ')}.` : '.';
     return `${device.title}${details} The Home Graph links this device to ${entities.length} Home Assistant entity record(s) and ${sources.length} source(s).`;
 }
-function renderSourceEvidence(title, sources, extractions, options) {
-    const extractionBySourceId = new Map(extractions.map((extraction) => [extraction.sourceId, extraction]));
-    const entries = sources
-        .map((source) => ({
-        source,
-        snippets: sourceEvidenceSnippets(source, extractionBySourceId.get(source.id), options.tokens, options.maxSnippetsPerSource),
-    }))
-        .filter((entry) => entry.snippets.length > 0)
-        .slice(0, options.maxSources);
-    if (entries.length === 0) {
-        return [
-            `## ${title}`,
-            '',
-            'No linked source-backed details have been extracted yet.',
-            '',
-        ].join('\n');
-    }
-    return [
-        `## ${title}`,
-        '',
-        ...entries.flatMap((entry) => [
-            `### ${entry.source.title ?? entry.source.sourceUri ?? entry.source.id}`,
-            '',
-            ...entry.snippets.map((snippet) => `- ${snippet}`),
-            '',
-        ]),
-    ].join('\n');
-}
-function sourceEvidenceSnippets(source, extraction, tokens, limit) {
-    const structure = readRecord(extraction?.structure);
-    const searchText = typeof structure.searchText === 'string' ? structure.searchText : undefined;
-    const candidates = uniqueStrings([
-        extraction?.summary,
-        extraction?.excerpt,
-        ...(extraction?.sections ?? []),
-        ...evidenceWindows(searchText, tokens),
-        ...featureSentences(searchText),
-        source.summary,
-        source.description,
-    ]).filter((entry) => !isUnusableHomeGraphExtractionText(entry) && !isLowValueFeatureOrSpecText(entry)).slice(0, 80);
-    const scored = candidates
-        .map((text) => ({ text: clampEvidence(text), score: evidenceScore(text, tokens) }))
-        .filter((entry) => entry.text.length > 0)
-        .sort((left, right) => right.score - left.score || left.text.length - right.text.length);
-    return uniqueStrings(scored.map((entry) => entry.text)).slice(0, limit);
-}
-function evidenceWindows(value, tokens) {
-    const text = normalizeWhitespace(value ?? '');
-    if (!text)
-        return [];
-    const lower = text.toLowerCase();
-    const windows = [];
-    for (const token of tokens) {
-        if (token.length < 3)
-            continue;
-        const index = lower.indexOf(token.toLowerCase());
-        if (index < 0)
-            continue;
-        const start = Math.max(0, index - 180);
-        const end = Math.min(text.length, index + 420);
-        windows.push(`${start > 0 ? '...' : ''}${text.slice(start, end).trim()}${end < text.length ? '...' : ''}`);
-    }
-    return windows;
-}
-function featureSentences(value) {
-    const text = normalizeWhitespace(value ?? '');
-    if (!text)
-        return [];
-    const keywords = /\b(feature|features|support|supports|capability|capabilities|specification|specifications|mode|modes|hdmi|hdr|dolby|battery|reset|warranty|firmware|voice|remote)\b/i;
-    return (text.match(/[^.!?\n]+[.!?]?/g) ?? [])
-        .map((entry) => entry.trim())
-        .filter((entry) => keywords.test(entry) && !isLowValueFeatureOrSpecText(entry))
-        .slice(0, 24);
-}
-function evidenceScore(value, tokens) {
-    const lower = value.toLowerCase();
-    let score = 0;
-    for (const token of tokens) {
-        if (token.length >= 3 && lower.includes(token.toLowerCase()))
-            score += 10;
-    }
-    if (/\b(feature|features|support|supports|mode|hdmi|hdr|dolby|voice|remote)\b/i.test(value))
-        score += 25;
-    return score;
-}
-function deviceEvidenceTokens(device, entities) {
-    return uniqueStrings([
-        device.title,
-        ...device.aliases,
-        readMetadataString(device, 'manufacturer'),
-        readMetadataString(device, 'model'),
-        readHa(device, 'deviceId'),
-        ...entities.flatMap((entity) => [
-            entity.title,
-            readHa(entity, 'entityId'),
-            readMetadataString(entity, 'domain'),
-            readMetadataString(entity, 'platform'),
-        ]),
-    ].flatMap(tokenizeEvidence));
-}
-function tokenizeEvidence(value) {
-    if (!value)
-        return [];
-    return value.toLowerCase()
-        .split(/[^a-z0-9_.:-]+/)
-        .map((entry) => entry.trim())
-        .filter((entry) => entry.length >= 2 && !['the', 'and', 'home', 'assistant', 'device'].includes(entry));
-}
-function clampEvidence(value) {
-    const normalized = normalizeWhitespace(value);
-    return normalized.length <= 420 ? normalized : `${normalized.slice(0, 419).trim()}...`;
-}
-function normalizeWhitespace(value) {
-    return value.replace(/\s+/g, ' ').trim();
-}
 function readMetadataString(node, key) {
     const value = node.metadata[key];
     return typeof value === 'string' && value.trim().length > 0 ? value.trim() : undefined;
@@ -417,6 +288,17 @@ function renderSemanticFacts(title, facts) {
         ]),
     ].join('\n');
 }
+function renderTextList(title, items) {
+    const entries = uniqueStrings(items).slice(0, 80);
+    if (entries.length === 0)
+        return '';
+    return [
+        `## ${title}`,
+        '',
+        ...entries.map((item) => `- ${item}`),
+        '',
+    ].join('\n');
+}
 function semanticFactsLinkedToSources(sources, nodes, edges) {
     const sourceIds = new Set(sources.map((source) => source.id));
     const factIds = new Set(edges.filter((edge) => (edgeIsActive(edge)
@@ -450,6 +332,40 @@ function renderIssueList(title, issues) {
         '',
     ].join('\n');
 }
+export function issuesForScope(issues, edges, nodeIds, sources) {
+    const sourceIds = new Set(sources.map((source) => source.id));
+    const scopedNodeIds = expandScopedIssueNodeIds(edges, nodeIds, sourceIds);
+    return issues.filter((issue) => (issue.status === 'open'
+        && ((issue.nodeId !== undefined && scopedNodeIds.has(issue.nodeId))
+            || (issue.sourceId !== undefined && sourceIds.has(issue.sourceId)))));
+}
+function expandScopedIssueNodeIds(edges, nodeIds, sourceIds) {
+    const scoped = new Set(nodeIds);
+    let changed = true;
+    while (changed) {
+        changed = false;
+        for (const edge of edges) {
+            if (!edgeIsActive(edge))
+                continue;
+            if (edge.toKind !== 'node')
+                continue;
+            const fromScopedNode = edge.fromKind === 'node' && scoped.has(edge.fromId);
+            const fromScopedSource = edge.fromKind === 'source' && sourceIds.has(edge.fromId);
+            if ((fromScopedNode || fromScopedSource) && isIssueRelation(edge.relation) && !scoped.has(edge.toId)) {
+                scoped.add(edge.toId);
+                changed = true;
+            }
+        }
+    }
+    return scoped;
+}
+function isIssueRelation(relation) {
+    return relation === 'has_gap'
+        || relation === 'has_issue'
+        || relation === 'source_for'
+        || relation === 'supports_fact'
+        || relation === 'mentions';
+}
 function renderMetadataField(label, value) {
     return typeof value === 'string' && value.trim().length > 0 ? `- ${label}: ${value.trim()}` : '';
 }

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

@@ -49,6 +49,52 @@ export declare class HomeGraphService {
         readonly limit?: number;
         readonly includeMarkdown?: boolean;
     }): Promise<HomeGraphPageListResult>;
+    listRefinementTasks(input?: HomeGraphSpaceInput & {
+        readonly limit?: number;
+        readonly state?: string;
+        readonly subjectId?: string;
+        readonly gapId?: string;
+    }): Promise<{
+        readonly ok: true;
+        readonly spaceId: string;
+        readonly tasks: readonly import("../types.js").KnowledgeRefinementTaskRecord[];
+    }>;
+    getRefinementTask(input: HomeGraphSpaceInput & {
+        readonly taskId: string;
+    }): Promise<{
+        readonly ok: true;
+        readonly spaceId: string;
+        readonly task: import("../types.js").KnowledgeRefinementTaskRecord | null;
+    }>;
+    runRefinement(input?: HomeGraphSpaceInput & {
+        readonly gapIds?: readonly string[];
+        readonly sourceIds?: readonly string[];
+        readonly limit?: number;
+        readonly force?: boolean;
+    }): Promise<{
+        ok: boolean;
+        spaceId: string;
+        error: string;
+        result?: undefined;
+    } | {
+        ok: boolean;
+        spaceId: string;
+        result: import("../semantic/types.js").KnowledgeSemanticSelfImproveResult;
+        error?: undefined;
+    }>;
+    cancelRefinementTask(input: HomeGraphSpaceInput & {
+        readonly taskId: string;
+    }): Promise<{
+        ok: boolean;
+        spaceId: string;
+        error: string;
+        task?: undefined;
+    } | {
+        ok: boolean;
+        spaceId: string;
+        task: import("../types.js").KnowledgeRefinementTaskRecord;
+        error?: undefined;
+    }>;
     browse(input?: HomeGraphSpaceInput & {
         readonly limit?: number;
     }): Promise<{

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

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

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

@@ -3,17 +3,19 @@ import { HOME_GRAPH_CONNECTOR_ID, belongsToSpace, buildHomeGraphMetadata, buildH
 import { upsertIntegrationDocumentationCandidates } from './documentation.js';
 import { refreshHomeGraphQualityIssues } from './quality.js';
 import { reviewHomeGraphFact } from './review.js';
-import { inferHomeGraphSourceType, readHomeGraphState, renderHomeGraphState, safeHomeGraphFilename, } from './state.js';
+import { inferHomeGraphSourceType, readHomeGraphState, safeHomeGraphFilename, } from './state.js';
 import { answerHomeGraphQuery } from './ask.js';
-import { renderHomeGraphMap } from './rendering.js';
 import { autoLinkHomeGraphSource, autoLinkHomeGraphSources, } from './auto-link.js';
 import { generateAutomaticHomeGraphPages, generateHomeGraphPacket, generateHomeGraphRoomPage, refreshAutomaticHomeGraphPages, refreshHomeGraphDevicePassport, } from './generated-pages.js';
 import { reindexHomeGraphSources } from './reindex.js';
 import { listHomeGraphPages } from './pages.js';
+import { browseHomeGraph, listHomeGraphSources } from './inventory.js';
+import { mapHomeGraph } from './map-view.js';
+import { getHomeGraphStatus } from './status.js';
+import { cancelHomeGraphRefinementTask, getHomeGraphRefinementTask, listHomeGraphRefinementTasks, runHomeGraphRefinement, } from './refinement.js';
 import { isUnusableHomeGraphExtractionText } from './extraction-quality.js';
 import { readHomeGraphSearchState, scoreHomeGraphResults, selectHomeGraphExtractionRepairCandidates, } from './search.js';
 import { resolveReadableHomeGraphSpace } from './space-selection.js';
-import { HOME_GRAPH_CAPABILITIES } from './types.js';
 export class HomeGraphService {
     store;
     artifactStore;
@@ -24,24 +26,7 @@ export class HomeGraphService {
         this.options = options;
     }
     async status(input = {}) {
-        await this.store.init();
-        const { spaceId, installationId } = resolveReadableHomeGraphSpace(this.store, input);
-        const state = readHomeGraphState(this.store, spaceId);
-        const snapshotSources = state.sources
-            .filter((source) => source.metadata.homeGraphSourceKind === 'snapshot')
-            .sort((a, b) => b.updatedAt - a.updatedAt);
-        return {
-            ok: true,
-            spaceId,
-            installationId,
-            sourceCount: state.sources.length,
-            nodeCount: state.nodes.length,
-            edgeCount: state.edges.length,
-            issueCount: state.issues.length,
-            extractionCount: state.extractions.length,
-            ...(snapshotSources[0]?.updatedAt ? { lastSnapshotAt: snapshotSources[0].updatedAt } : {}),
-            capabilities: HOME_GRAPH_CAPABILITIES,
-        };
+        return getHomeGraphStatus(this.store, input);
     }
     async syncSnapshot(input) {
         await this.store.init();
@@ -326,9 +311,7 @@ export class HomeGraphService {
         return reviewHomeGraphFact(this.store, spaceId, installationId, input);
     }
     async listSources(input = {}) {
-        await this.store.init();
-        const { spaceId } = resolveReadableHomeGraphSpace(this.store, input);
-        return { ok: true, spaceId, sources: readHomeGraphState(this.store, spaceId).sources.slice(0, Math.max(1, input.limit ?? 100)) };
+        return listHomeGraphSources({ ...input, store: this.store });
     }
     async listPages(input = {}) {
         await this.store.init();
@@ -342,27 +325,23 @@ export class HomeGraphService {
             includeMarkdown: input.includeMarkdown !== false,
         });
     }
+    async listRefinementTasks(input = {}) {
+        return listHomeGraphRefinementTasks({ ...input, store: this.store });
+    }
+    async getRefinementTask(input) {
+        return getHomeGraphRefinementTask({ ...input, store: this.store });
+    }
+    async runRefinement(input = {}) {
+        return runHomeGraphRefinement({ ...input, store: this.store, semanticService: this.options.semanticService });
+    }
+    async cancelRefinementTask(input) {
+        return cancelHomeGraphRefinementTask({ ...input, store: this.store });
+    }
     async browse(input = {}) {
-        await this.store.init();
-        const { spaceId } = resolveReadableHomeGraphSpace(this.store, input);
-        const limit = Math.max(1, input.limit ?? 250);
-        const state = readHomeGraphState(this.store, spaceId);
-        return {
-            ok: true,
-            spaceId,
-            nodes: state.nodes.slice(0, limit),
-            edges: state.edges.slice(0, limit),
-            sources: state.sources.slice(0, limit),
-            issues: state.issues.slice(0, limit),
-        };
+        return browseHomeGraph({ ...input, store: this.store });
     }
     async map(input = {}) {
-        await this.store.init();
-        const { spaceId } = resolveReadableHomeGraphSpace(this.store, input);
-        return renderHomeGraphMap(renderHomeGraphState(this.store, spaceId, 'Home Graph Map'), {
-            ...input,
-            knowledgeSpaceId: spaceId,
-        });
+        return mapHomeGraph({ ...input, store: this.store });
     }
     async exportSpace(input = {}) {
         await this.store.init();