@semiont/jobs 0.5.4 → 0.5.5

package/dist/types.d.ts

@@ -1,319 +0,0 @@
-/**
- * Job Queue Type Definitions - Discriminated Union Design
- *
- * Jobs represent async work that can be queued, processed, and monitored.
- * Uses TypeScript discriminated unions to enforce valid state transitions.
- *
- * Design principles:
- * - Each job status has specific valid fields
- * - Type narrowing works automatically via status discriminant
- * - No optional fields that may or may not exist
- * - State machine is explicit and type-safe
- */
-import type { Readable } from 'stream';
-import type { Annotation, JobId, EntityType, ResourceId, UserId, AnnotationId, GatheredContext, TagSchema } from '@semiont/core';
-/**
- * Content fetcher - turns a ResourceId into a readable stream.
- * Workers use this to access resource content on demand.
- * The implementation is provided by the backend at startup.
- */
-export type ContentFetcher = (resourceId: ResourceId) => Promise<Readable | null>;
-export type JobType = 'reference-annotation' | 'generation' | 'highlight-annotation' | 'assessment-annotation' | 'comment-annotation' | 'tag-annotation';
-export type JobStatus = 'pending' | 'running' | 'complete' | 'failed' | 'cancelled';
-/**
- * Job metadata - common to all states
- */
-export interface JobMetadata {
-    id: JobId;
-    type: JobType;
-    userId: UserId;
-    userName: string;
-    userEmail: string;
-    userDomain: string;
-    created: string;
-    retryCount: number;
-    maxRetries: number;
-}
-/**
- * Locale conventions for detection/generation params.
- *
- * Two independent locales flow through these jobs:
- *
- *   - `language` — *annotation body* locale. The BCP-47 tag the LLM should
- *     write generated body text in (comment text, assessment text, generated
- *     resource content, tag category label). Sourced from the user's UI
- *     locale. Stamped onto the W3C `TextualBody.language` field.
- *
- *   - `sourceLanguage` — *source resource* locale. The BCP-47 tag of the
- *     content being analyzed. Sourced from `ResourceDescriptor` (carried as
- *     `Representation.language` on the primary representation). Used in
- *     prompts so the LLM analyzes non-English source correctly even when
- *     the user's UI locale differs.
- *
- * Examples: a German user analyzing an English document → `language='de'`,
- * `sourceLanguage='en'`. An English user detecting entities in a French
- * document → `language='en'` (unused for entity references), `sourceLanguage='fr'`.
- */
-/**
- * Detection job parameters
- */
-export interface DetectionParams {
-    resourceId: ResourceId;
-    entityTypes: EntityType[];
-    includeDescriptiveReferences?: boolean;
-    /** Annotation body locale — see locale conventions above. */
-    language?: string;
-    /** Source-resource locale — see locale conventions above. */
-    sourceLanguage?: string;
-}
-/**
- * Generation job parameters
- */
-export interface GenerationParams {
-    referenceId: AnnotationId;
-    sourceResourceId: ResourceId;
-    sourceResourceName: string;
-    annotation: Annotation;
-    prompt?: string;
-    title?: string;
-    entityTypes?: EntityType[];
-    /** Annotation body locale — language the *generated resource* is written in. */
-    language?: string;
-    /**
-     * Source-resource locale — language of the resource being referenced.
-     * Used in the prompt so the LLM understands the embedded source-context
-     * snippet correctly when source ≠ target language.
-     */
-    sourceLanguage?: string;
-    context?: GatheredContext;
-    temperature?: number;
-    maxTokens?: number;
-    storageUri?: string;
-}
-/**
- * Highlight detection job parameters
- */
-export interface HighlightDetectionParams {
-    resourceId: ResourceId;
-    instructions?: string;
-    density?: number;
-    /** Source-resource locale — see locale conventions above. */
-    sourceLanguage?: string;
-}
-/**
- * Assessment detection job parameters
- */
-export interface AssessmentDetectionParams {
-    resourceId: ResourceId;
-    instructions?: string;
-    tone?: 'analytical' | 'critical' | 'balanced' | 'constructive';
-    density?: number;
-    /** Annotation body locale — see locale conventions above. */
-    language?: string;
-    /** Source-resource locale — see locale conventions above. */
-    sourceLanguage?: string;
-}
-/**
- * Comment detection job parameters
- */
-export interface CommentDetectionParams {
-    resourceId: ResourceId;
-    instructions?: string;
-    tone?: 'scholarly' | 'explanatory' | 'conversational' | 'technical';
-    density?: number;
-    /** Annotation body locale — see locale conventions above. */
-    language?: string;
-    /** Source-resource locale — see locale conventions above. */
-    sourceLanguage?: string;
-}
-/**
- * Tag detection job parameters.
- *
- * Carries the *full* `TagSchema` (not just an id). The dispatcher resolves
- * the caller-supplied `schemaId` against the per-KB tag-schema projection
- * at job-creation time and embeds the resolved schema here, keeping the
- * worker independent of the registry.
- */
-export interface TagDetectionParams {
-    resourceId: ResourceId;
-    schema: TagSchema;
-    categories: string[];
-    /** Annotation body locale — see locale conventions above. */
-    language?: string;
-    /** Source-resource locale — see locale conventions above. */
-    sourceLanguage?: string;
-}
-/**
- * Detection job progress
- */
-export interface DetectionProgress {
-    totalEntityTypes: number;
-    processedEntityTypes: number;
-    currentEntityType?: string;
-    entitiesFound: number;
-    entitiesEmitted: number;
-}
-/**
- * Detection job result
- */
-export interface DetectionResult {
-    totalFound: number;
-    totalEmitted: number;
-    errors: number;
-}
-/**
- * Generation job progress
- */
-export interface YieldProgress {
-    stage: 'fetching' | 'generating' | 'creating' | 'linking';
-    percentage: number;
-    message?: string;
-}
-/**
- * Generation job result
- */
-export interface GenerationResult {
-    resourceId: ResourceId;
-    resourceName: string;
-}
-/**
- * Highlight detection job progress
- */
-export interface HighlightDetectionProgress {
-    stage: 'analyzing' | 'creating';
-    percentage: number;
-    message?: string;
-}
-/**
- * Highlight detection job result
- */
-export interface HighlightDetectionResult {
-    highlightsFound: number;
-    highlightsCreated: number;
-}
-/**
- * Assessment detection job progress
- */
-export interface AssessmentDetectionProgress {
-    stage: 'analyzing' | 'creating';
-    percentage: number;
-    message?: string;
-}
-/**
- * Assessment detection job result
- */
-export interface AssessmentDetectionResult {
-    assessmentsFound: number;
-    assessmentsCreated: number;
-}
-/**
- * Comment detection job progress
- */
-export interface CommentDetectionProgress {
-    stage: 'analyzing' | 'creating';
-    percentage: number;
-    message?: string;
-}
-/**
- * Comment detection job result
- */
-export interface CommentDetectionResult {
-    commentsFound: number;
-    commentsCreated: number;
-}
-/**
- * Tag detection job progress
- */
-export interface TagDetectionProgress {
-    stage: 'analyzing' | 'creating';
-    percentage: number;
-    currentCategory?: string;
-    processedCategories: number;
-    totalCategories: number;
-    message?: string;
-}
-/**
- * Tag detection job result
- */
-export interface TagDetectionResult {
-    tagsFound: number;
-    tagsCreated: number;
-    byCategory: Record<string, number>;
-}
-/**
- * Pending job - just created, waiting to be picked up
- */
-export interface PendingJob<P> {
-    status: 'pending';
-    metadata: JobMetadata;
-    params: P;
-}
-/**
- * Running job - actively being processed
- */
-export interface RunningJob<P, PG> {
-    status: 'running';
-    metadata: JobMetadata;
-    params: P;
-    startedAt: string;
-    progress: PG;
-}
-/**
- * Complete job - successfully finished
- */
-export interface CompleteJob<P, R> {
-    status: 'complete';
-    metadata: JobMetadata;
-    params: P;
-    startedAt: string;
-    completedAt: string;
-    result: R;
-}
-/**
- * Failed job - encountered an error
- */
-export interface FailedJob<P> {
-    status: 'failed';
-    metadata: JobMetadata;
-    params: P;
-    startedAt?: string;
-    completedAt: string;
-    error: string;
-}
-/**
- * Cancelled job - stopped by user
- */
-export interface CancelledJob<P> {
-    status: 'cancelled';
-    metadata: JobMetadata;
-    params: P;
-    startedAt?: string;
-    completedAt: string;
-}
-/**
- * Generic job - discriminated union of all states
- */
-export type Job<P, PG, R> = PendingJob<P> | RunningJob<P, PG> | CompleteJob<P, R> | FailedJob<P> | CancelledJob<P>;
-export type DetectionJob = Job<DetectionParams, DetectionProgress, DetectionResult>;
-export type GenerationJob = Job<GenerationParams, YieldProgress, GenerationResult>;
-export type HighlightDetectionJob = Job<HighlightDetectionParams, HighlightDetectionProgress, HighlightDetectionResult>;
-export type AssessmentDetectionJob = Job<AssessmentDetectionParams, AssessmentDetectionProgress, AssessmentDetectionResult>;
-export type CommentDetectionJob = Job<CommentDetectionParams, CommentDetectionProgress, CommentDetectionResult>;
-export type TagDetectionJob = Job<TagDetectionParams, TagDetectionProgress, TagDetectionResult>;
-/**
- * Discriminated union of all job types
- */
-export type AnyJob = DetectionJob | GenerationJob | HighlightDetectionJob | AssessmentDetectionJob | CommentDetectionJob | TagDetectionJob;
-export declare function isPendingJob(job: AnyJob): job is PendingJob<any>;
-export declare function isRunningJob(job: AnyJob): job is RunningJob<any, any>;
-export declare function isCompleteJob(job: AnyJob): job is CompleteJob<any, any>;
-export declare function isFailedJob(job: AnyJob): job is FailedJob<any>;
-export declare function isCancelledJob(job: AnyJob): job is CancelledJob<any>;
-export interface JobQueryFilters {
-    status?: JobStatus;
-    type?: JobType;
-    userId?: UserId;
-    limit?: number;
-    offset?: number;
-}
-//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

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

@@ -1 +0,0 @@
-{"version":3,"file":"worker-main.d.ts","sourceRoot":"","sources":["../src/worker-main.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG"}

package/dist/worker-process.d.ts

@@ -1,47 +0,0 @@
-/**
- * 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

@@ -1 +0,0 @@
-{"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

@@ -1,61 +0,0 @@
-/**
- * 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

@@ -1 +0,0 @@
-{"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

@@ -1,42 +0,0 @@
-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

@@ -1 +0,0 @@
-{"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

@@ -1,116 +0,0 @@
-/**
- * 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

@@ -1 +0,0 @@
-{"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"}