@semiont/make-meaning 0.2.30-build.59 → 0.2.30-build.61

package/dist/index.d.ts

@@ -2,6 +2,8 @@ import { components, AnnotationUri } from '@semiont/api-client';
 import { ResourceId, EnvironmentConfig, ResourceAnnotations, AnnotationId, AnnotationCategory, GraphPath, GraphConnection } from '@semiont/core';
 import { CommentMatch, HighlightMatch, AssessmentMatch, TagMatch } from '@semiont/inference';
 export { AssessmentMatch, CommentMatch, HighlightMatch, TagMatch } from '@semiont/inference';
+import { JobWorker, JobQueue, Job } from '@semiont/jobs';
+import { EventStore } from '@semiont/event-sourcing';
 
 /**
  * Resource Context
@@ -10,7 +12,7 @@ export { AssessmentMatch, CommentMatch, HighlightMatch, TagMatch } from '@semion
  * Does NOT touch the graph - graph queries go through GraphContext
  */
 
-type ResourceDescriptor$1 = components['schemas']['ResourceDescriptor'];
+type ResourceDescriptor$2 = components['schemas']['ResourceDescriptor'];
 interface ListResourcesFilters {
     search?: string;
     archived?: boolean;
@@ -19,16 +21,16 @@ declare class ResourceContext {
     /**
      * Get resource metadata from view storage
      */
-    static getResourceMetadata(resourceId: ResourceId, config: EnvironmentConfig): Promise<ResourceDescriptor$1 | null>;
+    static getResourceMetadata(resourceId: ResourceId, config: EnvironmentConfig): Promise<ResourceDescriptor$2 | null>;
     /**
      * List all resources by scanning view storage
      */
-    static listResources(filters: ListResourcesFilters | undefined, config: EnvironmentConfig): Promise<ResourceDescriptor$1[]>;
+    static listResources(filters: ListResourcesFilters | undefined, config: EnvironmentConfig): Promise<ResourceDescriptor$2[]>;
     /**
      * Add content previews to resources (for search results)
      * Retrieves and decodes the first 200 characters of each resource's primary representation
      */
-    static addContentPreviews(resources: ResourceDescriptor$1[], config: EnvironmentConfig): Promise<Array<ResourceDescriptor$1 & {
+    static addContentPreviews(resources: ResourceDescriptor$2[], config: EnvironmentConfig): Promise<Array<ResourceDescriptor$2 & {
         content: string;
     }>>;
 }
@@ -138,7 +140,7 @@ declare class AnnotationContext {
  */
 
 type Annotation = components['schemas']['Annotation'];
-type ResourceDescriptor = components['schemas']['ResourceDescriptor'];
+type ResourceDescriptor$1 = components['schemas']['ResourceDescriptor'];
 declare class GraphContext {
     /**
      * Get all resources referencing this resource (backlinks)
@@ -159,7 +161,7 @@ declare class GraphContext {
      * Search resources by name (cross-resource query)
      * Requires full-text search - must use graph database
      */
-    static searchResources(query: string, config: EnvironmentConfig, limit?: number): Promise<ResourceDescriptor[]>;
+    static searchResources(query: string, config: EnvironmentConfig, limit?: number): Promise<ResourceDescriptor$1[]>;
 }
 
 /**
@@ -230,7 +232,173 @@ declare class AnnotationDetection {
     private static loadResourceContent;
 }
 
+/**
+ * Comment Detection Worker
+ *
+ * Processes comment-detection jobs: runs AI inference to identify passages
+ * that would benefit from explanatory comments and creates comment annotations.
+ */
+
+declare class CommentDetectionWorker extends JobWorker {
+    private config;
+    private eventStore;
+    private isFirstProgress;
+    constructor(jobQueue: JobQueue, config: EnvironmentConfig, eventStore: EventStore);
+    protected getWorkerName(): string;
+    protected canProcessJob(job: Job): boolean;
+    protected executeJob(job: Job): Promise<void>;
+    /**
+     * Override updateJobProgress to emit events to Event Store
+     */
+    protected updateJobProgress(job: Job): Promise<void>;
+    protected handleJobFailure(job: Job, error: any): Promise<void>;
+    private processCommentDetectionJob;
+    private createCommentAnnotation;
+}
+
+/**
+ * Highlight Detection Worker
+ *
+ * Processes highlight-detection jobs: runs AI inference to find passages
+ * that should be highlighted and creates highlight annotations.
+ */
+
+declare class HighlightDetectionWorker extends JobWorker {
+    private config;
+    private eventStore;
+    private isFirstProgress;
+    constructor(jobQueue: JobQueue, config: EnvironmentConfig, eventStore: EventStore);
+    protected getWorkerName(): string;
+    protected canProcessJob(job: Job): boolean;
+    protected executeJob(job: Job): Promise<void>;
+    /**
+     * Override updateJobProgress to emit events to Event Store
+     */
+    protected updateJobProgress(job: Job): Promise<void>;
+    protected handleJobFailure(job: Job, error: any): Promise<void>;
+    private processHighlightDetectionJob;
+    private createHighlightAnnotation;
+}
+
+/**
+ * Assessment Detection Worker
+ *
+ * Processes assessment-detection jobs: runs AI inference to assess/evaluate
+ * passages in the text and creates assessment annotations.
+ */
+
+declare class AssessmentDetectionWorker extends JobWorker {
+    private config;
+    private eventStore;
+    private isFirstProgress;
+    constructor(jobQueue: JobQueue, config: EnvironmentConfig, eventStore: EventStore);
+    protected getWorkerName(): string;
+    protected canProcessJob(job: Job): boolean;
+    protected executeJob(job: Job): Promise<void>;
+    /**
+     * Override updateJobProgress to emit events to Event Store
+     */
+    protected updateJobProgress(job: Job): Promise<void>;
+    protected handleJobFailure(job: Job, error: any): Promise<void>;
+    private processAssessmentDetectionJob;
+    private createAssessmentAnnotation;
+}
+
+/**
+ * Tag Detection Worker
+ *
+ * Processes tag-detection jobs: runs AI inference to identify passages
+ * serving specific structural roles (IRAC, IMRAD, Toulmin, etc.) and
+ * creates tag annotations with dual-body structure.
+ */
+
+declare class TagDetectionWorker extends JobWorker {
+    private config;
+    private eventStore;
+    private isFirstProgress;
+    constructor(jobQueue: JobQueue, config: EnvironmentConfig, eventStore: EventStore);
+    protected getWorkerName(): string;
+    protected canProcessJob(job: Job): boolean;
+    protected executeJob(job: Job): Promise<void>;
+    /**
+     * Override updateJobProgress to emit events to Event Store
+     */
+    protected updateJobProgress(job: Job): Promise<void>;
+    protected handleJobFailure(job: Job, error: any): Promise<void>;
+    private processTagDetectionJob;
+    private createTagAnnotation;
+}
+
+/**
+ * Reference Detection Worker
+ *
+ * Processes detection jobs: runs AI inference to find entities in resources
+ * and emits reference.created events for each detected entity.
+ *
+ * This worker is INDEPENDENT of HTTP clients - it just processes jobs and emits events.
+ */
+
+type ResourceDescriptor = components['schemas']['ResourceDescriptor'];
+interface DetectedAnnotation {
+    annotation: {
+        selector: {
+            start: number;
+            end: number;
+            exact: string;
+            prefix?: string;
+            suffix?: string;
+        };
+        entityTypes: string[];
+    };
+}
+declare class ReferenceDetectionWorker extends JobWorker {
+    private config;
+    private eventStore;
+    constructor(jobQueue: JobQueue, config: EnvironmentConfig, eventStore: EventStore);
+    protected getWorkerName(): string;
+    protected canProcessJob(job: Job): boolean;
+    protected executeJob(job: Job): Promise<void>;
+    /**
+     * Detect entity references in resource using AI
+     * Self-contained implementation for reference detection
+     *
+     * Public for testing charset handling - see entity-detection-charset.test.ts
+     */
+    detectReferences(resource: ResourceDescriptor, entityTypes: string[], includeDescriptiveReferences?: boolean): Promise<DetectedAnnotation[]>;
+    private processDetectionJob;
+    protected handleJobFailure(job: Job, error: any): Promise<void>;
+    /**
+     * Update job progress and emit events to Event Store
+     * Overrides base class to also emit job progress events
+     */
+    protected updateJobProgress(job: Job): Promise<void>;
+}
+
+/**
+ * Generation Worker
+ *
+ * Processes generation jobs: runs AI inference to generate new resources
+ * and emits resource.created and annotation.body.updated events.
+ *
+ * This worker is INDEPENDENT of HTTP clients - it just processes jobs and emits events.
+ */
+
+declare class GenerationWorker extends JobWorker {
+    private config;
+    private eventStore;
+    constructor(jobQueue: JobQueue, config: EnvironmentConfig, eventStore: EventStore);
+    protected getWorkerName(): string;
+    protected canProcessJob(job: Job): boolean;
+    protected executeJob(job: Job): Promise<void>;
+    private processGenerationJob;
+    /**
+     * Update job progress and emit events to Event Store
+     * Overrides base class to also emit job progress events
+     */
+    protected updateJobProgress(job: Job): Promise<void>;
+}
+
 declare const PACKAGE_NAME = "@semiont/make-meaning";
 declare const VERSION = "0.1.0";
 
-export { AnnotationContext, AnnotationDetection, type BuildContextOptions, GraphContext, type ListResourcesFilters, PACKAGE_NAME, ResourceContext, VERSION };
+export { AnnotationContext, AnnotationDetection, AssessmentDetectionWorker, type BuildContextOptions, CommentDetectionWorker, GenerationWorker, GraphContext, HighlightDetectionWorker, type ListResourcesFilters, PACKAGE_NAME, ReferenceDetectionWorker, ResourceContext, TagDetectionWorker, VERSION };