@pellux/goodvibes-sdk 0.30.2 → 0.33.0

package/dist/platform/knowledge/browser-history/types.d.ts

@@ -6,41 +6,41 @@ export interface BrowserKnowledgeProfile {
     readonly browser: BrowserKnowledgeKind;
     readonly profileName: string;
     readonly profilePath: string;
-    readonly historyPath?: string;
-    readonly bookmarksPath?: string;
+    readonly historyPath?: string | undefined;
+    readonly bookmarksPath?: string | undefined;
 }
 export interface BrowserHistoryEntry {
     readonly sourceKind: 'history';
     readonly url: string;
-    readonly title?: string;
+    readonly title?: string | undefined;
     readonly browser: BrowserKnowledgeKind;
     readonly family: BrowserKnowledgeFamily;
     readonly profileName: string;
     readonly profilePath: string;
-    readonly visitedAtMs?: number;
-    readonly visitCount?: number;
-    readonly transition?: string;
-    readonly rawId?: string | number;
+    readonly visitedAtMs?: number | undefined;
+    readonly visitCount?: number | undefined;
+    readonly transition?: string | undefined;
+    readonly rawId?: string | number | undefined;
 }
 export interface BrowserBookmarkEntry {
     readonly sourceKind: 'bookmark';
     readonly url: string;
-    readonly title?: string;
+    readonly title?: string | undefined;
     readonly browser: BrowserKnowledgeKind;
     readonly family: BrowserKnowledgeFamily;
     readonly profileName: string;
     readonly profilePath: string;
-    readonly folderPath?: string;
-    readonly addedAtMs?: number;
-    readonly rawId?: string | number;
+    readonly folderPath?: string | undefined;
+    readonly addedAtMs?: number | undefined;
+    readonly rawId?: string | number | undefined;
 }
 export type BrowserKnowledgeEntry = BrowserHistoryEntry | BrowserBookmarkEntry;
 export interface BrowserKnowledgeFilter {
-    readonly browsers?: readonly BrowserKnowledgeKind[];
-    readonly sourceKinds?: readonly BrowserKnowledgeSourceKind[];
-    readonly homeOverride?: string;
-    readonly limit?: number;
-    readonly sinceMs?: number;
+    readonly browsers?: readonly BrowserKnowledgeKind[] | undefined;
+    readonly sourceKinds?: readonly BrowserKnowledgeSourceKind[] | undefined;
+    readonly homeOverride?: string | undefined;
+    readonly limit?: number | undefined;
+    readonly sinceMs?: number | undefined;
 }
 export interface BrowserKnowledgeCollectResult {
     readonly profiles: readonly BrowserKnowledgeProfile[];

package/dist/platform/knowledge/browser-history/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/platform/knowledge/browser-history/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,sBAAsB,GAAG,UAAU,GAAG,OAAO,GAAG,QAAQ,CAAC;AAErE,MAAM,MAAM,oBAAoB,GAC5B,QAAQ,GACR,UAAU,GACV,OAAO,GACP,MAAM,GACN,SAAS,GACT,KAAK,GACL,OAAO,GACP,SAAS,GACT,KAAK,GACL,WAAW,GACX,UAAU,GACV,QAAQ,GACR,QAAQ,GACR,OAAO,GACP,UAAU,CAAC;AAEf,MAAM,MAAM,0BAA0B,GAAG,SAAS,GAAG,UAAU,CAAC;AAEhE,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,MAAM,EAAE,sBAAsB,CAAC;IACxC,QAAQ,CAAC,OAAO,EAAE,oBAAoB,CAAC;IACvC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;CACjC;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,UAAU,EAAE,SAAS,CAAC;IAC/B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,oBAAoB,CAAC;IACvC,QAAQ,CAAC,MAAM,EAAE,sBAAsB,CAAC;IACxC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CAClC;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC;IAChC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,oBAAoB,CAAC;IACvC,QAAQ,CAAC,MAAM,EAAE,sBAAsB,CAAC;IACxC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CAClC;AAED,MAAM,MAAM,qBAAqB,GAAG,mBAAmB,GAAG,oBAAoB,CAAC;AAE/E,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,oBAAoB,EAAE,CAAC;IACpD,QAAQ,CAAC,WAAW,CAAC,EAAE,SAAS,0BAA0B,EAAE,CAAC;IAC7D,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,QAAQ,EAAE,SAAS,uBAAuB,EAAE,CAAC;IACtD,QAAQ,CAAC,OAAO,EAAE,SAAS,qBAAqB,EAAE,CAAC;IACnD,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;CACpC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/platform/knowledge/browser-history/types.ts"],"names":[],"mappings":"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"}

package/dist/platform/knowledge/consolidation.d.ts

@@ -7,14 +7,14 @@ export interface KnowledgeConsolidationContext {
     readonly syncReviewedMemory: () => Promise<void>;
 }
 export declare function decideKnowledgeConsolidationCandidate(context: KnowledgeConsolidationContext, id: string, decision: 'accept' | 'reject' | 'supersede', input?: {
-    readonly decidedBy?: string;
-    readonly memoryClass?: string;
-    readonly scope?: string;
-    readonly detail?: string;
+    readonly decidedBy?: string | undefined;
+    readonly memoryClass?: string | undefined;
+    readonly scope?: string | undefined;
+    readonly detail?: string | undefined;
 }): Promise<KnowledgeConsolidationCandidateRecord>;
 export declare function refreshKnowledgeConsolidationCandidates(context: KnowledgeConsolidationContext, limit?: number): Promise<KnowledgeConsolidationCandidateRecord[]>;
 export declare function runKnowledgeConsolidation(context: KnowledgeConsolidationContext, kind: Extract<KnowledgeConsolidationReportRecord['kind'], 'light-consolidation' | 'deep-consolidation'>, input: {
-    readonly limit?: number;
+    readonly limit?: number | undefined;
     readonly autoPromote: boolean;
 }): Promise<KnowledgeConsolidationReportRecord>;
 export declare function syncReviewedKnowledgeMemory(context: {

package/dist/platform/knowledge/consolidation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"consolidation.d.ts","sourceRoot":"","sources":["../../../src/platform/knowledge/consolidation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAe,cAAc,EAAe,MAAM,mBAAmB,CAAC;AAClF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,KAAK,EACV,qCAAqC,EACrC,kCAAkC,EAInC,MAAM,YAAY,CAAC;AAYpB,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC;IAC/B,QAAQ,CAAC,cAAc,EAAE,IAAI,CAAC,cAAc,EAAE,KAAK,GAAG,UAAU,CAAC,CAAC;IAClE,QAAQ,CAAC,kBAAkB,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAClD;AAED,wBAAsB,qCAAqC,CACzD,OAAO,EAAE,6BAA6B,EACtC,EAAE,EAAE,MAAM,EACV,QAAQ,EAAE,QAAQ,GAAG,QAAQ,GAAG,WAAW,EAC3C,KAAK,GAAE;IACL,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CACrB,GACL,OAAO,CAAC,qCAAqC,CAAC,CA4DhD;AAED,wBAAsB,uCAAuC,CAC3D,OAAO,EAAE,6BAA6B,EACtC,KAAK,SAAK,GACT,OAAO,CAAC,qCAAqC,EAAE,CAAC,CAgFlD;AAED,wBAAsB,yBAAyB,CAC7C,OAAO,EAAE,6BAA6B,EACtC,IAAI,EAAE,OAAO,CAAC,kCAAkC,CAAC,MAAM,CAAC,EAAE,qBAAqB,GAAG,oBAAoB,CAAC,EACvG,KAAK,EAAE;IAAE,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAA;CAAE,GAChE,OAAO,CAAC,kCAAkC,CAAC,CA0C7C;AAED,wBAAsB,2BAA2B,CAAC,OAAO,EAAE;IAAE,QAAQ,CAAC,kBAAkB,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;CAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAE9H"}
+{"version":3,"file":"consolidation.d.ts","sourceRoot":"","sources":["../../../src/platform/knowledge/consolidation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAe,cAAc,EAAe,MAAM,mBAAmB,CAAC;AAClF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,KAAK,EACV,qCAAqC,EACrC,kCAAkC,EAInC,MAAM,YAAY,CAAC;AAYpB,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC;IAC/B,QAAQ,CAAC,cAAc,EAAE,IAAI,CAAC,cAAc,EAAE,KAAK,GAAG,UAAU,CAAC,CAAC;IAClE,QAAQ,CAAC,kBAAkB,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAClD;AAED,wBAAsB,qCAAqC,CACzD,OAAO,EAAE,6BAA6B,EACtC,EAAE,EAAE,MAAM,EACV,QAAQ,EAAE,QAAQ,GAAG,QAAQ,GAAG,WAAW,EAC3C,KAAK,GAAE;IACL,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACxC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1C,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACjC,GACL,OAAO,CAAC,qCAAqC,CAAC,CA4DhD;AAED,wBAAsB,uCAAuC,CAC3D,OAAO,EAAE,6BAA6B,EACtC,KAAK,SAAK,GACT,OAAO,CAAC,qCAAqC,EAAE,CAAC,CAgFlD;AAED,wBAAsB,yBAAyB,CAC7C,OAAO,EAAE,6BAA6B,EACtC,IAAI,EAAE,OAAO,CAAC,kCAAkC,CAAC,MAAM,CAAC,EAAE,qBAAqB,GAAG,oBAAoB,CAAC,EACvG,KAAK,EAAE;IAAE,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAAC,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAA;CAAE,GAC5E,OAAO,CAAC,kCAAkC,CAAC,CA0C7C;AAED,wBAAsB,2BAA2B,CAAC,OAAO,EAAE;IAAE,QAAQ,CAAC,kBAAkB,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;CAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAE9H"}

package/dist/platform/knowledge/extensions.d.ts

@@ -2,9 +2,9 @@ import type { KnowledgeEdgeRecord, KnowledgeNodeRecord, KnowledgeSourceRecord }
 export interface KnowledgeObjectProfilePolicy {
     readonly id: string;
     readonly subjectKinds: readonly KnowledgeNodeRecord['kind'][];
-    readonly intrinsicFactKinds?: readonly string[];
-    readonly suppressedGapKinds?: readonly string[];
-    readonly searchHints?: readonly string[];
+    readonly intrinsicFactKinds?: readonly string[] | undefined;
+    readonly suppressedGapKinds?: readonly string[] | undefined;
+    readonly searchHints?: readonly string[] | undefined;
 }
 export interface KnowledgePageTemplate {
     readonly id: string;
@@ -38,9 +38,9 @@ export interface KnowledgeFacetProviderInput {
 }
 export interface KnowledgeExtensionDefinition {
     readonly id: string;
-    readonly objectProfiles?: readonly KnowledgeObjectProfilePolicy[];
-    readonly pageTemplates?: readonly KnowledgePageTemplate[];
-    readonly relationshipResolvers?: readonly KnowledgeRelationshipResolver[];
-    readonly facetProviders?: readonly KnowledgeFacetProvider[];
+    readonly objectProfiles?: readonly KnowledgeObjectProfilePolicy[] | undefined;
+    readonly pageTemplates?: readonly KnowledgePageTemplate[] | undefined;
+    readonly relationshipResolvers?: readonly KnowledgeRelationshipResolver[] | undefined;
+    readonly facetProviders?: readonly KnowledgeFacetProvider[] | undefined;
 }
 //# sourceMappingURL=extensions.d.ts.map

package/dist/platform/knowledge/extensions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"extensions.d.ts","sourceRoot":"","sources":["../../../src/platform/knowledge/extensions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAElG,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,YAAY,EAAE,SAAS,mBAAmB,CAAC,MAAM,CAAC,EAAE,CAAC;IAC9D,QAAQ,CAAC,kBAAkB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAChD,QAAQ,CAAC,kBAAkB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAChD,QAAQ,CAAC,WAAW,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC1C;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,YAAY,EAAE,SAAS,mBAAmB,CAAC,MAAM,CAAC,EAAE,CAAC;IAC9D,QAAQ,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,0BAA0B,KAAK,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CAClF;AAED,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,OAAO,EAAE,mBAAmB,CAAC;IACtC,QAAQ,CAAC,OAAO,EAAE,SAAS,qBAAqB,EAAE,CAAC;IACnD,QAAQ,CAAC,KAAK,EAAE,SAAS,mBAAmB,EAAE,CAAC;IAC/C,QAAQ,CAAC,SAAS,EAAE,SAAS,mBAAmB,EAAE,CAAC;CACpD;AAED,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,kCAAkC,KAAK,SAAS,mBAAmB,EAAE,GAAG,OAAO,CAAC,SAAS,mBAAmB,EAAE,CAAC,CAAC;CAC3I;AAED,MAAM,WAAW,kCAAkC;IACjD,QAAQ,CAAC,OAAO,EAAE,mBAAmB,CAAC;IACtC,QAAQ,CAAC,KAAK,EAAE,SAAS,mBAAmB,EAAE,CAAC;IAC/C,QAAQ,CAAC,OAAO,EAAE,SAAS,qBAAqB,EAAE,CAAC;IACnD,QAAQ,CAAC,KAAK,EAAE,SAAS,mBAAmB,EAAE,CAAC;CAChD;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,2BAA2B,KAAK,MAAM,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC,CAAC,CAAC;CACzI;AAED,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,KAAK,EAAE,SAAS,mBAAmB,EAAE,CAAC;IAC/C,QAAQ,CAAC,OAAO,EAAE,SAAS,qBAAqB,EAAE,CAAC;IACnD,QAAQ,CAAC,KAAK,EAAE,SAAS,mBAAmB,EAAE,CAAC;CAChD;AAED,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,cAAc,CAAC,EAAE,SAAS,4BAA4B,EAAE,CAAC;IAClE,QAAQ,CAAC,aAAa,CAAC,EAAE,SAAS,qBAAqB,EAAE,CAAC;IAC1D,QAAQ,CAAC,qBAAqB,CAAC,EAAE,SAAS,6BAA6B,EAAE,CAAC;IAC1E,QAAQ,CAAC,cAAc,CAAC,EAAE,SAAS,sBAAsB,EAAE,CAAC;CAC7D"}
+{"version":3,"file":"extensions.d.ts","sourceRoot":"","sources":["../../../src/platform/knowledge/extensions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAElG,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,YAAY,EAAE,SAAS,mBAAmB,CAAC,MAAM,CAAC,EAAE,CAAC;IAC9D,QAAQ,CAAC,kBAAkB,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,CAAC;IAC5D,QAAQ,CAAC,kBAAkB,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,CAAC;IAC5D,QAAQ,CAAC,WAAW,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,CAAC;CACtD;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,YAAY,EAAE,SAAS,mBAAmB,CAAC,MAAM,CAAC,EAAE,CAAC;IAC9D,QAAQ,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,0BAA0B,KAAK,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CAClF;AAED,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,OAAO,EAAE,mBAAmB,CAAC;IACtC,QAAQ,CAAC,OAAO,EAAE,SAAS,qBAAqB,EAAE,CAAC;IACnD,QAAQ,CAAC,KAAK,EAAE,SAAS,mBAAmB,EAAE,CAAC;IAC/C,QAAQ,CAAC,SAAS,EAAE,SAAS,mBAAmB,EAAE,CAAC;CACpD;AAED,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,kCAAkC,KAAK,SAAS,mBAAmB,EAAE,GAAG,OAAO,CAAC,SAAS,mBAAmB,EAAE,CAAC,CAAC;CAC3I;AAED,MAAM,WAAW,kCAAkC;IACjD,QAAQ,CAAC,OAAO,EAAE,mBAAmB,CAAC;IACtC,QAAQ,CAAC,KAAK,EAAE,SAAS,mBAAmB,EAAE,CAAC;IAC/C,QAAQ,CAAC,OAAO,EAAE,SAAS,qBAAqB,EAAE,CAAC;IACnD,QAAQ,CAAC,KAAK,EAAE,SAAS,mBAAmB,EAAE,CAAC;CAChD;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,2BAA2B,KAAK,MAAM,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC,CAAC,CAAC;CACzI;AAED,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,KAAK,EAAE,SAAS,mBAAmB,EAAE,CAAC;IAC/C,QAAQ,CAAC,OAAO,EAAE,SAAS,qBAAqB,EAAE,CAAC;IACnD,QAAQ,CAAC,KAAK,EAAE,SAAS,mBAAmB,EAAE,CAAC;CAChD;AAED,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,cAAc,CAAC,EAAE,SAAS,4BAA4B,EAAE,GAAG,SAAS,CAAC;IAC9E,QAAQ,CAAC,aAAa,CAAC,EAAE,SAAS,qBAAqB,EAAE,GAAG,SAAS,CAAC;IACtE,QAAQ,CAAC,qBAAqB,CAAC,EAAE,SAAS,6BAA6B,EAAE,GAAG,SAAS,CAAC;IACtF,QAAQ,CAAC,cAAc,CAAC,EAAE,SAAS,sBAAsB,EAAE,GAAG,SAAS,CAAC;CACzE"}

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

@@ -3,9 +3,9 @@ import type { KnowledgeExtractionFormat } from './types.js';
 export interface KnowledgeExtractionResult {
     readonly extractorId: string;
     readonly format: KnowledgeExtractionFormat;
-    readonly title?: string;
-    readonly summary?: string;
-    readonly excerpt?: string;
+    readonly title?: string | undefined;
+    readonly summary?: string | undefined;
+    readonly excerpt?: string | undefined;
     readonly sections: readonly string[];
     readonly links: readonly string[];
     readonly estimatedTokens: number;

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

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

package/dist/platform/knowledge/extractors.js

@@ -102,6 +102,7 @@ function extractLinksFromHtml(html) {
 }
 function extractHtml(buffer) {
     const html = buffer.toString('utf-8');
+    let readabilityWarning;
     try {
         const readable = extractReadableHtml(html);
         if (readable) {
@@ -131,6 +132,7 @@ function extractHtml(buffer) {
         }
     }
     catch (error) {
+        readabilityWarning = `Readability extraction failed; used lightweight HTML fallback: ${summarizeError(error)}`;
         logger.debug('Knowledge extraction: readability extraction failed; using lightweight HTML extractor', {
             error: summarizeError(error),
         });
@@ -158,6 +160,8 @@ function extractHtml(buffer) {
         },
         metadata: {
             paragraphSamples: paragraphs.slice(0, 4),
+            extractionPath: 'lightweight-html',
+            ...(readabilityWarning ? { warnings: [readabilityWarning] } : {}),
         },
     };
 }
@@ -216,10 +220,18 @@ function extractJson(buffer) {
         };
     }
     catch (error) {
+        const parseWarning = `JSON parsing failed; used text fallback: ${summarizeError(error)}`;
         logger.debug('Knowledge extraction: JSON parse failed; using text fallback', {
             error: summarizeError(error),
         });
-        return extractTextLike(buffer, 'json', 'json-fallback');
+        const fallback = extractTextLike(buffer, 'json', 'json-fallback');
+        return {
+            ...fallback,
+            metadata: {
+                ...fallback.metadata,
+                warnings: [parseWarning],
+            },
+        };
     }
 }
 function parseDelimited(text, delimiter) {
@@ -365,7 +377,7 @@ async function extractXlsx(buffer) {
         if (!xml)
             continue;
         const rows = Array.from(xml.matchAll(/<row[^>]*>([\s\S]*?)<\/row>/g), (rowMatch) => {
-            return Array.from(rowMatch[1].matchAll(/<c[^>]*?(?:\st="([^"]+)")?[^>]*>([\s\S]*?)<\/c>/g), (cellMatch) => {
+            return Array.from((rowMatch[1] ?? '').matchAll(/<c[^>]*?(?:\st="([^"]+)")?[^>]*>([\s\S]*?)<\/c>/g), (cellMatch) => {
                 const type = cellMatch[1] ?? '';
                 const body = cellMatch[2] ?? '';
                 const raw = body.match(/<v[^>]*>([\s\S]*?)<\/v>/)?.[1]

package/dist/platform/knowledge/generated-pages.d.ts

@@ -13,23 +13,23 @@ export type GeneratedKnowledgePageGraphNeighbor<TNode extends GeneratedKnowledge
 export interface GeneratedKnowledgeRelatedPage<TNode extends GeneratedKnowledgePageGraphNode = GeneratedKnowledgePageGraphNode> {
     readonly sourceId: string;
     readonly title: string;
-    readonly projectionKind?: string;
-    readonly subject?: TNode;
+    readonly projectionKind?: string | undefined;
+    readonly subject?: TNode | undefined;
 }
 export interface GeneratedKnowledgePageEntry<TNode extends GeneratedKnowledgePageGraphNode = GeneratedKnowledgePageGraphNode> {
     readonly source: KnowledgeSourceRecord;
     readonly artifact?: {
         readonly id: string;
         readonly mimeType: string;
-        readonly filename?: string;
+        readonly filename?: string | undefined;
         readonly createdAt: number;
         readonly metadata: Record<string, unknown>;
     };
-    readonly markdown?: string;
-    readonly target?: TNode;
-    readonly subject?: TNode;
-    readonly neighbors?: readonly GeneratedKnowledgePageGraphNeighbor<TNode>[];
-    readonly relatedPages?: readonly GeneratedKnowledgeRelatedPage<TNode>[];
+    readonly markdown?: string | undefined;
+    readonly target?: TNode | undefined;
+    readonly subject?: TNode | undefined;
+    readonly neighbors?: readonly GeneratedKnowledgePageGraphNeighbor<TNode>[] | undefined;
+    readonly relatedPages?: readonly GeneratedKnowledgeRelatedPage<TNode>[] | undefined;
 }
 export interface GeneratedKnowledgePageListResult<TNode extends GeneratedKnowledgePageGraphNode = GeneratedKnowledgePageGraphNode> {
     readonly ok: true;
@@ -44,12 +44,12 @@ export interface GeneratedKnowledgePageListOptions<TNode extends GeneratedKnowle
     readonly edges: readonly KnowledgeEdgeRecord[];
     readonly limit: number;
     readonly includeMarkdown: boolean;
-    readonly isGeneratedSource?: (source: KnowledgeSourceRecord) => boolean;
-    readonly isPageSubjectNode?: (node: KnowledgeNodeRecord) => boolean;
-    readonly resolvePageSubject?: (target: KnowledgeNodeRecord, graph: GeneratedKnowledgePageGraph) => KnowledgeNodeRecord | undefined;
-    readonly projectNode?: (node: KnowledgeNodeRecord) => TNode;
+    readonly isGeneratedSource?: ((source: KnowledgeSourceRecord) => boolean) | undefined;
+    readonly isPageSubjectNode?: ((node: KnowledgeNodeRecord) => boolean) | undefined;
+    readonly resolvePageSubject?: ((target: KnowledgeNodeRecord, graph: GeneratedKnowledgePageGraph) => KnowledgeNodeRecord | undefined) | undefined;
+    readonly projectNode?: ((node: KnowledgeNodeRecord) => TNode) | undefined;
     readonly compareGeneratedPages?: (left: KnowledgeSourceRecord, right: KnowledgeSourceRecord, graph: GeneratedKnowledgePageGraph) => number;
-    readonly relatedPageLimit?: number;
+    readonly relatedPageLimit?: number | undefined;
 }
 export interface GeneratedKnowledgePageGraph {
     readonly nodesById: ReadonlyMap<string, KnowledgeNodeRecord>;

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

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

package/dist/platform/knowledge/generated-pages.js

@@ -1,16 +1,18 @@
 import { logger } from '../utils/logger.js';
 import { mapWithConcurrency } from '../utils/concurrency.js';
 import { isGeneratedKnowledgeSource } from './generated-projections.js';
+import { isActiveKnowledgeEdge } from './projection-utils.js';
+import { getKnowledgeSpaceId, isHomeAssistantKnowledgeSpace, normalizeKnowledgeSpaceId } from './spaces.js';
 const DEFAULT_RELATED_GENERATED_PAGES = 24;
 const GENERATED_PAGE_MARKDOWN_READ_CONCURRENCY = 8;
 export async function listGeneratedKnowledgePages(input) {
-    const graph = buildGeneratedKnowledgePageGraph(input.sources, input.nodes, input.edges, input.isGeneratedSource);
+    const scoped = scopeGeneratedPageRecords(input.spaceId, input.sources, input.nodes, input.edges);
+    const graph = buildGeneratedKnowledgePageGraph(scoped.sources, scoped.nodes, scoped.edges, input.isGeneratedSource);
     const projectNode = input.projectNode ?? defaultPageGraphNode;
     const resolveSubject = input.resolvePageSubject ?? defaultResolvePageSubject;
     const isSubject = input.isPageSubjectNode ?? defaultIsPageSubjectNode;
     const relatedPageLimit = input.relatedPageLimit ?? DEFAULT_RELATED_GENERATED_PAGES;
-    const sources = input.sources
-        .filter(input.isGeneratedSource ?? isGeneratedKnowledgeSource)
+    const sources = [...graph.generatedSources]
         .sort((left, right) => input.compareGeneratedPages?.(left, right, graph) ?? compareGeneratedPages(left, right, graph))
         .slice(0, input.limit);
     const pages = await mapWithConcurrency(sources, GENERATED_PAGE_MARKDOWN_READ_CONCURRENCY, async (source) => {
@@ -40,23 +42,79 @@ export async function listGeneratedKnowledgePages(input) {
     });
     return { ok: true, spaceId: input.spaceId, pages };
 }
+function scopeGeneratedPageRecords(spaceId, sources, nodes, edges) {
+    const normalized = normalizeKnowledgeSpaceId(spaceId);
+    const scopedSources = sources.filter((source) => recordBelongsToGeneratedPageSpace(source, normalized));
+    const scopedNodes = nodes.filter((node) => recordBelongsToGeneratedPageSpace(node, normalized));
+    const sourceIds = new Set(scopedSources.map((source) => source.id));
+    const nodeIds = new Set(scopedNodes.map((node) => node.id));
+    const scopedEdges = edges.filter((edge) => edgeReferencesGeneratedPageSpace(edge, sourceIds, nodeIds)
+        && (recordBelongsToGeneratedPageSpace(edge, normalized) || edgeHasGeneratedPageSpaceEndpoint(edge, sourceIds, nodeIds)));
+    return { sources: scopedSources, nodes: scopedNodes, edges: scopedEdges };
+}
+function recordBelongsToGeneratedPageSpace(record, normalizedSpaceId) {
+    const recordSpaceId = normalizeKnowledgeSpaceId(getKnowledgeSpaceId(record));
+    if (normalizedSpaceId === 'homeassistant')
+        return isHomeAssistantKnowledgeSpace(recordSpaceId);
+    return recordSpaceId === normalizedSpaceId;
+}
+function edgeReferencesGeneratedPageSpace(edge, sourceIds, nodeIds) {
+    return (edge.fromKind !== 'source' || sourceIds.has(edge.fromId))
+        && (edge.toKind !== 'source' || sourceIds.has(edge.toId))
+        && (edge.fromKind !== 'node' || nodeIds.has(edge.fromId))
+        && (edge.toKind !== 'node' || nodeIds.has(edge.toId));
+}
+function edgeHasGeneratedPageSpaceEndpoint(edge, sourceIds, nodeIds) {
+    return (edge.fromKind === 'source' && sourceIds.has(edge.fromId))
+        || (edge.toKind === 'source' && sourceIds.has(edge.toId))
+        || (edge.fromKind === 'node' && nodeIds.has(edge.fromId))
+        || (edge.toKind === 'node' && nodeIds.has(edge.toId));
+}
 export function buildGeneratedKnowledgePageGraph(sources, nodes, edges, isGeneratedSource = isGeneratedKnowledgeSource) {
     const nodesById = new Map(nodes.map((node) => [node.id, node]));
     const activeEdges = edges.filter(edgeIsActive);
     const targetBySourceId = new Map();
-    for (const source of sources.filter(isGeneratedSource)) {
-        const targetEdge = activeEdges.find((edge) => edge.fromKind === 'source' && edge.fromId === source.id && edge.toKind === 'node');
-        const target = targetEdge ? nodesById.get(targetEdge.toId) : undefined;
-        if (target)
+    const generatedSources = sources.filter((source) => source.status === 'indexed' && isGeneratedSource(source));
+    for (const source of generatedSources) {
+        const targetId = generatedPageTargetNodeId(source, activeEdges, nodesById);
+        const target = targetId ? nodesById.get(targetId) : undefined;
+        if (target && target.status !== 'stale')
             targetBySourceId.set(source.id, target);
     }
     return {
         nodesById,
         edges: activeEdges,
-        generatedSources: sources.filter(isGeneratedSource),
+        generatedSources: generatedSources.filter((source) => {
+            const targetId = generatedPageTargetNodeId(source, activeEdges, nodesById);
+            if (!targetId)
+                return true;
+            const target = nodesById.get(targetId);
+            return Boolean(target && target.status !== 'stale');
+        }),
         targetBySourceId,
     };
 }
+function generatedPageTargetNodeId(source, edges, nodesById) {
+    const metadataTargetId = typeof source.metadata.generatedTargetNodeId === 'string'
+        ? source.metadata.generatedTargetNodeId
+        : undefined;
+    if (metadataTargetId)
+        return metadataTargetId;
+    const targetEdges = edges.filter((edge) => (edge.fromKind === 'source'
+        && edge.fromId === source.id
+        && edge.toKind === 'node'
+        && isGeneratedPageTargetEdge(edge)));
+    const activeTarget = targetEdges.find((edge) => {
+        const target = nodesById.get(edge.toId);
+        return Boolean(target && target.status !== 'stale');
+    });
+    return activeTarget?.toId ?? targetEdges[0]?.toId;
+}
+function isGeneratedPageTargetEdge(edge) {
+    return edge.relation === 'source_for'
+        || edge.metadata.generatedKnowledgePage === true
+        || edge.metadata.generatedProjection === true;
+}
 function defaultResolvePageSubject(target, graph) {
     if (defaultIsPageSubjectNode(target))
         return target;
@@ -151,7 +209,7 @@ async function readMarkdown(artifactStore, artifactId) {
         return buffer.toString('utf-8');
     }
     catch (error) {
-        logger.debug('Generated knowledge page markdown read failed', {
+        logger.warn('Generated knowledge page markdown read failed', {
             artifactId,
             error: error instanceof Error ? error.message : String(error),
         });
@@ -159,5 +217,5 @@ async function readMarkdown(artifactStore, artifactId) {
     }
 }
 function edgeIsActive(edge) {
-    return edge.weight > 0 && edge.metadata.deleted !== true;
+    return isActiveKnowledgeEdge(edge);
 }

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

@@ -1,34 +1,36 @@
 import type { ArtifactDescriptor } from '../artifacts/types.js';
 import type { ArtifactStore } from '../artifacts/index.js';
 import type { KnowledgeStore } from './store.js';
-import type { KnowledgeEdgeRecord, KnowledgeReferenceKind, KnowledgeSourceRecord, KnowledgeSourceType } from './types.js';
+import type { KnowledgeEdgeRecord, KnowledgeSourceRecord, KnowledgeSourceType } from './types.js';
+export type GeneratedKnowledgeProjectionTargetKind = 'source' | 'node' | 'artifact';
 export interface GeneratedKnowledgeProjectionInput {
     readonly store: KnowledgeStore;
     readonly artifactStore: ArtifactStore;
     readonly connectorId: string;
     readonly sourceId: string;
-    readonly sourceType?: KnowledgeSourceType;
+    readonly sourceType?: KnowledgeSourceType | undefined;
     readonly canonicalUri: string;
     readonly title: string;
-    readonly summary?: string;
-    readonly tags?: readonly string[];
+    readonly summary?: string | undefined;
+    readonly tags?: readonly string[] | undefined;
     readonly filename: string;
     readonly markdown: string;
     readonly projectionKind: string;
-    readonly metadata?: Record<string, unknown>;
-    readonly sourceMetadata?: Record<string, unknown>;
-    readonly artifactMetadata?: Record<string, unknown>;
-    readonly edgeMetadata?: Record<string, unknown>;
+    readonly metadata?: Record<string, unknown> | undefined;
+    readonly sourceMetadata?: Record<string, unknown> | undefined;
+    readonly artifactMetadata?: Record<string, unknown> | undefined;
+    readonly edgeMetadata?: Record<string, unknown> | undefined;
+    readonly signal?: AbortSignal | undefined;
     readonly target?: {
-        readonly kind: KnowledgeReferenceKind;
+        readonly kind: GeneratedKnowledgeProjectionTargetKind;
         readonly id: string;
-        readonly relation?: string;
+        readonly relation?: string | undefined;
     };
 }
 export interface GeneratedKnowledgeProjectionResult {
     readonly artifact: ArtifactDescriptor;
     readonly source: KnowledgeSourceRecord;
-    readonly linked?: KnowledgeEdgeRecord;
+    readonly linked?: KnowledgeEdgeRecord | undefined;
     readonly artifactCreated: boolean;
 }
 export declare function generatedKnowledgeSourceId(kind: string, value: string): string;

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

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

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

@@ -8,11 +8,10 @@ export function generatedKnowledgeCanonicalUri(kind, value) {
 }
 export function isGeneratedKnowledgeSource(source) {
     return source.metadata.generatedKnowledgePage === true
-        || source.metadata.generatedProjection === true
-        || source.metadata.homeGraphGeneratedPage === true
-        || source.metadata.homeGraphSourceKind === 'generated-page';
+        || source.metadata.generatedProjection === true;
 }
 export async function materializeGeneratedKnowledgeProjection(input) {
+    throwIfAborted(input.signal);
     const existing = input.store.getSource(input.sourceId);
     const contentHash = stableHash(input.markdown, 40);
     const existingMetadata = readRecord(existing?.metadata);
@@ -28,7 +27,15 @@ export async function materializeGeneratedKnowledgeProjection(input) {
         generatedContentHash: contentHash,
         pageEditable: true,
     };
+    if (input.target) {
+        assertGeneratedProjectionTarget(input.artifactStore, input.store, {
+            toKind: input.target.kind,
+            toId: input.target.id,
+        });
+    }
+    throwIfAborted(input.signal);
     const reusedArtifact = await findReusableGeneratedArtifact(input.artifactStore, existing, input.markdown);
+    throwIfAborted(input.signal);
     const artifact = reusedArtifact ?? await input.artifactStore.create({
         kind: 'document',
         mimeType: 'text/markdown',
@@ -42,7 +49,7 @@ export async function materializeGeneratedKnowledgeProjection(input) {
             generatedContentHash: contentHash,
         },
     });
-    const source = await input.store.upsertSource({
+    const sourceInput = {
         id: input.sourceId,
         connectorId: input.connectorId,
         sourceType: input.sourceType ?? 'document',
@@ -64,11 +71,11 @@ export async function materializeGeneratedKnowledgeProjection(input) {
             generatedAt,
             generatedContentHash: contentHash,
         },
-    });
-    const linked = input.target
-        ? await input.store.upsertEdge({
+    };
+    const edgeInput = input.target
+        ? {
             fromKind: 'source',
-            fromId: source.id,
+            fromId: input.sourceId,
             toKind: input.target.kind,
             toId: input.target.id,
             relation: input.target.relation ?? 'source_for',
@@ -78,8 +85,55 @@ export async function materializeGeneratedKnowledgeProjection(input) {
                 projectionKind: input.projectionKind,
                 ...(input.edgeMetadata ?? {}),
             },
-        })
+        }
         : undefined;
+    const existingLinked = edgeInput
+        ? input.store.edgesFor(edgeInput.fromKind, edgeInput.fromId).find((edge) => (edge.toKind === edgeInput.toKind
+            && edge.toId === edgeInput.toId
+            && edge.relation === edgeInput.relation))
+        : undefined;
+    let source;
+    let linked;
+    try {
+        throwIfAborted(input.signal);
+        source = await input.store.upsertSource(sourceInput);
+        throwIfAborted(input.signal);
+        linked = edgeInput ? await input.store.upsertEdge(edgeInput) : undefined;
+        throwIfAborted(input.signal);
+    }
+    catch (error) {
+        if (!reusedArtifact)
+            input.artifactStore.delete(artifact.id);
+        const currentLinked = edgeInput
+            ? input.store.edgesFor(edgeInput.fromKind, edgeInput.fromId).find((edge) => (edge.toKind === edgeInput.toKind
+                && edge.toId === edgeInput.toId
+                && edge.relation === edgeInput.relation))
+            : undefined;
+        if (currentLinked && edgeInput) {
+            if (existingLinked) {
+                await input.store.replaceEdgeRecord(existingLinked);
+            }
+            else {
+                await input.store.deleteEdge(currentLinked.id);
+            }
+        }
+        const persistedSource = input.store.getSource(input.sourceId);
+        if (!existing && persistedSource) {
+            await input.store.deleteSource(persistedSource.id);
+        }
+        else if (existing && persistedSource) {
+            await input.store.replaceSourceRecord(existing);
+        }
+        throw error;
+    }
+    if (!source)
+        throw new Error(`Generated projection '${input.sourceId}' did not persist a source record.`);
+    if (!reusedArtifact && existing?.artifactId && existing.artifactId !== artifact.id) {
+        const existingArtifact = input.artifactStore.get(existing.artifactId);
+        if (existingArtifact && readRecord(existingArtifact.metadata).generatedKnowledgePage === true) {
+            input.artifactStore.delete(existing.artifactId);
+        }
+    }
     return {
         artifact,
         source,
@@ -87,6 +141,29 @@ export async function materializeGeneratedKnowledgeProjection(input) {
         artifactCreated: !reusedArtifact,
     };
 }
+function throwIfAborted(signal) {
+    if (!signal?.aborted)
+        return;
+    throw new Error('Generated knowledge projection was cancelled.');
+}
+function assertGeneratedProjectionTarget(artifactStore, store, edge) {
+    switch (edge.toKind) {
+        case 'node':
+            if (!store.getNode(edge.toId))
+                throw new Error(`Generated projection target node does not exist: ${edge.toId}`);
+            return;
+        case 'source':
+            if (!store.getSource(edge.toId))
+                throw new Error(`Generated projection target source does not exist: ${edge.toId}`);
+            return;
+        case 'artifact':
+            if (!artifactStore.get(edge.toId))
+                throw new Error(`Generated projection target artifact does not exist: ${edge.toId}`);
+            return;
+        default:
+            throw new Error(`Generated projection target kind is not supported: ${edge.toKind}`);
+    }
+}
 async function findReusableGeneratedArtifact(artifactStore, source, markdown) {
     if (!source?.artifactId)
         return undefined;
@@ -98,7 +175,7 @@ async function findReusableGeneratedArtifact(artifactStore, source, markdown) {
         return buffer.toString('utf-8') === markdown ? artifact : undefined;
     }
     catch (error) {
-        logger.debug('Generated knowledge projection artifact reuse failed', {
+        logger.warn('Generated knowledge projection artifact reuse failed', {
             sourceId: source.id,
             artifactId: artifact.id,
             error: error instanceof Error ? error.message : String(error),

package/dist/platform/knowledge/graphql.d.ts

@@ -7,8 +7,8 @@ export interface KnowledgeGraphqlAccessProfile {
 export declare function inspectKnowledgeGraphqlAccess(source: string, operationName?: string): KnowledgeGraphqlAccessProfile;
 export interface KnowledgeGraphqlExecuteInput {
     readonly query: string;
-    readonly operationName?: string;
-    readonly variables?: Record<string, unknown>;
+    readonly operationName?: string | undefined;
+    readonly variables?: Record<string, unknown> | undefined;
     readonly admin: boolean;
     readonly scopes: readonly string[];
 }