@semiont/jobs 0.5.2 → 0.5.4

package/dist/job-claim-adapter.d.ts

@@ -0,0 +1,76 @@
+/**
+ * Job Claim Adapter — worker-side job lifecycle glue on top of a
+ * shared bus.
+ *
+ * Replaces the old `WorkerStateUnit`, which owned its own actor and
+ * duplicated the SSE connection that `SemiontClient` already held.
+ * Workers construct a `SemiontSession` normally (one actor, one
+ * SSE connection) and use this adapter to attach job-claim behaviour
+ * on top of the session's bus.
+ *
+ * The adapter is intentionally thin: it subscribes to `job:queued`,
+ * claims jobs via the existing request-response protocol
+ * (`job:claim` → `job:claimed` / `job:claim-failed`), and exposes
+ * observables for job orchestration. It does **not** own the bus,
+ * has no HTTP concerns, and has no modal state.
+ *
+ * The `bus` parameter is typed against the small `JobClaimBus`
+ * interface below so the adapter is transport-neutral. HTTP workers
+ * pass `(session.client.transport as HttpTransport).actor`; an
+ * in-process worker could pass a shim wrapping `client.bus`.
+ */
+import { Observable } from 'rxjs';
+import type { WorkerBus } from '@semiont/sdk';
+export interface JobAssignment {
+    jobId: string;
+    type: string;
+    resourceId: string;
+}
+export interface ActiveJob {
+    jobId: string;
+    type: string;
+    resourceId: string;
+    userId: string;
+    params: Record<string, unknown>;
+}
+export interface JobClaimAdapterOptions {
+    /** Shared bus (typically the session's HTTP actor or an in-process bus shim). */
+    bus: WorkerBus;
+    /**
+     * Job types this worker can process. Jobs of other types that
+     * arrive on `job:queued` are ignored. Empty array = accept any.
+     */
+    jobTypes: string[];
+}
+export interface JobClaimAdapter {
+    /** Currently-claimed job, or null when idle. */
+    readonly activeJob$: Observable<ActiveJob | null>;
+    /** True while a claim is in flight or a job is being processed. */
+    readonly isProcessing$: Observable<boolean>;
+    /** Monotonically-incrementing count of successfully-completed jobs. */
+    readonly jobsCompleted$: Observable<number>;
+    /** Stream of job failures (including claim-failed and processing errors). */
+    readonly errors$: Observable<{
+        jobId: string;
+        error: string;
+    }>;
+    /**
+     * Subscribe to `job:queued` events (adding the channel to the actor
+     * if not already subscribed) and begin claiming matching jobs.
+     * Idempotent — calling `start()` twice is a no-op.
+     */
+    start(): void;
+    /** Stop claiming new jobs. Does not cancel an in-flight job. */
+    stop(): void;
+    /** Signal successful completion of `activeJob$`. */
+    completeJob(): void;
+    /** Signal failure of `activeJob$`. Emits on `errors$`. */
+    failJob(jobId: string, error: string): void;
+    /** Release observables. Does not dispose the shared bus. */
+    dispose(): void;
+}
+/**
+ * Attach job-claim behaviour to a shared bus.
+ */
+export declare function createJobClaimAdapter(options: JobClaimAdapterOptions): JobClaimAdapter;
+//# sourceMappingURL=job-claim-adapter.d.ts.map

package/dist/job-claim-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"job-claim-adapter.d.ts","sourceRoot":"","sources":["../src/job-claim-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,EAAmB,UAAU,EAAW,MAAM,MAAM,CAAC;AAE5D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAE9C,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjC;AAED,MAAM,WAAW,sBAAsB;IACrC,iFAAiF;IACjF,GAAG,EAAE,SAAS,CAAC;IACf;;;OAGG;IACH,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,eAAe;IAC9B,gDAAgD;IAChD,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC,SAAS,GAAG,IAAI,CAAC,CAAC;IAClD,mEAAmE;IACnE,QAAQ,CAAC,aAAa,EAAE,UAAU,CAAC,OAAO,CAAC,CAAC;IAC5C,uEAAuE;IACvE,QAAQ,CAAC,cAAc,EAAE,UAAU,CAAC,MAAM,CAAC,CAAC;IAC5C,6EAA6E;IAC7E,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAE/D;;;;OAIG;IACH,KAAK,IAAI,IAAI,CAAC;IAEd,gEAAgE;IAChE,IAAI,IAAI,IAAI,CAAC;IAEb,oDAAoD;IACpD,WAAW,IAAI,IAAI,CAAC;IAEpB,0DAA0D;IAC1D,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAE5C,4DAA4D;IAC5D,OAAO,IAAI,IAAI,CAAC;CACjB;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,sBAAsB,GAAG,eAAe,CA+GtF"}

package/dist/job-queue-interface.d.ts

@@ -0,0 +1,19 @@
+import type { AnyJob, JobStatus } from './types';
+import type { JobId } from '@semiont/core';
+export interface JobQueue {
+    initialize(): Promise<void>;
+    destroy(): void;
+    createJob(job: AnyJob): Promise<void>;
+    getJob(jobId: JobId): Promise<AnyJob | null>;
+    updateJob(job: AnyJob, oldStatus?: JobStatus): Promise<void>;
+    pollNextPendingJob(predicate?: (job: AnyJob) => boolean): Promise<AnyJob | null>;
+    cancelJob(jobId: JobId): Promise<boolean>;
+    getStats(): Promise<{
+        pending: number;
+        running: number;
+        complete: number;
+        failed: number;
+        cancelled: number;
+    }>;
+}
+//# sourceMappingURL=job-queue-interface.d.ts.map

package/dist/job-queue-interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"job-queue-interface.d.ts","sourceRoot":"","sources":["../src/job-queue-interface.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACjD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AAE3C,MAAM,WAAW,QAAQ;IACvB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5B,OAAO,IAAI,IAAI,CAAC;IAChB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACtC,MAAM,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAC7C,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7D,kBAAkB,CAAC,SAAS,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IACjF,SAAS,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC1C,QAAQ,IAAI,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAChH"}

package/dist/job-queue-state-unit.d.ts

@@ -0,0 +1,26 @@
+import { type Observable } from 'rxjs';
+import type { SemiontClient, StateUnit } from '@semiont/sdk';
+export interface Job {
+    jobId: string;
+    type: string;
+    status: string;
+    resourceId: string;
+    /** DID of the user who initiated the job (audit). */
+    userId: string;
+    created: string;
+    startedAt?: string;
+    completedAt?: string;
+    error?: string;
+    progress?: Record<string, unknown>;
+    result?: Record<string, unknown>;
+}
+export interface JobQueueStateUnit extends StateUnit {
+    jobs$: Observable<Job[]>;
+    pendingByType$: Observable<Map<string, number>>;
+    runningJobs$: Observable<Job[]>;
+    jobCreated$: Observable<Job>;
+    jobCompleted$: Observable<Job>;
+    jobFailed$: Observable<Job>;
+}
+export declare function createJobQueueStateUnit(client: SemiontClient): JobQueueStateUnit;
+//# sourceMappingURL=job-queue-state-unit.d.ts.map

package/dist/job-queue-state-unit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"job-queue-state-unit.d.ts","sourceRoot":"","sources":["../src/job-queue-state-unit.ts"],"names":[],"mappings":"AAAA,OAAO,EAA4B,KAAK,UAAU,EAAO,MAAM,MAAM,CAAC;AACtE,OAAO,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAE7D,MAAM,WAAW,GAAG;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,qDAAqD;IACrD,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAED,MAAM,WAAW,iBAAkB,SAAQ,SAAS;IAClD,KAAK,EAAE,UAAU,CAAC,GAAG,EAAE,CAAC,CAAC;IACzB,cAAc,EAAE,UAAU,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAChD,YAAY,EAAE,UAAU,CAAC,GAAG,EAAE,CAAC,CAAC;IAChC,WAAW,EAAE,UAAU,CAAC,GAAG,CAAC,CAAC;IAC7B,aAAa,EAAE,UAAU,CAAC,GAAG,CAAC,CAAC;IAC/B,UAAU,EAAE,UAAU,CAAC,GAAG,CAAC,CAAC;CAC7B;AAED,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,aAAa,GAAG,iBAAiB,CAoGhF"}

package/dist/job-worker.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Job Worker Base Class
+ *
+ * Abstract worker that polls the job queue and processes jobs.
+ * Subclasses implement specific job processing logic.
+ */
+import type { AnyJob, RunningJob } from './types';
+import type { JobQueue } from './job-queue-interface';
+import type { Logger } from '@semiont/core';
+export declare abstract class JobWorker {
+    private running;
+    private currentJob;
+    private pollIntervalMs;
+    private errorBackoffMs;
+    protected jobQueue: JobQueue;
+    protected logger: Logger;
+    constructor(jobQueue: JobQueue, pollIntervalMs: number | undefined, errorBackoffMs: number | undefined, logger: Logger);
+    /**
+     * Start the worker (polls queue in loop)
+     */
+    start(): Promise<void>;
+    /**
+     * Stop the worker (graceful shutdown)
+     */
+    stop(): Promise<void>;
+    /**
+     * Poll for next job to process
+     */
+    private pollNextJob;
+    /**
+     * Process a job (handles state transitions and error handling)
+     */
+    private processJob;
+    /**
+     * Handle job failure (retry or move to failed)
+     */
+    protected handleJobFailure(job: AnyJob, error: any): Promise<void>;
+    /**
+     * Update job progress (best-effort, doesn't throw)
+     */
+    protected updateJobProgress(job: AnyJob): Promise<void>;
+    /**
+     * Sleep utility
+     */
+    protected sleep(ms: number): Promise<void>;
+    /**
+     * Emit completion event (optional hook for subclasses)
+     * Override this to emit job-specific completion events (e.g., job.completed)
+     */
+    protected emitCompletionEvent(_job: RunningJob<any, any>, _result: any): Promise<void>;
+    /**
+     * Get worker name (for logging)
+     */
+    protected abstract getWorkerName(): string;
+    /**
+     * Check if this worker can process the given job
+     */
+    protected abstract canProcessJob(job: AnyJob): boolean;
+    /**
+     * Execute the job (job-specific logic)
+     * This is where the actual work happens
+     * Return the result object (or void for jobs without results)
+     * Throw an error to trigger retry logic
+     */
+    protected abstract executeJob(job: AnyJob): Promise<any>;
+}
+//# sourceMappingURL=job-worker.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"job-worker.d.ts","sourceRoot":"","sources":["../src/job-worker.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,UAAU,EAAsC,MAAM,SAAS,CAAC;AACtF,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAE5C,8BAAsB,SAAS;IAC7B,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,UAAU,CAAuB;IACzC,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,cAAc,CAAS;IAC/B,SAAS,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAC7B,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC;gBAGvB,QAAQ,EAAE,QAAQ,EAClB,cAAc,EAAE,MAAM,YAAO,EAC7B,cAAc,EAAE,MAAM,YAAO,EAC7B,MAAM,EAAE,MAAM;IAQhB;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAwB5B;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAiB3B;;OAEG;YACW,WAAW;IAIzB;;OAEG;YACW,UAAU;IAkDxB;;OAEG;cACa,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC;IAqCxE;;OAEG;cACa,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAS7D;;OAEG;IACH,SAAS,CAAC,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI1C;;;OAGG;cACa,mBAAmB,CAAC,IAAI,EAAE,UAAU,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,OAAO,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC;IAO5F;;OAEG;IACH,SAAS,CAAC,QAAQ,CAAC,aAAa,IAAI,MAAM;IAE1C;;OAEG;IACH,SAAS,CAAC,QAAQ,CAAC,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAEtD;;;;;OAKG;IACH,SAAS,CAAC,QAAQ,CAAC,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC;CACzD"}

package/dist/processors.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Job Processors — extracted from JobWorker subclasses
+ *
+ * Pure functions that take content + inference client + params,
+ * report progress via callback, and return annotations + results.
+ *
+ * No EventBus, no JobQueue, no side effects except calling inference.
+ * Two callers:
+ *   1. In-process JobWorker subclasses (existing path)
+ *   2. Remote WorkerStateUnit via worker-process.ts (new path)
+ */
+import { type Logger, type components } from '@semiont/core';
+import type { InferenceClient } from '@semiont/inference';
+import type { HighlightDetectionParams, CommentDetectionParams, AssessmentDetectionParams, DetectionParams, TagDetectionParams, GenerationParams, HighlightDetectionResult, CommentDetectionResult, AssessmentDetectionResult, DetectionResult, TagDetectionResult, GenerationResult } from './types';
+type Agent = components['schemas']['Agent'];
+/**
+ * Progress callback. The three positional args satisfy the minimum
+ * `JobProgress` required fields (`percentage`, `message`, `stage`).
+ * The fourth optional arg carries job-type-specific fields
+ * (`currentEntityType`, `completedEntityTypes`, `requestParams`, etc.)
+ * that the progress UI renders.
+ */
+export type OnProgress = (percentage: number, message: string, stage: string, extra?: Partial<JobProgress>) => void;
+type JobProgress = components['schemas']['JobProgress'];
+export interface ProcessorResult<R> {
+    annotations: Record<string, unknown>[];
+    result: R;
+}
+export declare function processHighlightJob(content: string, inferenceClient: InferenceClient, params: HighlightDetectionParams, userId: string, generator: Agent, onProgress: OnProgress): Promise<ProcessorResult<HighlightDetectionResult>>;
+export declare function processCommentJob(content: string, inferenceClient: InferenceClient, params: CommentDetectionParams, userId: string, generator: Agent, onProgress: OnProgress): Promise<ProcessorResult<CommentDetectionResult>>;
+export declare function processAssessmentJob(content: string, inferenceClient: InferenceClient, params: AssessmentDetectionParams, userId: string, generator: Agent, onProgress: OnProgress): Promise<ProcessorResult<AssessmentDetectionResult>>;
+export declare function processReferenceJob(content: string, inferenceClient: InferenceClient, params: DetectionParams, userId: string, generator: Agent, onProgress: OnProgress, logger: Logger): Promise<ProcessorResult<DetectionResult>>;
+export declare function processTagJob(content: string, inferenceClient: InferenceClient, params: TagDetectionParams, userId: string, generator: Agent, onProgress: OnProgress): Promise<ProcessorResult<TagDetectionResult>>;
+export declare function processGenerationJob(inferenceClient: InferenceClient, params: GenerationParams, onProgress: OnProgress, logger: Logger): Promise<{
+    content: string;
+    title: string;
+    format: string;
+    result: GenerationResult;
+}>;
+export {};
+//# sourceMappingURL=processors.d.ts.map

package/dist/processors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"processors.d.ts","sourceRoot":"","sources":["../src/processors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAMH,OAAO,EAAc,KAAK,MAAM,EAAmB,KAAK,UAAU,EAAE,MAAM,eAAe,CAAC;AAE1F,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,KAAK,EACV,wBAAwB,EACxB,sBAAsB,EACtB,yBAAyB,EACzB,eAAe,EACf,kBAAkB,EAClB,gBAAgB,EAChB,wBAAwB,EACxB,sBAAsB,EACtB,yBAAyB,EACzB,eAAe,EACf,kBAAkB,EAClB,gBAAgB,EACjB,MAAM,SAAS,CAAC;AAEjB,KAAK,KAAK,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC,OAAO,CAAC,CAAC;AAE5C;;;;;;GAMG;AACH,MAAM,MAAM,UAAU,GAAG,CACvB,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,EACb,KAAK,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,KACzB,IAAI,CAAC;AAEV,KAAK,WAAW,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC,aAAa,CAAC,CAAC;AAExD,MAAM,WAAW,eAAe,CAAC,CAAC;IAChC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;IACvC,MAAM,EAAE,CAAC,CAAC;CACX;AAoDD,wBAAsB,mBAAmB,CACvC,OAAO,EAAE,MAAM,EACf,eAAe,EAAE,eAAe,EAChC,MAAM,EAAE,wBAAwB,EAChC,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,KAAK,EAChB,UAAU,EAAE,UAAU,GACrB,OAAO,CAAC,eAAe,CAAC,wBAAwB,CAAC,CAAC,CAsBpD;AAED,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,MAAM,EACf,eAAe,EAAE,eAAe,EAChC,MAAM,EAAE,sBAAsB,EAC9B,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,KAAK,EAChB,UAAU,EAAE,UAAU,GACrB,OAAO,CAAC,eAAe,CAAC,sBAAsB,CAAC,CAAC,CA8BlD;AAED,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,MAAM,EACf,eAAe,EAAE,eAAe,EAChC,MAAM,EAAE,yBAAyB,EACjC,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,KAAK,EAChB,UAAU,EAAE,UAAU,GACrB,OAAO,CAAC,eAAe,CAAC,yBAAyB,CAAC,CAAC,CA8BrD;AAED,wBAAsB,mBAAmB,CACvC,OAAO,EAAE,MAAM,EACf,eAAe,EAAE,eAAe,EAChC,MAAM,EAAE,eAAe,EACvB,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,KAAK,EAChB,UAAU,EAAE,UAAU,EACtB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,eAAe,CAAC,eAAe,CAAC,CAAC,CAgE3C;AAED,wBAAsB,aAAa,CACjC,OAAO,EAAE,MAAM,EACf,eAAe,EAAE,eAAe,EAChC,MAAM,EAAE,kBAAkB,EAC1B,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,KAAK,EAChB,UAAU,EAAE,UAAU,GACrB,OAAO,CAAC,eAAe,CAAC,kBAAkB,CAAC,CAAC,CAqC9C;AAED,wBAAsB,oBAAoB,CACxC,eAAe,EAAE,eAAe,EAChC,MAAM,EAAE,gBAAgB,EACxB,UAAU,EAAE,UAAU,EACtB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,gBAAgB,CAAA;CAAE,CAAC,CAgCvF"}

package/dist/types.d.ts

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

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

package/dist/worker-main.d.ts

@@ -1,2 +1,22 @@
-
-export {  }
+/**
+ * Worker Pool Main — standalone entry point
+ *
+ * One worker host runs N parallel worker processes, one per distinct
+ * `(inferenceProvider, model)` configured in `~/.semiontconfig`. Each
+ * authenticates with the KS via `/api/tokens/agent` for *its* agent
+ * identity, and that JWT is what the bus stamps onto every event the
+ * process emits — so `_userId` on the bus and the `generator` on every
+ * annotation refer to the same software peer.
+ *
+ * Multiple job types may share an inference engine; in that case they
+ * share a worker process (and an agent identity). Different engines
+ * mean different processes and different agents.
+ *
+ * Environment variables (only two):
+ *   SEMIONT_WORKER_SECRET — shared secret for /api/tokens/agent auth
+ *   ANTHROPIC_API_KEY     — only when using Anthropic inference
+ *
+ * Everything else comes from ~/.semiontconfig.
+ */
+export {};
+//# sourceMappingURL=worker-main.d.ts.map

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

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