@semiont/jobs 0.5.13 → 0.5.15

package/dist/index.d.ts

@@ -691,5 +691,37 @@ declare function generateResourceFromTopic(topic: string, entityTypes: string[],
     content: string;
 }>;
 
-export { AnnotationDetection, FsJobQueue, generateResourceFromTopic, isCancelledJob, isCompleteJob, isFailedJob, isPendingJob, isRunningJob, processAssessmentJob, processCommentJob, processGenerationJob, processHighlightJob, processReferenceJob, processTagJob };
+/**
+ * Worker Runtime — the importable half of the worker host.
+ *
+ * `worker-main.ts` is a process entrypoint (config at module scope,
+ * `main()` at import) and therefore untestable by construction; everything
+ * a unit test needs to reach lives here instead, fully parameterized — no
+ * module-scope env reads, no side effects at import.
+ *
+ * The load-bearing contract this module owns (and the reason it was
+ * extracted): a worker's stamped identity is the DID the
+ * `/api/tokens/agent` exchange MINTED for it, carried verbatim — never
+ * re-derived from the URL the worker happens to dial. One logical agent
+ * previously got two DIDs that way (.plans/bugs/agent-did-host-skew.md).
+ */
+
+/**
+ * Stall watchdog (WORKER-LIVENESS.md P3) — the fail-fast line behind the
+ * inference timeout. There is no poll loop to heartbeat; the honest
+ * stall signal in this push-driven architecture is *processing without
+ * activity*: an agent holding a claimed job whose `lastActivityAt`
+ * (claim / progress / finish) has stopped advancing is wedged — the
+ * adapter ignores every announcement while `isProcessing`, so a wedged
+ * agent never recovers on its own. Silent hang → loud crash → whatever
+ * restart policy the deployment chose.
+ *
+ * Thresholds are fixed by design (no env knobs) and deliberately
+ * layered: inference timeout (10 min, P2) fires first; this watchdog
+ * (15 min) catches the failure modes nobody predicted; the backend's
+ * dead-worker janitor (30 min) re-queues the job regardless.
+ */
+declare const STALL_THRESHOLD_MS: number;
+
+export { AnnotationDetection, FsJobQueue, STALL_THRESHOLD_MS, generateResourceFromTopic, isCancelledJob, isCompleteJob, isFailedJob, isPendingJob, isRunningJob, processAssessmentJob, processCommentJob, processGenerationJob, processHighlightJob, processReferenceJob, processTagJob };
 export type { AnyJob, AssessmentDetectionJob, AssessmentDetectionParams, AssessmentDetectionProgress, AssessmentDetectionResult, CancelledJob, CommentDetectionJob, CommentDetectionParams, CommentDetectionProgress, CommentDetectionResult, CompleteJob, DetectionJob, DetectionParams, DetectionProgress, DetectionResult, FailedJob, GenerationJob, GenerationParams, GenerationResult, HighlightDetectionJob, HighlightDetectionParams, HighlightDetectionProgress, HighlightDetectionResult, JobMetadata, JobQueryFilters, JobQueue, JobStatus, JobType, OnProgress, PendingJob, ProcessorResult, RunningJob, TagDetectionJob, TagDetectionParams, TagDetectionProgress, TagDetectionResult, YieldProgress };

package/dist/index.js

@@ -2,6 +2,10 @@ import { promises } from 'fs';
 import * as path from 'path';
 import { jobId, deriveViews, reconcileSelector, isObject, isString, getLocaleEnglishName, didToAgent, isArray } from '@semiont/core';
 import { generateAnnotationId } from '@semiont/event-sourcing';
+import '@semiont/content';
+import '@semiont/observability';
+import '@semiont/sdk';
+import '@semiont/http-transport';
 
 // src/fs-job-queue.ts
 var REANNOUNCE_INTERVAL_MS = 3e4;
@@ -1697,7 +1701,8 @@ async function processGenerationJob(inferenceClient, params, onProgress, logger)
     }
   };
 }
+var STALL_THRESHOLD_MS = 15 * 6e4;
 
-export { AnnotationDetection, FsJobQueue, generateResourceFromTopic, isCancelledJob, isCompleteJob, isFailedJob, isPendingJob, isRunningJob, processAssessmentJob, processCommentJob, processGenerationJob, processHighlightJob, processReferenceJob, processTagJob };
+export { AnnotationDetection, FsJobQueue, STALL_THRESHOLD_MS, generateResourceFromTopic, isCancelledJob, isCompleteJob, isFailedJob, isPendingJob, isRunningJob, processAssessmentJob, processCommentJob, processGenerationJob, processHighlightJob, processReferenceJob, processTagJob };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map