@semiont/jobs 0.5.3 → 0.5.4

package/dist/worker-process.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Worker Process Entry Point
+ *
+ * One worker process serves a single software-agent identity — one
+ * `(inferenceProvider, model)` pair. The session it owns is
+ * authenticated *as that agent* (`/api/tokens/agent`), so every event
+ * the worker emits attributes to the agent at the bus seat. Multiple
+ * agents on the same host run as multiple worker processes side by
+ * side; their job-claim subscriptions don't interfere because each
+ * agent only subscribes to the job types its inference engine is
+ * configured to serve.
+ *
+ * `createJobClaimAdapter` handles the reactive contract (SSE
+ * subscription, claim, completion tracking). This file wires the
+ * job processors to the adapter and drives lifecycle emissions.
+ */
+import { type JobClaimAdapter, type ActiveJob } from './job-claim-adapter';
+import type { SemiontSession } from '@semiont/sdk';
+import type { InferenceClient } from '@semiont/inference';
+import type { Logger, components } from '@semiont/core';
+type Agent = components['schemas']['Agent'];
+export interface WorkerProcessConfig {
+    /**
+     * The session authenticated as this worker's software-agent identity.
+     * Bus emits through this session attribute to that agent.
+     */
+    session: SemiontSession;
+    /**
+     * The job types this agent serves. Today every job type a worker
+     * subscribes to runs through the same inference engine — different
+     * inference engines mean different agents and therefore different
+     * worker processes.
+     */
+    jobTypes: string[];
+    inferenceClient: InferenceClient;
+    /**
+     * The agent (Software) record stamped onto annotations as `generator`
+     * and onto resources as `wasAttributedTo`. Same identity that the
+     * session is authenticated as.
+     */
+    generator: Agent;
+    logger: Logger;
+}
+export declare function startWorkerProcess(config: WorkerProcessConfig): JobClaimAdapter;
+export declare function handleJob(adapter: JobClaimAdapter, config: WorkerProcessConfig, job: ActiveJob): Promise<void>;
+export {};
+//# sourceMappingURL=worker-process.d.ts.map

package/dist/worker-process.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker-process.d.ts","sourceRoot":"","sources":["../src/worker-process.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAyB,KAAK,eAAe,EAAE,KAAK,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAClG,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAGnD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAaxD,KAAK,KAAK,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC,OAAO,CAAC,CAAC;AAE5C,MAAM,WAAW,mBAAmB;IAClC;;;OAGG;IACH,OAAO,EAAE,cAAc,CAAC;IACxB;;;;;OAKG;IACH,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,eAAe,EAAE,eAAe,CAAC;IACjC;;;;OAIG;IACH,SAAS,EAAE,KAAK,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;CAChB;AAiBD,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,mBAAmB,GAAG,eAAe,CAkC/E;AAKD,wBAAsB,SAAS,CAC7B,OAAO,EAAE,eAAe,EACxB,MAAM,EAAE,mBAAmB,EAC3B,GAAG,EAAE,SAAS,GACb,OAAO,CAAC,IAAI,CAAC,CAsBf"}

package/dist/workers/annotation-detection.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Annotation Detection
+ *
+ * Orchestrates the full annotation detection pipeline:
+ * 1. Build AI prompts using MotivationPrompts
+ * 2. Call AI inference
+ * 3. Parse and validate results using MotivationParsers
+ *
+ * All methods take content as a string parameter.
+ * Workers are responsible for fetching content via ContentFetcher.
+ */
+import type { InferenceClient } from '@semiont/inference';
+import { type CommentMatch, type HighlightMatch, type AssessmentMatch, type TagMatch } from './detection/motivation-parsers';
+import type { ResourceId, TagSchema } from '@semiont/core';
+import type { ContentFetcher } from '../types';
+export declare class AnnotationDetection {
+    /**
+     * Fetch content from a ContentFetcher and read the stream to a string.
+     * Shared helper for all workers.
+     */
+    static fetchContent(contentFetcher: ContentFetcher, resourceId: ResourceId): Promise<string>;
+    /**
+     * Detect comments in content.
+     *
+     * `language` is the locale the LLM should write comment text in (annotation
+     * body locale). `sourceLanguage` is the locale of the content being analyzed
+     * (source-resource locale). See `types.ts` "Locale conventions" for the
+     * full discussion.
+     */
+    static detectComments(content: string, client: InferenceClient, instructions?: string, tone?: string, density?: number, language?: string, sourceLanguage?: string): Promise<CommentMatch[]>;
+    /**
+     * Detect highlights in content.
+     *
+     * Highlights have no body — only `sourceLanguage` (source-resource locale)
+     * applies, used in the prompt so the LLM analyzes non-English source
+     * correctly.
+     */
+    static detectHighlights(content: string, client: InferenceClient, instructions?: string, density?: number, sourceLanguage?: string): Promise<HighlightMatch[]>;
+    /**
+     * Detect assessments in content.
+     *
+     * `language` is the locale the LLM should write assessment text in
+     * (annotation body locale). `sourceLanguage` is the locale of the content
+     * being analyzed (source-resource locale).
+     */
+    static detectAssessments(content: string, client: InferenceClient, instructions?: string, tone?: string, density?: number, language?: string, sourceLanguage?: string): Promise<AssessmentMatch[]>;
+    /**
+     * Detect tags in content for a specific category.
+     *
+     * The full `TagSchema` is supplied by the dispatcher (resolved against
+     * the per-KB tag-schema projection at job-creation time) so the worker
+     * is independent of the registry.
+     *
+     * `sourceLanguage` is the locale of the content being analyzed. Body-locale
+     * (`language`) doesn't influence the tag prompt — categories are schema
+     * identifiers, not LLM-generated text — so it's consumed at the body-stamp
+     * site, not here.
+     */
+    static detectTags(content: string, client: InferenceClient, schema: TagSchema, category: string, sourceLanguage?: string): Promise<TagMatch[]>;
+}
+//# sourceMappingURL=annotation-detection.d.ts.map

package/dist/workers/annotation-detection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"annotation-detection.d.ts","sourceRoot":"","sources":["../../src/workers/annotation-detection.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAE1D,OAAO,EAEL,KAAK,YAAY,EACjB,KAAK,cAAc,EACnB,KAAK,eAAe,EACpB,KAAK,QAAQ,EACd,MAAM,gCAAgC,CAAC;AACxC,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC3D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAE/C,qBAAa,mBAAmB;IAE9B;;;OAGG;WACU,YAAY,CAAC,cAAc,EAAE,cAAc,EAAE,UAAU,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC;IAYlG;;;;;;;OAOG;WACU,cAAc,CACzB,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,eAAe,EACvB,YAAY,CAAC,EAAE,MAAM,EACrB,IAAI,CAAC,EAAE,MAAM,EACb,OAAO,CAAC,EAAE,MAAM,EAChB,QAAQ,CAAC,EAAE,MAAM,EACjB,cAAc,CAAC,EAAE,MAAM,GACtB,OAAO,CAAC,YAAY,EAAE,CAAC;IAM1B;;;;;;OAMG;WACU,gBAAgB,CAC3B,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,eAAe,EACvB,YAAY,CAAC,EAAE,MAAM,EACrB,OAAO,CAAC,EAAE,MAAM,EAChB,cAAc,CAAC,EAAE,MAAM,GACtB,OAAO,CAAC,cAAc,EAAE,CAAC;IAM5B;;;;;;OAMG;WACU,iBAAiB,CAC5B,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,eAAe,EACvB,YAAY,CAAC,EAAE,MAAM,EACrB,IAAI,CAAC,EAAE,MAAM,EACb,OAAO,CAAC,EAAE,MAAM,EAChB,QAAQ,CAAC,EAAE,MAAM,EACjB,cAAc,CAAC,EAAE,MAAM,GACtB,OAAO,CAAC,eAAe,EAAE,CAAC;IAM7B;;;;;;;;;;;OAWG;WACU,UAAU,CACrB,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,eAAe,EACvB,MAAM,EAAE,SAAS,EACjB,QAAQ,EAAE,MAAM,EAChB,cAAc,CAAC,EAAE,MAAM,GACtB,OAAO,CAAC,QAAQ,EAAE,CAAC;CAqBvB"}

package/dist/workers/detection/entity-extractor.d.ts

@@ -0,0 +1,42 @@
+import type { InferenceClient } from '@semiont/inference';
+import { type Logger } from '@semiont/core';
+/**
+ * Entity reference extracted from text.
+ *
+ * `start` / `end` follow the W3C Web Annotation Data Model
+ * `TextPositionSelector` shape. The LLM-prompt wire format separately
+ * uses `startOffset` / `endOffset` (more self-documenting in prose);
+ * the parse step in `extractEntities` translates between the two so
+ * the rest of the pipeline never touches the LLM-shaped names.
+ */
+export interface ExtractedEntity {
+    exact: string;
+    entityType: string;
+    start: number;
+    end: number;
+    prefix?: string;
+    suffix?: string;
+}
+/**
+ * Extract entity references from text using AI.
+ *
+ * Locale: entity references' bodies are entity-type identifiers (not
+ * LLM-generated natural-language text), so only `sourceLanguage` (source-
+ * resource locale) is meaningful here — it's used in the prompt so the LLM
+ * analyzes non-English source correctly. There's no body-locale parameter.
+ *
+ * @param text - The text to analyze
+ * @param entityTypes - Array of entity types to detect (optionally with examples)
+ * @param client - Inference client for AI operations
+ * @param includeDescriptiveReferences - Include anaphoric/cataphoric references (default: false)
+ * @param logger - Logger for entity-extraction diagnostics (parse failures,
+ *   anchor decisions, drops). Required so dropped/filtered entities never
+ *   disappear silently.
+ * @param sourceLanguage - BCP-47 tag for the source content's language
+ * @returns Array of extracted entities with their character offsets
+ */
+export declare function extractEntities(exact: string, entityTypes: string[] | {
+    type: string;
+    examples?: string[];
+}[], client: InferenceClient, includeDescriptiveReferences: boolean, logger: Logger, sourceLanguage?: string): Promise<ExtractedEntity[]>;
+//# sourceMappingURL=entity-extractor.d.ts.map

package/dist/workers/detection/entity-extractor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity-extractor.d.ts","sourceRoot":"","sources":["../../../src/workers/detection/entity-extractor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAwB,KAAK,MAAM,EAAE,MAAM,eAAe,CAAC;AAElE;;;;;;;;GAQG;AACH,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,eAAe,CACnC,KAAK,EAAE,MAAM,EACb,WAAW,EAAE,MAAM,EAAE,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;CAAE,EAAE,EAC/D,MAAM,EAAE,eAAe,EACvB,4BAA4B,EAAE,OAAO,EACrC,MAAM,EAAE,MAAM,EACd,cAAc,CAAC,EAAE,MAAM,GACtB,OAAO,CAAC,eAAe,EAAE,CAAC,CAmS5B"}

package/dist/workers/detection/motivation-parsers.d.ts

@@ -0,0 +1,116 @@
+/**
+ * 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.
+ */
+/**
+ * Best-effort extractor that pulls a JSON array of objects out of a raw
+ * LLM response. Tolerates:
+ *   - markdown code fences (``` / ```json)
+ *   - prose before/after the array
+ *   - stray non-JSON tokens between array elements (a common
+ *     hallucination: e.g. a line like `wide: 0,` inserted between two
+ *     well-formed objects).
+ *
+ * Strategy: try strict `JSON.parse` first (fast path); on failure, walk
+ * between the outermost `[` and `]` and parse each balanced `{ ... }`
+ * object independently, skipping any that don't parse. Returns the
+ * recovered objects — callers should still filter/validate fields.
+ *
+ * Exported for direct unit testing of the state machine edge cases
+ * (nested braces in strings, escape sequences, empty/garbage input).
+ */
+export declare function extractObjectsFromArray(response: string): unknown[];
+/**
+ * Represents a detected comment with validated position
+ */
+export interface CommentMatch {
+    exact: string;
+    start: number;
+    end: number;
+    prefix?: string;
+    suffix?: string;
+    comment: string;
+}
+/**
+ * Represents a detected highlight with validated position
+ */
+export interface HighlightMatch {
+    exact: string;
+    start: number;
+    end: number;
+    prefix?: string;
+    suffix?: string;
+}
+/**
+ * Represents a detected assessment with validated position
+ */
+export interface AssessmentMatch {
+    exact: string;
+    start: number;
+    end: number;
+    prefix?: string;
+    suffix?: string;
+    assessment: string;
+}
+/**
+ * Represents a detected tag with validated position
+ */
+export interface TagMatch {
+    exact: string;
+    start: number;
+    end: number;
+    prefix?: string;
+    suffix?: string;
+    category: string;
+}
+export declare class MotivationParsers {
+    /**
+     * Parse and validate AI response for comment detection
+     *
+     * @param response - Raw AI response string (may include markdown code fences)
+     * @param content - Original content to validate offsets against
+     * @returns Array of validated comment matches
+     */
+    static parseComments(response: string, content: string): CommentMatch[];
+    /**
+     * Parse and validate AI response for highlight detection
+     *
+     * @param response - Raw AI response string (may include markdown code fences)
+     * @param content - Original content to validate offsets against
+     * @returns Array of validated highlight matches
+     */
+    static parseHighlights(response: string, content: string): HighlightMatch[];
+    /**
+     * Parse and validate AI response for assessment detection
+     *
+     * @param response - Raw AI response string (may include markdown code fences)
+     * @param content - Original content to validate offsets against
+     * @returns Array of validated assessment matches
+     */
+    static parseAssessments(response: string, content: string): AssessmentMatch[];
+    /**
+     * Parse and validate AI response for tag detection
+     * Note: Does NOT validate offsets - caller must do that with content
+     *
+     * @param response - Raw AI response string (may include markdown code fences)
+     * @returns Array of tag matches (offsets not yet validated)
+     */
+    static parseTags(response: string): Omit<TagMatch, 'category'>[];
+    /**
+     * Validate tag offsets against content and add category
+     * Helper for tag detection after initial parsing
+     *
+     * @param tags - Parsed tags without validated offsets
+     * @param content - Original content to validate against
+     * @param category - Category to assign to validated tags
+     * @returns Array of validated tag matches
+     */
+    static validateTagOffsets(tags: Omit<TagMatch, 'category'>[], content: string, category: string): TagMatch[];
+}
+//# sourceMappingURL=motivation-parsers.d.ts.map

package/dist/workers/detection/motivation-parsers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"motivation-parsers.d.ts","sourceRoot":"","sources":["../../../src/workers/detection/motivation-parsers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,EAAE,CAuDnE;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,qBAAa,iBAAiB;IAC5B;;;;;;OAMG;IACH,MAAM,CAAC,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,YAAY,EAAE;IA2CvE;;;;;;OAMG;IACH,MAAM,CAAC,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,cAAc,EAAE;IAwC3E;;;;;;OAMG;IACH,MAAM,CAAC,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,eAAe,EAAE;IAyC7E;;;;;;OAMG;IACH,MAAM,CAAC,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC,QAAQ,EAAE,UAAU,CAAC,EAAE;IAsBhE;;;;;;;;OAQG;IACH,MAAM,CAAC,kBAAkB,CACvB,IAAI,EAAE,IAAI,CAAC,QAAQ,EAAE,UAAU,CAAC,EAAE,EAClC,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,GACf,QAAQ,EAAE;CAsBd"}

package/dist/workers/detection/motivation-prompts.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Prompt builders for annotation detection motivations
+ *
+ * Provides static methods to build AI prompts for each Web Annotation motivation type.
+ * Extracted from worker implementations to centralize prompt logic.
+ *
+ * Locale handling: builders take two optional BCP-47 tags. `language` is the
+ * locale the *generated body text* should be written in (sourced from the user's
+ * UI locale); `sourceLanguage` is the locale of the *text being analyzed*
+ * (sourced from `ResourceDescriptor` / its primary representation). They are
+ * independent — see `types.ts` "Locale conventions" for the full discussion.
+ */
+export declare class MotivationPrompts {
+    /**
+     * Build a prompt for detecting comment-worthy passages
+     *
+     * @param content - The text content to analyze (will be truncated to 8000 chars)
+     * @param instructions - Optional user-provided instructions
+     * @param tone - Optional tone guidance (e.g., "academic", "conversational")
+     * @param density - Optional target number of comments per 2000 words
+     * @returns Formatted prompt string
+     */
+    static buildCommentPrompt(content: string, instructions?: string, tone?: string, density?: number, language?: string, sourceLanguage?: string): string;
+    /**
+     * Build a prompt for detecting highlight-worthy passages
+     *
+     * @param content - The text content to analyze (will be truncated to 8000 chars)
+     * @param instructions - Optional user-provided instructions
+     * @param density - Optional target number of highlights per 2000 words
+     * @returns Formatted prompt string
+     */
+    static buildHighlightPrompt(content: string, instructions?: string, density?: number, sourceLanguage?: string): string;
+    /**
+     * Build a prompt for detecting assessment-worthy passages
+     *
+     * @param content - The text content to analyze (will be truncated to 8000 chars)
+     * @param instructions - Optional user-provided instructions
+     * @param tone - Optional tone guidance (e.g., "critical", "supportive")
+     * @param density - Optional target number of assessments per 2000 words
+     * @returns Formatted prompt string
+     */
+    static buildAssessmentPrompt(content: string, instructions?: string, tone?: string, density?: number, language?: string, sourceLanguage?: string): string;
+    /**
+     * Build a prompt for detecting structural tags
+     *
+     * @param content - The full text content to analyze (NOT truncated for structural analysis)
+     * @param category - The specific category to detect
+     * @param schemaName - Human-readable schema name
+     * @param schemaDescription - Schema description
+     * @param schemaDomain - Schema domain
+     * @param categoryDescription - Category description
+     * @param categoryExamples - Example questions/guidance for this category
+     * @returns Formatted prompt string
+     */
+    static buildTagPrompt(content: string, category: string, schemaName: string, schemaDescription: string, schemaDomain: string, categoryDescription: string, categoryExamples: string[], sourceLanguage?: string): string;
+}
+//# sourceMappingURL=motivation-prompts.d.ts.map

package/dist/workers/detection/motivation-prompts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"motivation-prompts.d.ts","sourceRoot":"","sources":["../../../src/workers/detection/motivation-prompts.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAoBH,qBAAa,iBAAiB;IAC5B;;;;;;;;OAQG;IACH,MAAM,CAAC,kBAAkB,CACvB,OAAO,EAAE,MAAM,EACf,YAAY,CAAC,EAAE,MAAM,EACrB,IAAI,CAAC,EAAE,MAAM,EACb,OAAO,CAAC,EAAE,MAAM,EAChB,QAAQ,CAAC,EAAE,MAAM,EACjB,cAAc,CAAC,EAAE,MAAM,GACtB,MAAM;IA8ET;;;;;;;OAOG;IACH,MAAM,CAAC,oBAAoB,CACzB,OAAO,EAAE,MAAM,EACf,YAAY,CAAC,EAAE,MAAM,EACrB,OAAO,CAAC,EAAE,MAAM,EAChB,cAAc,CAAC,EAAE,MAAM,GACtB,MAAM;IAwET;;;;;;;;OAQG;IACH,MAAM,CAAC,qBAAqB,CAC1B,OAAO,EAAE,MAAM,EACf,YAAY,CAAC,EAAE,MAAM,EACrB,IAAI,CAAC,EAAE,MAAM,EACb,OAAO,CAAC,EAAE,MAAM,EAChB,QAAQ,CAAC,EAAE,MAAM,EACjB,cAAc,CAAC,EAAE,MAAM,GACtB,MAAM;IA8ET;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,cAAc,CACnB,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,iBAAiB,EAAE,MAAM,EACzB,YAAY,EAAE,MAAM,EACpB,mBAAmB,EAAE,MAAM,EAC3B,gBAAgB,EAAE,MAAM,EAAE,EAC1B,cAAc,CAAC,EAAE,MAAM,GACtB,MAAM;CAiDV"}

package/dist/workers/generation/resource-generation.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Resource Generation
+ *
+ * Generates markdown resources from topics using AI inference.
+ */
+import type { GatheredContext, Logger } from '@semiont/core';
+import type { InferenceClient } from '@semiont/inference';
+/**
+ * Generate resource content using inference.
+ *
+ * Locale parameters: `locale` is the *body* locale — the language the
+ * generated resource should be written in (sourced from the user's UI
+ * locale). `sourceLanguage` is the *source* locale — the language of the
+ * referenced resource whose context (selected passage, surrounding text)
+ * is embedded into the prompt. They're independent: a German user can
+ * generate German content from an English source resource. See
+ * `types.ts` "Locale conventions" for the full discussion.
+ */
+export declare function generateResourceFromTopic(topic: string, entityTypes: string[], client: InferenceClient, logger: Logger, userPrompt?: string, locale?: string, context?: GatheredContext, temperature?: number, maxTokens?: number, sourceLanguage?: string): Promise<{
+    title: string;
+    content: string;
+}>;
+//# sourceMappingURL=resource-generation.d.ts.map

package/dist/workers/generation/resource-generation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource-generation.d.ts","sourceRoot":"","sources":["../../../src/workers/generation/resource-generation.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAC7D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAO1D;;;;;;;;;;GAUG;AACH,wBAAsB,yBAAyB,CAC7C,KAAK,EAAE,MAAM,EACb,WAAW,EAAE,MAAM,EAAE,EACrB,MAAM,EAAE,eAAe,EACvB,MAAM,EAAE,MAAM,EACd,UAAU,CAAC,EAAE,MAAM,EACnB,MAAM,CAAC,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,eAAe,EACzB,WAAW,CAAC,EAAE,MAAM,EACpB,SAAS,CAAC,EAAE,MAAM,EAClB,cAAc,CAAC,EAAE,MAAM,GACtB,OAAO,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CAyJ7C"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@semiont/jobs",
-  "version": "0.5.3",
+  "version": "0.5.4",
   "type": "module",
   "description": "Filesystem-based job queue and worker infrastructure",
   "main": "./dist/index.js",
@@ -20,7 +20,7 @@
     "README.md"
   ],
   "scripts": {
-    "build": "npm run typecheck && tsup",
+    "build": "npm run typecheck && tsup && tsc -p tsconfig.build.json",
     "typecheck": "tsc --noEmit",
     "test": "vitest",
     "test:coverage": "vitest run --coverage"
@@ -37,7 +37,7 @@
   "devDependencies": {
     "@vitest/coverage-v8": "^4.1.0",
     "tsup": "^8.0.1",
-    "typescript": "^5.6.3"
+    "typescript": "^6.0.2"
   },
   "publishConfig": {
     "access": "public"