@semiont/make-meaning 0.5.9 → 0.5.10

package/dist/index.d.ts

@@ -1,13 +1,13 @@
 import { JobQueue } from '@semiont/jobs';
 import { SemiontProject } from '@semiont/core/node';
-import { GraphServiceConfig, VectorsServiceConfig, EmbeddingServiceConfig, EventBus, Logger, StoredEvent, ResourceId, ResourceDescriptor, AnnotationId, components, ITransport, BaseUrl, ConnectionState, SemiontError, UserDID, EventMap, IContentTransport, PutBinaryRequest, PutBinaryOptions, AccessToken, Annotation, UserId, ResourceAnnotations, AnnotationCategory, GraphPath, GraphConnection } from '@semiont/core';
+import { GraphServiceConfig, VectorsServiceConfig, EmbeddingServiceConfig, EventBus, Logger, StoredEvent, ResourceId, ResourceDescriptor, AnnotationId, components, ITransport, BaseUrl, ConnectionState, SemiontError, UserDID, EventMap, IContentTransport, PutBinaryRequest, PutBinaryOptions, AccessToken, StateUnit, BusRequestPrimitive, Annotation, UserId, GatheredContext, ResourceAnnotations, AnnotationCategory, GraphPath, GraphConnection } from '@semiont/core';
 import { EventStore, ViewStorage } from '@semiont/event-sourcing';
 import { WorkingTreeStore } from '@semiont/content';
 import { GraphDatabase } from '@semiont/graph';
 import { VectorStore, EmbeddingProvider, ChunkingConfig } from '@semiont/vectors';
 import { InferenceClient } from '@semiont/inference';
 import { BehaviorSubject, Observable } from 'rxjs';
-import { StateUnit, WorkerBus, BusRequestPrimitive } from '@semiont/sdk';
+import { WorkerBus } from '@semiont/sdk';
 import { Writable, Readable } from 'node:stream';
 
 /**
@@ -847,6 +847,16 @@ declare class Smelter {
      * or is empty — callers skip it.
      */
     private fetchEmbeddableText;
+    /**
+     * Read a resource's current entity types from the materialized view — the
+     * authoritative source, updated before the EventBus fires to consumers — so
+     * its vectors carry the discriminator `searchResources` filters on (e.g.
+     * exclude `['Question']`). One read on every embed path, mirroring how the
+     * smelter already reads current content and annotations; a failed read
+     * propagates to the pipeline's per-resource error handler (reconcile heals),
+     * rather than silently stamping `[]` and letting the resource leak into recall.
+     */
+    private resolveEntityTypes;
     private embedResource;
     private handleResourceArchived;
     private handleAnnotationAdded;
@@ -1237,8 +1247,6 @@ declare class ResourceContext {
  * - Generating AI summaries
  */
 
-type AnnotationLLMContextResponse = components['schemas']['AnnotationLLMContextResponse'];
-
 type AnnotationContextResponse = components['schemas']['AnnotationContextResponse'];
 type ContextualSummaryResponse = components['schemas']['ContextualSummaryResponse'];
 interface BuildContextOptions {
@@ -1258,7 +1266,7 @@ declare class AnnotationContext {
      * @returns Rich context for LLM processing
      * @throws Error if annotation or resource not found
      */
-    static buildLLMContext(annotationId: AnnotationId, resourceId: ResourceId, kb: KnowledgeBase, options?: BuildContextOptions, inferenceClient?: InferenceClient, logger?: Logger, embeddingProvider?: EmbeddingProvider): Promise<AnnotationLLMContextResponse>;
+    static buildLLMContext(annotationId: AnnotationId, resourceId: ResourceId, kb: KnowledgeBase, options?: BuildContextOptions, inferenceClient?: InferenceClient, logger?: Logger, embeddingProvider?: EmbeddingProvider): Promise<GatheredContext>;
     /**
      * Get resource annotations from view storage (fast path)
      * Throws if view missing
@@ -1332,24 +1340,7 @@ declare class AnnotationContext {
  * All methods require graph traversal - must use graph database.
  */
 
-interface GraphNode {
-    id: string;
-    type: string;
-    label: string;
-    metadata: {
-        entityTypes: string[];
-    };
-}
-interface GraphEdge {
-    source: string;
-    target: string;
-    type: string;
-    metadata: Record<string, unknown>;
-}
-interface GraphRepresentation {
-    nodes: GraphNode[];
-    edges: GraphEdge[];
-}
+type KnowledgeGraph = components['schemas']['KnowledgeGraph'];
 declare class GraphContext {
     /**
      * Get all resources referencing this resource (backlinks)
@@ -1372,10 +1363,20 @@ declare class GraphContext {
      */
     static searchResources(query: string, kb: KnowledgeBase, limit?: number): Promise<ResourceDescriptor[]>;
     /**
-     * Build graph representation with nodes and edges for a resource and its connections
-     * Retrieves connections from graph and builds visualization-ready structure
+     * Build the unified knowledge graph for a resource's neighborhood:
+     * resources AND annotations as typed nodes, typed/directional edges.
+     *
+     * This is the single graph builder (CONTEXT-UNIFICATION D3) — both the
+     * matcher (ranking) and the resource/viz path consume it. The flattened
+     * signals the matcher reads today (`connections`, `citedBy`/count,
+     * `siblingEntityTypes`, `bidirectional`) are all derivable from this:
+     *  - peer connections → resource nodes + main→peer edges carrying `bidirectional`
+     *  - inbound citations → citing-resource nodes + `citation` edges (citing→main),
+     *    so citedByCount = inbound citation-edge count
+     *  - annotations on the resource → `annotation` nodes + `annotation-of` edges,
+     *    so siblingEntityTypes = union of those nodes' entityTypes
      */
-    static buildGraphRepresentation(resourceId: ResourceId, maxRelated: number, kb: KnowledgeBase): Promise<GraphRepresentation>;
+    static buildKnowledgeGraph(resourceId: ResourceId, kb: KnowledgeBase): Promise<KnowledgeGraph>;
 }
 
 /**
@@ -1385,19 +1386,23 @@ declare class GraphContext {
  * Orchestrates: ResourceContext, GraphContext, AnnotationContext, and generation functions
  */
 
-type ResourceLLMContextResponse = components['schemas']['ResourceLLMContextResponse'];
 interface LLMContextOptions {
     depth: number;
     maxResources: number;
     includeContent: boolean;
     includeSummary: boolean;
+    /**
+     * Entity types to exclude from the resource-gather semantic recall
+     * (caller-supplied; e.g. ['Question']). Optional; default none.
+     */
+    excludeEntityTypes?: string[];
 }
 declare class LLMContext {
     /**
      * Get comprehensive LLM context for a resource
      * Includes: main resource, related resources, annotations, graph, content, summary, references
      */
-    static getResourceContext(resourceId: ResourceId, options: LLMContextOptions, kb: KnowledgeBase, inferenceClient: InferenceClient): Promise<ResourceLLMContextResponse>;
+    static getResourceContext(resourceId: ResourceId, options: LLMContextOptions, kb: KnowledgeBase, inferenceClient: InferenceClient): Promise<GatheredContext>;
 }
 
 /**
@@ -1421,4 +1426,4 @@ declare function generateResourceSummary(resourceName: string, content: string,
 declare function generateReferenceSuggestions(referenceTitle: string, client: InferenceClient, entityType?: string, currentContent?: string): Promise<string[] | null>;
 
 export { AnnotationContext, AnnotationOperations, BACKUP_FORMAT, Browser, CloneTokenManager, FORMAT_VERSION, Gatherer$1 as Gatherer, GraphContext, LLMContext, LocalContentTransport, LocalTransport, Matcher, ResourceContext, ResourceOperations, Smelter, Stower, bootstrapEntityTypes, createKnowledgeBase, createSmelterActorStateUnit, exportBackup, exportLinkedData, generateReferenceSuggestions, generateResourceSummary, importBackup, importLinkedData, isBackupManifest, readEntityTypesProjection, registerAnnotationAssemblyHandler, registerAnnotationLookupHandlers, registerBindUpdateBodyHandler, registerBusHandlers, registerJobCommandHandlers, startMakeMeaning, stopKnowledgeSystem, validateManifestVersion };
-export type { BackupContentReader, BackupEventStoreReader, BackupExporterOptions, BackupImportResult, BackupImporterOptions, BackupManifestHeader, BackupStreamSummary, BuildContextOptions, ContentBlobResolver, CreateAnnotationResult, CreateResourceInput, CreateResourceResult, GraphEdge, GraphNode, GraphRepresentation, KnowledgeBase, KnowledgeSystem, LLMContextOptions, LinkedDataContentReader, LinkedDataExporterOptions, LinkedDataImportResult, LinkedDataImporterOptions, LinkedDataViewReader, ListResourcesFilters, LocalTransportConfig, MakeMeaningConfig, MakeMeaningService, ReconcileState, ReconcileSummary, ReplayStats, SmelterActorStateUnit, SmelterActorStateUnitOptions, SmelterEvent, SmelterInput, SmelterTiming, SmelterWorkItem, UpdateAnnotationBodyResult };
+export type { BackupContentReader, BackupEventStoreReader, BackupExporterOptions, BackupImportResult, BackupImporterOptions, BackupManifestHeader, BackupStreamSummary, BuildContextOptions, ContentBlobResolver, CreateAnnotationResult, CreateResourceInput, CreateResourceResult, KnowledgeBase, KnowledgeSystem, LLMContextOptions, LinkedDataContentReader, LinkedDataExporterOptions, LinkedDataImportResult, LinkedDataImporterOptions, LinkedDataViewReader, ListResourcesFilters, LocalTransportConfig, MakeMeaningConfig, MakeMeaningService, ReconcileState, ReconcileSummary, ReplayStats, SmelterActorStateUnit, SmelterActorStateUnitOptions, SmelterEvent, SmelterInput, SmelterTiming, SmelterWorkItem, UpdateAnnotationBodyResult };