@semiont/jobs 0.5.8 → 0.5.10

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { JobId, UserId, ResourceId, EntityType, AnnotationId, Annotation, GatheredContext, TagSchema, Logger, EventBus, components, SupportedMediaType } from '@semiont/core';
+import { JobId, UserId, ResourceId, EntityType, AnnotationId, GatheredContext, SupportedMediaType, TagSchema, Logger, EventBus, components } from '@semiont/core';
 import { SemiontProject } from '@semiont/core/node';
 import { InferenceClient } from '@semiont/inference';
 
@@ -74,10 +74,13 @@ interface DetectionParams {
  * Generation job parameters
  */
 interface GenerationParams {
-    referenceId: AnnotationId;
-    sourceResourceId: ResourceId;
-    sourceResourceName: string;
-    annotation: Annotation;
+    /**
+     * The unresolved reference an annotation-focus generation was triggered from.
+     * Absent for resource-focus generation (`yield.fromResource`). When present, the
+     * worker auto-binds the new resource to it; when absent, provenance is a minted
+     * source→derived reference annotation (Fork 2b).
+     */
+    referenceId?: AnnotationId;
     prompt?: string;
     title?: string;
     entityTypes?: EntityType[];
@@ -93,6 +96,13 @@ interface GenerationParams {
     temperature?: number;
     maxTokens?: number;
     storageUri?: string;
+    /**
+     * Requested media type of the generated resource's content. Default `text/markdown`.
+     * The generation worker produces `text/markdown` and `text/plain`; any other value
+     * fails the job (no silent fallback) — Semiont is multi-modal at the core, but
+     * generation coverage is text-only for now and the gap is surfaced, not hidden.
+     */
+    outputMediaType?: SupportedMediaType;
 }
 /**
  * Highlight detection job parameters
@@ -503,6 +513,16 @@ declare function processGenerationJob(inferenceClient: InferenceClient, params:
     result: GenerationResult;
 }>;
 
+/**
+ * Response parsers for annotation detection motivations
+ *
+ * Provides static methods to parse and validate AI responses for each motivation type.
+ * Includes offset validation and correction logic.
+ * Extracted from worker implementations to centralize parsing logic.
+ *
+ * NOTE: These are static utility methods without logger access.
+ * Console statements kept for debugging - consider adding logger parameter in future.
+ */
 /**
  * Represents a detected comment with validated position
  */
@@ -617,7 +637,7 @@ declare class AnnotationDetection {
  * generate German content from an English source resource. See
  * `types.ts` "Locale conventions" for the full discussion.
  */
-declare function generateResourceFromTopic(topic: string, entityTypes: string[], client: InferenceClient, logger: Logger, userPrompt?: string, locale?: string, context?: GatheredContext, temperature?: number, maxTokens?: number, sourceLanguage?: string): Promise<{
+declare function generateResourceFromTopic(topic: string, entityTypes: string[], client: InferenceClient, logger: Logger, userPrompt?: string, locale?: string, context?: GatheredContext, temperature?: number, maxTokens?: number, sourceLanguage?: string, outputMediaType?: SupportedMediaType): Promise<{
     title: string;
     content: string;
 }>;