@semiont/jobs 0.5.37 → 0.5.39

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { JobId, UserId, UnitCursor, ResourceId, EntityType, JobReferenceAnnotationResult, GenerationJobParams, JobHighlightAnnotationResult, JobAssessmentAnnotationResult, JobCommentAnnotationResult, TagSchema, JobTagAnnotationResult, Logger, EventBus, components, Annotation, SupportedMediaType, GatheredContext } from '@semiont/core';
+import { JobId, UserId, UnitCursor, ResourceId, EntityType, JobReferenceAnnotationResult, GenerationJobParams, JobHighlightAnnotationResult, JobAssessmentAnnotationResult, JobCommentAnnotationResult, TagSchema, JobTagAnnotationResult, Logger, EventBus, components, Annotation, SupportedMediaType, GatheredContext, EventMap } from '@semiont/core';
 import { SemiontState } from '@semiont/core/node';
 import { InferenceClient } from '@semiont/inference';
 
@@ -363,6 +363,15 @@ interface JobQueue {
         cancelled: number;
     }>;
 }
+/**
+ * Every bus channel a queue DRIVER emits, maintained beside the interface
+ * both drivers implement and censused against their sources
+ * (queue-emits-census.test.ts). The gateway's signal bridge forwards these
+ * from its local bus onto the plane — a queue announcement that stays on
+ * the raw bus reaches no worker under a remote driver (the job:queued
+ * starvation, 2026-09-15).
+ */
+declare const JOB_QUEUE_EMITS: readonly ["job:queued"];
 
 /**
  * Job Queue Manager
@@ -546,6 +555,14 @@ declare class FsJobQueue implements JobQueue {
  * handle escapes this file.
  */
 
+/**
+ * The JOBS stream's capture filter — exported as the ONE home of the fact.
+ * A JetStream stream is a server-side subscription: anything published under
+ * these subjects is persisted regardless of which client API produced it.
+ * The signal plane's disjointness gate derives from this export instead of
+ * restating it (SIGNAL-PLANE D3 gate 3).
+ */
+declare const JOBS_STREAM_SUBJECTS: readonly ["jobs.>"];
 interface JetStreamJobQueueOptions {
     /** NATS server address(es), e.g. "192.168.64.42:4222". */
     servers: string | string[];
@@ -1029,6 +1046,26 @@ declare function generateResourceFromTopic(topic: string, entityTypes: string[],
  * guarantee a blocked loop defeats is not one; the janitor is the guarantee.
  */
 declare const STALL_THRESHOLD_MS: number;
+/**
+ * The broadcasts a worker CONSUMES — announcements nobody replies to, which
+ * therefore derive from no operation.
+ *
+ * One home, because the alternative was proven: these lived as `addChannels`
+ * calls beside their consumers, so the worker's complete set existed nowhere
+ * and a widening could be deleted without any list getting shorter. That is
+ * the 2026-09-16 outage — every worker idle on a `job:queued` its transport
+ * would never carry, `lastQueuedEventAt: null`, nothing thrown and nothing
+ * logged.
+ *
+ * An entry here must have a consumer and a consumer must have an entry; the
+ * census beside this file asserts both directions.
+ */
+declare const WORKER_CONSUMED_BROADCASTS: readonly ["job:queued", "job:cancel-requested"];
+/**
+ * The global SSE channel set for a worker's transport: the whole manifest,
+ * stated once and passed at construction. Nothing widens it afterwards.
+ */
+declare const WORKER_CHANNELS: readonly (keyof EventMap)[];
 
-export { AnnotationDetection, FsJobQueue, JetStreamJobQueue, STALL_THRESHOLD_MS, generateResourceFromTopic, isCancelledJob, isCompleteJob, isFailedJob, isPendingJob, isRunningJob, processAssessmentJob, processCommentJob, processGenerationJob, processHighlightJob, processReferenceJob, processTagJob };
+export { AnnotationDetection, FsJobQueue, JOBS_STREAM_SUBJECTS, JOB_QUEUE_EMITS, JetStreamJobQueue, STALL_THRESHOLD_MS, WORKER_CHANNELS, WORKER_CONSUMED_BROADCASTS, generateResourceFromTopic, isCancelledJob, isCompleteJob, isFailedJob, isPendingJob, isRunningJob, processAssessmentJob, processCommentJob, processGenerationJob, processHighlightJob, processReferenceJob, processTagJob };
 export type { AnyJob, AssessmentDetectionJob, AssessmentDetectionParams, AssessmentDetectionProgress, CancelledJob, CommentDetectionJob, CommentDetectionParams, CommentDetectionProgress, CompleteJob, DetectionJob, DetectionParams, DetectionProgress, FailedJob, GenerationJob, GenerationResult, HighlightDetectionJob, HighlightDetectionParams, HighlightDetectionProgress, JetStreamJobQueueOptions, JobMetadata, JobQueryFilters, JobQueue, JobStatus, JobType, OnProgress, PendingJob, ProcessorResult, RunningJob, TagDetectionJob, TagDetectionParams, TagDetectionProgress, YieldProgress };

package/dist/index.js

@@ -12,7 +12,8 @@ import '@semiont/event-sourcing';
 import '@semiont/sdk';
 import '@semiont/http-transport';
 
-// src/fs-job-queue.ts
+// src/job-queue-interface.ts
+var JOB_QUEUE_EMITS = ["job:queued"];
 
 // src/will-retry.ts
 function willRetryAfter(metadata, failureClass) {
@@ -110,7 +111,7 @@ var FsJobQueue = class {
    */
   announce(job) {
     if (this.eventBus && "params" in job && "resourceId" in job.params) {
-      this.eventBus.get("job:queued").next({
+      this.eventBus.emit("job:queued", {
         jobId: job.metadata.id,
         jobType: job.metadata.type,
         resourceId: job.params.resourceId,
@@ -517,6 +518,7 @@ var PROGRESS_WRITE_MIN_INTERVAL_MS2 = 5e3;
 var MAX_CAS_ATTEMPTS = 20;
 var enc = new TextEncoder();
 var dec = new TextDecoder();
+var JOBS_STREAM_SUBJECTS = ["jobs.>"];
 function categoryOf(type) {
   return type === "generation" ? "generation" : "annotation";
 }
@@ -565,7 +567,7 @@ var JetStreamJobQueue = class {
     } catch {
       await this.jsm.streams.add({
         name: STREAM,
-        subjects: ["jobs.>"],
+        subjects: [...JOBS_STREAM_SUBJECTS],
         retention: RetentionPolicy.Workqueue
       });
     }
@@ -671,7 +673,7 @@ var JetStreamJobQueue = class {
   /** Same wire shape as the fs driver: only jobs with a resourceId announce. */
   announce(job) {
     if (this.eventBus && "params" in job && "resourceId" in job.params) {
-      this.eventBus.get("job:queued").next({
+      this.eventBus.emit("job:queued", {
         jobId: job.metadata.id,
         jobType: job.metadata.type,
         resourceId: job.params.resourceId,
@@ -2933,8 +2935,17 @@ var WORKER_AWAITED_OPERATIONS = [
   // rare error path is no reason to let it back in.
   "browse:annotation-requested"
 ];
-replyChannelsFor(WORKER_AWAITED_OPERATIONS);
+var WORKER_CONSUMED_BROADCASTS = [
+  // The queue announcement the claim adapter races for.
+  "job:queued",
+  // Cooperative cancellation of the ACTIVE job (JOB-RESTART-SAFETY P4).
+  "job:cancel-requested"
+];
+var WORKER_CHANNELS = [
+  ...replyChannelsFor(WORKER_AWAITED_OPERATIONS),
+  ...WORKER_CONSUMED_BROADCASTS
+];
 
-export { AnnotationDetection, FsJobQueue, JetStreamJobQueue, STALL_THRESHOLD_MS, generateResourceFromTopic, isCancelledJob, isCompleteJob, isFailedJob, isPendingJob, isRunningJob, processAssessmentJob, processCommentJob, processGenerationJob, processHighlightJob, processReferenceJob, processTagJob };
+export { AnnotationDetection, FsJobQueue, JOBS_STREAM_SUBJECTS, JOB_QUEUE_EMITS, JetStreamJobQueue, STALL_THRESHOLD_MS, WORKER_CHANNELS, WORKER_CONSUMED_BROADCASTS, generateResourceFromTopic, isCancelledJob, isCompleteJob, isFailedJob, isPendingJob, isRunningJob, processAssessmentJob, processCommentJob, processGenerationJob, processHighlightJob, processReferenceJob, processTagJob };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map