@vibesdotdev/workers 0.0.0-stage → 1.0.0-rc.3

package/dist/core/coalesced-enqueue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"coalesced-enqueue.d.ts","sourceRoot":"","sources":["../../src/core/coalesced-enqueue.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEtD,uEAAuE;AACvE,eAAO,MAAM,qBAAqB,gBAAgB,CAAC;AAEnD,gGAAgG;AAChG,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,IAAI,CAAC,WAAW,EAAE,QAAQ,GAAG,UAAU,CAAC,GAAG,IAAI,GAAG,SAAS,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAGhI"}

package/dist/core/coalesced-enqueue.js

@@ -0,0 +1,14 @@
+/**
+ * The coalesced-enqueue rule every queue owner applies in one step (see
+ * `QueueAdapter.enqueueCoalesced`): a job joins an earlier one only while that
+ * job has not started.
+ */
+/** The metadata key a coalesced job carries its coalesce key under. */
+export const COALESCE_METADATA_KEY = 'coalesceKey';
+/** Whether new work under `coalesceKey` joins `job`: it carries the key and has not started. */
+export function joinsCoalescedJob(job, coalesceKey) {
+    if (!job || (job.status !== 'pending' && job.status !== 'delayed'))
+        return false;
+    return job.metadata?.[COALESCE_METADATA_KEY] === coalesceKey;
+}
+//# sourceMappingURL=coalesced-enqueue.js.map

package/dist/core/coalesced-enqueue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"coalesced-enqueue.js","sourceRoot":"","sources":["../../src/core/coalesced-enqueue.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,uEAAuE;AACvE,MAAM,CAAC,MAAM,qBAAqB,GAAG,aAAa,CAAC;AAEnD,gGAAgG;AAChG,MAAM,UAAU,iBAAiB,CAAC,GAAgE,EAAE,WAAmB;IACtH,IAAI,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,KAAK,SAAS,IAAI,GAAG,CAAC,MAAM,KAAK,SAAS,CAAC;QAAE,OAAO,KAAK,CAAC;IACjF,OAAO,GAAG,CAAC,QAAQ,EAAE,CAAC,qBAAqB,CAAC,KAAK,WAAW,CAAC;AAC9D,CAAC"}

package/dist/core/enqueue-metadata.d.ts

@@ -0,0 +1,23 @@
+/**
+ * The retry policy a job is enqueued with, kept on the job's metadata by every
+ * adapter so it survives storage and reaches the runner unchanged.
+ *
+ * `attempts` becomes `metadata.maxAttempts` and `backoff` becomes
+ * `metadata.backoff` as `{ type, delay }` (a bare number is a fixed delay). A
+ * value the caller already set on `metadata` wins, as `maxAttempts` always has.
+ */
+import type { EnqueueOptions } from './queue-adapter.ts';
+import type { JobMetadataRecord } from './schemas/index.ts';
+export declare function stampRetryPolicy(metadata: JobMetadataRecord, options?: Pick<EnqueueOptions, 'attempts' | 'backoff'>): void;
+/**
+ * The delay before the automatic retry that follows failed `attempt` (1-based),
+ * from the policy `stampRetryPolicy` kept on `metadata.backoff`: `fixed` waits
+ * `delay`, `exponential` waits `delay * 2^(attempt - 1)`. No (or a malformed)
+ * policy means an immediate retry.
+ */
+export declare function retryDelayMs(metadata: JobMetadataRecord | undefined, attempt: number): number;
+/** `metadata` for a job requeued for retry: due after `delayMs`, or immediately when it is 0. */
+export declare function withRetryAvailability(metadata: JobMetadataRecord | undefined, delayMs: number, now?: number): JobMetadataRecord;
+/** Whether a job's `metadata.delayedUntil` (if any) has passed. */
+export declare function isDueAt(metadata: JobMetadataRecord | undefined, now: number): boolean;
+//# sourceMappingURL=enqueue-metadata.d.ts.map

package/dist/core/enqueue-metadata.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"enqueue-metadata.d.ts","sourceRoot":"","sources":["../../src/core/enqueue-metadata.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAc5D,wBAAgB,gBAAgB,CAC/B,QAAQ,EAAE,iBAAiB,EAC3B,OAAO,CAAC,EAAE,IAAI,CAAC,cAAc,EAAE,UAAU,GAAG,SAAS,CAAC,GACpD,IAAI,CAQN;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,iBAAiB,GAAG,SAAS,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAK7F;AAED,iGAAiG;AACjG,wBAAgB,qBAAqB,CACpC,QAAQ,EAAE,iBAAiB,GAAG,SAAS,EACvC,OAAO,EAAE,MAAM,EACf,GAAG,GAAE,MAAmB,GACtB,iBAAiB,CAKnB;AAED,mEAAmE;AACnE,wBAAgB,OAAO,CAAC,QAAQ,EAAE,iBAAiB,GAAG,SAAS,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAIrF"}

package/dist/core/enqueue-metadata.js

@@ -0,0 +1,56 @@
+/**
+ * The retry policy a job is enqueued with, kept on the job's metadata by every
+ * adapter so it survives storage and reaches the runner unchanged.
+ *
+ * `attempts` becomes `metadata.maxAttempts` and `backoff` becomes
+ * `metadata.backoff` as `{ type, delay }` (a bare number is a fixed delay). A
+ * value the caller already set on `metadata` wins, as `maxAttempts` always has.
+ */
+import * as z from 'zod/v4';
+/** The retry policy as `stampRetryPolicy` keeps it on `metadata.backoff`; any `type` but `exponential` is a fixed delay. */
+const StoredBackoffSchema = z.object({
+    type: z.unknown().optional(),
+    delay: z.number().positive()
+});
+const DelayedUntilSchema = z.string();
+function isNumber(value) {
+    return typeof value === 'number';
+}
+export function stampRetryPolicy(metadata, options) {
+    if (options?.attempts !== undefined && !isNumber(metadata.maxAttempts)) {
+        metadata.maxAttempts = options.attempts;
+    }
+    const backoff = options?.backoff;
+    if (backoff !== undefined && metadata.backoff === undefined) {
+        metadata.backoff = isNumber(backoff) ? { type: 'fixed', delay: backoff } : { ...backoff };
+    }
+}
+/**
+ * The delay before the automatic retry that follows failed `attempt` (1-based),
+ * from the policy `stampRetryPolicy` kept on `metadata.backoff`: `fixed` waits
+ * `delay`, `exponential` waits `delay * 2^(attempt - 1)`. No (or a malformed)
+ * policy means an immediate retry.
+ */
+export function retryDelayMs(metadata, attempt) {
+    const stored = StoredBackoffSchema.safeParse(metadata?.backoff);
+    if (!stored.success)
+        return 0;
+    const { type, delay } = stored.data;
+    return Math.ceil(type === 'exponential' ? delay * 2 ** Math.max(0, attempt - 1) : delay);
+}
+/** `metadata` for a job requeued for retry: due after `delayMs`, or immediately when it is 0. */
+export function withRetryAvailability(metadata, delayMs, now = Date.now()) {
+    const next = { ...metadata };
+    if (delayMs > 0)
+        next.delayedUntil = new Date(now + delayMs).toISOString();
+    else
+        delete next.delayedUntil;
+    return next;
+}
+/** Whether a job's `metadata.delayedUntil` (if any) has passed. */
+export function isDueAt(metadata, now) {
+    const delayedUntil = DelayedUntilSchema.safeParse(metadata?.delayedUntil);
+    const until = delayedUntil.success ? Date.parse(delayedUntil.data) : NaN;
+    return !Number.isFinite(until) || until <= now;
+}
+//# sourceMappingURL=enqueue-metadata.js.map

package/dist/core/enqueue-metadata.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"enqueue-metadata.js","sourceRoot":"","sources":["../../src/core/enqueue-metadata.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAI5B,4HAA4H;AAC5H,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IACpC,IAAI,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IAC5B,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAC5B,CAAC,CAAC;AAEH,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC;AAEtC,SAAS,QAAQ,CAAC,KAAc;IAC/B,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC;AAClC,CAAC;AAED,MAAM,UAAU,gBAAgB,CAC/B,QAA2B,EAC3B,OAAsD;IAEtD,IAAI,OAAO,EAAE,QAAQ,KAAK,SAAS,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC;QACxE,QAAQ,CAAC,WAAW,GAAG,OAAO,CAAC,QAAQ,CAAC;IACzC,CAAC;IACD,MAAM,OAAO,GAAG,OAAO,EAAE,OAAO,CAAC;IACjC,IAAI,OAAO,KAAK,SAAS,IAAI,QAAQ,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;QAC7D,QAAQ,CAAC,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,OAAO,EAAE,CAAC;IAC3F,CAAC;AACF,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,YAAY,CAAC,QAAuC,EAAE,OAAe;IACpF,MAAM,MAAM,GAAG,mBAAmB,CAAC,SAAS,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAChE,IAAI,CAAC,MAAM,CAAC,OAAO;QAAE,OAAO,CAAC,CAAC;IAC9B,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,MAAM,CAAC,IAAI,CAAC;IACpC,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,KAAK,aAAa,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;AAC1F,CAAC;AAED,iGAAiG;AACjG,MAAM,UAAU,qBAAqB,CACpC,QAAuC,EACvC,OAAe,EACf,MAAc,IAAI,CAAC,GAAG,EAAE;IAExB,MAAM,IAAI,GAAsB,EAAE,GAAG,QAAQ,EAAE,CAAC;IAChD,IAAI,OAAO,GAAG,CAAC;QAAE,IAAI,CAAC,YAAY,GAAG,IAAI,IAAI,CAAC,GAAG,GAAG,OAAO,CAAC,CAAC,WAAW,EAAE,CAAC;;QACtE,OAAO,IAAI,CAAC,YAAY,CAAC;IAC9B,OAAO,IAAI,CAAC;AACb,CAAC;AAED,mEAAmE;AACnE,MAAM,UAAU,OAAO,CAAC,QAAuC,EAAE,GAAW;IAC3E,MAAM,YAAY,GAAG,kBAAkB,CAAC,SAAS,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC;IAC1E,MAAM,KAAK,GAAG,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;IACzE,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,GAAG,CAAC;AAChD,CAAC"}

package/dist/core/errors.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Error Classification System
+ *
+ * Standardizes error handling and retry logic across all workers.
+ * Categorizes errors as retryable, permanent, rate_limit, or resource_exhausted.
+ */
+import type { ErrorCategory, ErrorClassifier } from './schemas/index.ts';
+export type { ErrorCategory, ErrorClassifier };
+/**
+ * Standard error classifier with common patterns
+ */
+export declare class StandardErrorClassifier implements ErrorClassifier {
+    categorize(error: Error): ErrorCategory;
+    protected isNetworkError(error: Error): boolean;
+    protected isRateLimitError(error: Error): boolean;
+    protected isResourceExhausted(error: Error): boolean;
+    protected isPermanentError(error: Error): boolean;
+}
+/**
+ * Knowledge worker error classifier (browser/scraping specific)
+ */
+export declare class KnowledgeErrorClassifier extends StandardErrorClassifier {
+    categorize(error: Error): ErrorCategory;
+}
+/**
+ * AI/Generation worker error classifier
+ */
+export declare class AIErrorClassifier extends StandardErrorClassifier {
+    categorize(error: Error): ErrorCategory;
+}
+/**
+ * Helper to get appropriate error classifier for worker type
+ */
+export declare function getErrorClassifier(workerType?: string): ErrorClassifier;
+//# sourceMappingURL=errors.d.ts.map

package/dist/core/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/core/errors.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACzE,YAAY,EAAE,aAAa,EAAE,eAAe,EAAE,CAAC;AAE/C;;GAEG;AACH,qBAAa,uBAAwB,YAAW,eAAe;IAC9D,UAAU,CAAC,KAAK,EAAE,KAAK,GAAG,aAAa;IAwDvC,SAAS,CAAC,cAAc,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO;IAI/C,SAAS,CAAC,gBAAgB,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO;IAIjD,SAAS,CAAC,mBAAmB,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO;IAIpD,SAAS,CAAC,gBAAgB,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO;CAKjD;AAED;;GAEG;AACH,qBAAa,wBAAyB,SAAQ,uBAAuB;IACpE,UAAU,CAAC,KAAK,EAAE,KAAK,GAAG,aAAa;CAqCvC;AAED;;GAEG;AACH,qBAAa,iBAAkB,SAAQ,uBAAuB;IAC7D,UAAU,CAAC,KAAK,EAAE,KAAK,GAAG,aAAa;CA+CvC;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,eAAe,CAgBvE"}

package/dist/core/errors.js

@@ -0,0 +1,177 @@
+/**
+ * Error Classification System
+ *
+ * Standardizes error handling and retry logic across all workers.
+ * Categorizes errors as retryable, permanent, rate_limit, or resource_exhausted.
+ */
+/**
+ * Standard error classifier with common patterns
+ */
+export class StandardErrorClassifier {
+    categorize(error) {
+        const _message = error.message.toLowerCase();
+        // Network errors (retryable)
+        if (this.isNetworkError(error)) {
+            return {
+                type: 'retryable',
+                severity: 'low',
+                retryAfter: 5000,
+                maxRetries: 3,
+                metadata: { category: 'network' }
+            };
+        }
+        // Rate limits
+        if (this.isRateLimitError(error)) {
+            return {
+                type: 'rate_limit',
+                severity: 'low',
+                retryAfter: 30000,
+                maxRetries: 5,
+                metadata: { category: 'rate_limit' }
+            };
+        }
+        // Resource exhaustion
+        if (this.isResourceExhausted(error)) {
+            return {
+                type: 'resource_exhausted',
+                severity: 'medium',
+                retryAfter: 10000,
+                maxRetries: 3,
+                metadata: { category: 'resource' }
+            };
+        }
+        // Permanent errors
+        if (this.isPermanentError(error)) {
+            return {
+                type: 'permanent',
+                severity: 'medium',
+                maxRetries: 0,
+                metadata: { category: 'permanent' }
+            };
+        }
+        // Default: retryable
+        return {
+            type: 'retryable',
+            severity: 'medium',
+            retryAfter: 5000,
+            maxRetries: 3,
+            metadata: { category: 'unknown' }
+        };
+    }
+    isNetworkError(error) {
+        return /network|econnrefused|enotfound|socket|connect|dns|etimedout/i.test(error.message);
+    }
+    isRateLimitError(error) {
+        return /429|rate limit|throttle|quota exceeded|too many requests/i.test(error.message);
+    }
+    isResourceExhausted(error) {
+        return /timeout|resource|memory|cpu|emfile|enfile|too many files/i.test(error.message);
+    }
+    isPermanentError(error) {
+        return /400|401|403|404|invalid|malformed|unauthorized|forbidden|not found/i.test(error.message);
+    }
+}
+/**
+ * Knowledge worker error classifier (browser/scraping specific)
+ */
+export class KnowledgeErrorClassifier extends StandardErrorClassifier {
+    categorize(error) {
+        const message = error.message.toLowerCase();
+        // Browser-specific errors
+        if (/navigation timeout|browser|playwright|puppeteer/i.test(message)) {
+            return {
+                type: 'resource_exhausted',
+                severity: 'medium',
+                retryAfter: 10000,
+                maxRetries: 3,
+                metadata: { category: 'browser' }
+            };
+        }
+        // DNS/Domain errors (permanent)
+        if (/dns_probe_finished_nxdomain|err_name_not_resolved/i.test(message)) {
+            return {
+                type: 'permanent',
+                severity: 'low',
+                maxRetries: 0,
+                metadata: { category: 'dns' }
+            };
+        }
+        // SSL/Certificate errors (permanent)
+        if (/ssl_error|cert_|certificate/i.test(message)) {
+            return {
+                type: 'permanent',
+                severity: 'medium',
+                maxRetries: 0,
+                metadata: { category: 'ssl' }
+            };
+        }
+        // Fall back to standard classification
+        return super.categorize(error);
+    }
+}
+/**
+ * AI/Generation worker error classifier
+ */
+export class AIErrorClassifier extends StandardErrorClassifier {
+    categorize(error) {
+        const message = error.message.toLowerCase();
+        // Model-specific rate limits (longer backoff)
+        if (/model|anthropic|openai/i.test(message) && this.isRateLimitError(error)) {
+            return {
+                type: 'rate_limit',
+                severity: 'low',
+                retryAfter: 60000,
+                maxRetries: 5,
+                metadata: { category: 'model_rate_limit' }
+            };
+        }
+        // Model timeouts (retryable)
+        if (/model/.test(message) && /timeout|timed out|etimedout/.test(message)) {
+            return {
+                type: 'retryable',
+                severity: 'medium',
+                retryAfter: 10000,
+                maxRetries: 3,
+                metadata: { category: 'model_timeout' }
+            };
+        }
+        // Content policy violations (permanent)
+        if (/content policy|unsafe|filtered|moderation/i.test(message)) {
+            return {
+                type: 'permanent',
+                severity: 'high',
+                maxRetries: 0,
+                metadata: { category: 'content_policy' }
+            };
+        }
+        // Context length errors (permanent - need to truncate)
+        if (/context length|token limit|too long/i.test(message)) {
+            return {
+                type: 'permanent',
+                severity: 'medium',
+                maxRetries: 0,
+                metadata: { category: 'context_length' }
+            };
+        }
+        return super.categorize(error);
+    }
+}
+/**
+ * Helper to get appropriate error classifier for worker type
+ */
+export function getErrorClassifier(workerType) {
+    switch (workerType) {
+        case 'knowledge':
+        case 'crawl':
+        case 'scan':
+            return new KnowledgeErrorClassifier();
+        case 'ai':
+        case 'generation':
+        case 'text-generation':
+        case 'image-generation':
+            return new AIErrorClassifier();
+        default:
+            return new StandardErrorClassifier();
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/core/errors.js.map

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

package/dist/core/events.d.ts

@@ -0,0 +1,93 @@
+/**
+ * Provider-neutral worker event contracts.
+ *
+ * A host supplies the event sink. Framework does not select Kafka, Cloudflare,
+ * or another transport.
+ */
+import * as z from 'zod/v4';
+import type { JsonValue } from '@vibesdotdev/kernel/schemas/json';
+import type { ToolEventEnvelope } from '@vibesdotdev/tools/schemas/types';
+import type { Job as QueueJob } from './queue-adapter.ts';
+import type { JobEventMetadataOptions, JobProgressValue, JobStateChangeData } from './schemas/index.ts';
+type EventEmitterJob<TJob = unknown> = Pick<QueueJob<TJob>, 'id'> & {
+    updateProgress?: (progress: JobProgressValue) => Promise<void>;
+};
+export declare const jobProgressEventSchema: z.ZodObject<{
+    type: z.ZodLiteral<"job.progress">;
+    jobId: z.ZodString;
+    workerId: z.ZodString;
+    queueName: z.ZodString;
+    progress: z.ZodUnion<readonly [z.ZodNumber, z.ZodRecord<z.ZodString, z.ZodUnknown>]>;
+    timestamp: z.ZodISODateTime;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strip>;
+export declare const consumerEventSchema: z.ZodObject<{
+    type: z.ZodString;
+    jobId: z.ZodString;
+    workerId: z.ZodString;
+    queueName: z.ZodString;
+    timestamp: z.ZodISODateTime;
+    payload: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+}, z.core.$strip>;
+export declare const jobStateEventSchema: z.ZodObject<{
+    type: z.ZodEnum<{
+        "job.started": "job.started";
+        "job.completed": "job.completed";
+        "job.failed": "job.failed";
+        "job.stalled": "job.stalled";
+    }>;
+    jobId: z.ZodString;
+    workerId: z.ZodString;
+    queueName: z.ZodString;
+    timestamp: z.ZodISODateTime;
+    state: z.ZodString;
+    error: z.ZodOptional<z.ZodString>;
+    result: z.ZodOptional<z.ZodUnknown>;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strip>;
+export type JobProgressEvent = z.infer<typeof jobProgressEventSchema>;
+export type ConsumerEvent = z.infer<typeof consumerEventSchema>;
+export type JobStateEvent = z.infer<typeof jobStateEventSchema>;
+interface ToolEnvelopeEvent {
+    type: 'tool.event';
+    jobId: string;
+    jobType: string;
+    workerId: string;
+    queueName: string;
+    timestamp: string;
+    envelope: ToolEventEnvelope;
+    metadata?: Record<string, JsonValue>;
+}
+export type WorkerEvent = JobProgressEvent | ConsumerEvent | JobStateEvent | ToolEnvelopeEvent;
+interface JobEventEmitterInternal {
+    emitProgress(progress: JobProgressValue, metadata?: Record<string, JsonValue>): Promise<void>;
+    emitConsumerEvent(eventType: string, payload: Record<string, JsonValue>): Promise<void>;
+    emitToolEvent(envelope: ToolEventEnvelope, options?: JobEventMetadataOptions): Promise<void>;
+    emitStateChange(state: 'started' | 'completed' | 'failed' | 'stalled', data?: JobStateChangeData): Promise<void>;
+    observeStall(metadata?: Record<string, JsonValue>): Promise<void>;
+    resetStallWindow(): void;
+}
+export type WorkerEventSink = (event: WorkerEvent) => void | Promise<void>;
+export declare class WorkerEventRouter {
+    private readonly workerId;
+    private readonly queueName;
+    private readonly sink;
+    constructor(workerId: string, queueName: string, sinkOrDisabled?: WorkerEventSink | boolean);
+    routeProgressEvent(jobId: string, progress: JobProgressValue, metadata?: Record<string, JsonValue>): Promise<void>;
+    routeConsumerEvent(jobId: string, eventType: string, payload: Record<string, JsonValue>): Promise<void>;
+    routeToolEvent(jobId: string, envelopeInput: ToolEventEnvelope, metadata?: Record<string, JsonValue>): Promise<void>;
+    routeStateEvent(jobId: string, state: 'started' | 'completed' | 'failed' | 'stalled', data?: JobStateChangeData): Promise<void>;
+    private emit;
+}
+export declare const DEFAULT_JOB_STALL_THRESHOLD_MS = 30000;
+export interface JobEventEmitterOptions {
+    /** Elapsed milliseconds without non-waiting progress or metadata advancement before emitting `job.stalled` (default: 30_000). */
+    stallThresholdMs?: number;
+    /** Monotonic or wall clock in milliseconds used to measure unadvanced progress duration. */
+    now?: () => number;
+    /** Lifecycle predicate reporting whether the executing job is currently parked or awaiting a resume slot. */
+    isParked?: () => boolean;
+}
+export declare function createJobEventEmitter<TJob = unknown>(job: EventEmitterJob<TJob>, router: WorkerEventRouter, options?: JobEventEmitterOptions): JobEventEmitterInternal;
+export {};
+//# sourceMappingURL=events.d.ts.map

package/dist/core/events.d.ts.map

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

package/dist/core/events.js

@@ -0,0 +1,182 @@
+/**
+ * Provider-neutral worker event contracts.
+ *
+ * A host supplies the event sink. Framework does not select Kafka, Cloudflare,
+ * or another transport.
+ */
+import * as z from 'zod/v4';
+async function getToolEventEnvelopeSchema() {
+    const { toolEventEnvelopeSchema } = await import('@vibesdotdev/tools/schemas/types');
+    return toolEventEnvelopeSchema;
+}
+export const jobProgressEventSchema = z.object({
+    type: z.literal('job.progress'),
+    jobId: z.string(),
+    workerId: z.string(),
+    queueName: z.string(),
+    progress: z.union([z.number().min(0).max(100), z.record(z.string(), z.unknown())]),
+    timestamp: z.iso.datetime(),
+    metadata: z.record(z.string(), z.unknown()).optional()
+});
+export const consumerEventSchema = z.object({
+    type: z.string(),
+    jobId: z.string(),
+    workerId: z.string(),
+    queueName: z.string(),
+    timestamp: z.iso.datetime(),
+    payload: z.record(z.string(), z.unknown())
+});
+export const jobStateEventSchema = z.object({
+    type: z.enum(['job.started', 'job.completed', 'job.failed', 'job.stalled']),
+    jobId: z.string(),
+    workerId: z.string(),
+    queueName: z.string(),
+    timestamp: z.iso.datetime(),
+    state: z.string(),
+    error: z.string().optional(),
+    result: z.unknown().optional(),
+    metadata: z.record(z.string(), z.unknown()).optional()
+});
+/** Whether the router was handed a sink (`true`/`false` only say enabled or disabled, with no sink to call). */
+function isEventSink(value) {
+    return typeof value === 'function';
+}
+export class WorkerEventRouter {
+    workerId;
+    queueName;
+    sink;
+    constructor(workerId, queueName, sinkOrDisabled = true) {
+        this.workerId = workerId;
+        this.queueName = queueName;
+        this.sink = isEventSink(sinkOrDisabled) ? sinkOrDisabled : null;
+    }
+    async routeProgressEvent(jobId, progress, metadata) {
+        await this.emit({
+            type: 'job.progress',
+            jobId,
+            workerId: this.workerId,
+            queueName: this.queueName,
+            progress,
+            timestamp: new Date().toISOString(),
+            metadata
+        });
+    }
+    async routeConsumerEvent(jobId, eventType, payload) {
+        await this.emit({
+            type: eventType,
+            jobId,
+            workerId: this.workerId,
+            queueName: this.queueName,
+            timestamp: new Date().toISOString(),
+            payload
+        });
+    }
+    async routeToolEvent(jobId, envelopeInput, metadata) {
+        const envelope = await getToolEventEnvelopeSchema().then((schema) => schema.parse(envelopeInput));
+        await this.emit({
+            type: 'tool.event',
+            jobId,
+            jobType: this.queueName,
+            workerId: this.workerId,
+            queueName: this.queueName,
+            timestamp: new Date().toISOString(),
+            envelope,
+            metadata
+        });
+    }
+    async routeStateEvent(jobId, state, data) {
+        const event = {
+            type: `job.${state}`,
+            jobId,
+            workerId: this.workerId,
+            queueName: this.queueName,
+            timestamp: new Date().toISOString(),
+            state,
+            error: data?.error,
+            result: data?.result,
+            metadata: data?.metadata
+        };
+        await this.emit(event);
+    }
+    async emit(event) {
+        await this.sink?.(event);
+    }
+}
+export const DEFAULT_JOB_STALL_THRESHOLD_MS = 30_000;
+function buildActivitySignature(progress, metadata) {
+    if (!metadata)
+        return JSON.stringify({ progress, metadata: null });
+    const sortedKeys = Object.keys(metadata).sort();
+    const normalizedMetadata = sortedKeys.length > 0
+        ? Object.fromEntries(sortedKeys.map((key) => [key, metadata[key]]))
+        : null;
+    return JSON.stringify({ progress, metadata: normalizedMetadata });
+}
+export function createJobEventEmitter(job, router, options = {}) {
+    const jobId = job.id;
+    const stallThresholdMs = options.stallThresholdMs ?? DEFAULT_JOB_STALL_THRESHOLD_MS;
+    const now = options.now ?? (() => Date.now());
+    let lastActivity;
+    let lastMetadata;
+    let lastAdvancedAt = now();
+    let stalledSinceAdvance = false;
+    return {
+        async emitProgress(progress, metadata) {
+            const timestampMs = now();
+            const currentActivity = buildActivitySignature(progress, metadata);
+            const parked = options.isParked?.() === true;
+            const unadvanced = lastActivity !== undefined && lastActivity === currentActivity;
+            const stalled = !parked &&
+                !stalledSinceAdvance &&
+                unadvanced &&
+                timestampMs - lastAdvancedAt >= stallThresholdMs;
+            if (!unadvanced || parked) {
+                lastAdvancedAt = timestampMs;
+                stalledSinceAdvance = false;
+            }
+            lastActivity = currentActivity;
+            if (metadata !== undefined)
+                lastMetadata = metadata;
+            if (job.updateProgress)
+                await job.updateProgress(progress);
+            await router.routeProgressEvent(jobId, progress, metadata);
+            if (stalled) {
+                stalledSinceAdvance = true;
+                await this.emitStateChange('stalled', { metadata: metadata ?? lastMetadata });
+            }
+        },
+        async emitConsumerEvent(eventType, payload) {
+            lastAdvancedAt = now();
+            stalledSinceAdvance = false;
+            await router.routeConsumerEvent(jobId, eventType, payload);
+        },
+        async emitToolEvent(envelope, options) {
+            lastAdvancedAt = now();
+            stalledSinceAdvance = false;
+            const schema = await getToolEventEnvelopeSchema();
+            await router.routeToolEvent(jobId, schema.parse(envelope), options?.metadata);
+        },
+        async emitStateChange(state, data) {
+            await router.routeStateEvent(jobId, state, data);
+        },
+        async observeStall(metadata) {
+            const timestampMs = now();
+            if (metadata !== undefined)
+                lastMetadata = metadata;
+            if (options.isParked?.() === true) {
+                lastAdvancedAt = timestampMs;
+                stalledSinceAdvance = false;
+                return;
+            }
+            if (!stalledSinceAdvance && timestampMs - lastAdvancedAt >= stallThresholdMs) {
+                stalledSinceAdvance = true;
+                await this.emitStateChange('stalled', { metadata: metadata ?? lastMetadata });
+            }
+        },
+        resetStallWindow() {
+            lastAdvancedAt = now();
+            stalledSinceAdvance = false;
+        }
+    };
+}
+//# sourceMappingURL=events.js.map

package/dist/core/events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../../src/core/events.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAM5B,KAAK,UAAU,0BAA0B;IACxC,MAAM,EAAE,uBAAuB,EAAE,GAAG,MAAM,MAAM,CAAC,kCAAkC,CAAC,CAAC;IACrF,OAAO,uBAAuB,CAAC;AAChC,CAAC;AAMD,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC9C,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,cAAc,CAAC;IAC/B,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;IACjB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;IACpB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;IACrB,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;IAClF,SAAS,EAAE,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE;IAC3B,QAAQ,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,EAAE;CACtD,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3C,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;IACjB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;IACpB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;IACrB,SAAS,EAAE,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE;IAC3B,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC;CAC1C,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3C,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,aAAa,EAAE,eAAe,EAAE,YAAY,EAAE,aAAa,CAAC,CAAC;IAC3E,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;IACjB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;IACpB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;IACrB,SAAS,EAAE,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE;IAC3B,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;IACjB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC5B,MAAM,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IAC9B,QAAQ,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,EAAE;CACtD,CAAC,CAAC;AA8BH,gHAAgH;AAChH,SAAS,WAAW,CAAC,KAAgC;IACpD,OAAO,OAAO,KAAK,KAAK,UAAU,CAAC;AACpC,CAAC;AAED,MAAM,OAAO,iBAAiB;IAIX;IACA;IAJD,IAAI,CAAyB;IAE9C,YACkB,QAAgB,EAChB,SAAiB,EAClC,iBAA4C,IAAI;QAF/B,aAAQ,GAAR,QAAQ,CAAQ;QAChB,cAAS,GAAT,SAAS,CAAQ;QAGlC,IAAI,CAAC,IAAI,GAAG,WAAW,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,IAAI,CAAC;IACjE,CAAC;IAED,KAAK,CAAC,kBAAkB,CACvB,KAAa,EACb,QAA0B,EAC1B,QAAoC;QAEpC,MAAM,IAAI,CAAC,IAAI,CAAC;YACf,IAAI,EAAE,cAAc;YACpB,KAAK;YACL,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,QAAQ;YACR,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACnC,QAAQ;SACR,CAAC,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,kBAAkB,CAAC,KAAa,EAAE,SAAiB,EAAE,OAAkC;QAC5F,MAAM,IAAI,CAAC,IAAI,CAAC;YACf,IAAI,EAAE,SAAS;YACf,KAAK;YACL,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACnC,OAAO;SACP,CAAC,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,cAAc,CAAC,KAAa,EAAE,aAAgC,EAAE,QAAoC;QACzG,MAAM,QAAQ,GAAG,MAAM,0BAA0B,EAAE,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC;QAClG,MAAM,IAAI,CAAC,IAAI,CAAC;YACf,IAAI,EAAE,YAAY;YAClB,KAAK;YACL,OAAO,EAAE,IAAI,CAAC,SAAS;YACvB,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACnC,QAAQ;YACR,QAAQ;SACR,CAAC,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,eAAe,CACpB,KAAa,EACb,KAAqD,EACrD,IAAyB;QAEzB,MAAM,KAAK,GAAkB;YAC5B,IAAI,EAAE,OAAO,KAAK,EAAE;YACpB,KAAK;YACL,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACnC,KAAK;YACL,KAAK,EAAE,IAAI,EAAE,KAAK;YAClB,MAAM,EAAE,IAAI,EAAE,MAAM;YACpB,QAAQ,EAAE,IAAI,EAAE,QAAQ;SACxB,CAAC;QACF,MAAM,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACxB,CAAC;IAEO,KAAK,CAAC,IAAI,CAAC,KAAkB;QACpC,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC;IAC1B,CAAC;CACD;AAED,MAAM,CAAC,MAAM,8BAA8B,GAAG,MAAM,CAAC;AAWrD,SAAS,sBAAsB,CAC9B,QAA0B,EAC1B,QAAoC;IAEpC,IAAI,CAAC,QAAQ;QAAE,OAAO,IAAI,CAAC,SAAS,CAAC,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;IACnE,MAAM,UAAU,GAAG,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,IAAI,EAAE,CAAC;IAChD,MAAM,kBAAkB,GACvB,UAAU,CAAC,MAAM,GAAG,CAAC;QACpB,CAAC,CAAC,MAAM,CAAC,WAAW,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,GAAG,EAAE,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QACnE,CAAC,CAAC,IAAI,CAAC;IACT,OAAO,IAAI,CAAC,SAAS,CAAC,EAAE,QAAQ,EAAE,QAAQ,EAAE,kBAAkB,EAAE,CAAC,CAAC;AACnE,CAAC;AAED,MAAM,UAAU,qBAAqB,CACpC,GAA0B,EAC1B,MAAyB,EACzB,UAAkC,EAAE;IAEpC,MAAM,KAAK,GAAG,GAAG,CAAC,EAAE,CAAC;IACrB,MAAM,gBAAgB,GAAG,OAAO,CAAC,gBAAgB,IAAI,8BAA8B,CAAC;IACpF,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;IAC9C,IAAI,YAAgC,CAAC;IACrC,IAAI,YAAmD,CAAC;IACxD,IAAI,cAAc,GAAW,GAAG,EAAE,CAAC;IACnC,IAAI,mBAAmB,GAAG,KAAK,CAAC;IAEhC,OAAO;QACN,KAAK,CAAC,YAAY,CAAC,QAAQ,EAAE,QAAQ;YACpC,MAAM,WAAW,GAAG,GAAG,EAAE,CAAC;YAC1B,MAAM,eAAe,GAAG,sBAAsB,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;YACnE,MAAM,MAAM,GAAG,OAAO,CAAC,QAAQ,EAAE,EAAE,KAAK,IAAI,CAAC;YAC7C,MAAM,UAAU,GAAG,YAAY,KAAK,SAAS,IAAI,YAAY,KAAK,eAAe,CAAC;YAClF,MAAM,OAAO,GACZ,CAAC,MAAM;gBACP,CAAC,mBAAmB;gBACpB,UAAU;gBACV,WAAW,GAAG,cAAc,IAAI,gBAAgB,CAAC;YAClD,IAAI,CAAC,UAAU,IAAI,MAAM,EAAE,CAAC;gBAC3B,cAAc,GAAG,WAAW,CAAC;gBAC7B,mBAAmB,GAAG,KAAK,CAAC;YAC7B,CAAC;YACD,YAAY,GAAG,eAAe,CAAC;YAC/B,IAAI,QAAQ,KAAK,SAAS;gBAAE,YAAY,GAAG,QAAQ,CAAC;YACpD,IAAI,GAAG,CAAC,cAAc;gBAAE,MAAM,GAAG,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC;YAC3D,MAAM,MAAM,CAAC,kBAAkB,CAAC,KAAK,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC;YAC3D,IAAI,OAAO,EAAE,CAAC;gBACb,mBAAmB,GAAG,IAAI,CAAC;gBAC3B,MAAM,IAAI,CAAC,eAAe,CAAC,SAAS,EAAE,EAAE,QAAQ,EAAE,QAAQ,IAAI,YAAY,EAAE,CAAC,CAAC;YAC/E,CAAC;QACF,CAAC;QACD,KAAK,CAAC,iBAAiB,CAAC,SAAS,EAAE,OAAO;YACzC,cAAc,GAAG,GAAG,EAAE,CAAC;YACvB,mBAAmB,GAAG,KAAK,CAAC;YAC5B,MAAM,MAAM,CAAC,kBAAkB,CAAC,KAAK,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;QAC5D,CAAC;QACD,KAAK,CAAC,aAAa,CAAC,QAAQ,EAAE,OAAO;YACpC,cAAc,GAAG,GAAG,EAAE,CAAC;YACvB,mBAAmB,GAAG,KAAK,CAAC;YAC5B,MAAM,MAAM,GAAG,MAAM,0BAA0B,EAAE,CAAC;YAClD,MAAM,MAAM,CAAC,cAAc,CAAC,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC;QAC/E,CAAC;QACD,KAAK,CAAC,eAAe,CAAC,KAAK,EAAE,IAAI;YAChC,MAAM,MAAM,CAAC,eAAe,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC;QAClD,CAAC;QACD,KAAK,CAAC,YAAY,CAAC,QAAQ;YAC1B,MAAM,WAAW,GAAG,GAAG,EAAE,CAAC;YAC1B,IAAI,QAAQ,KAAK,SAAS;gBAAE,YAAY,GAAG,QAAQ,CAAC;YACpD,IAAI,OAAO,CAAC,QAAQ,EAAE,EAAE,KAAK,IAAI,EAAE,CAAC;gBACnC,cAAc,GAAG,WAAW,CAAC;gBAC7B,mBAAmB,GAAG,KAAK,CAAC;gBAC5B,OAAO;YACR,CAAC;YACD,IAAI,CAAC,mBAAmB,IAAI,WAAW,GAAG,cAAc,IAAI,gBAAgB,EAAE,CAAC;gBAC9E,mBAAmB,GAAG,IAAI,CAAC;gBAC3B,MAAM,IAAI,CAAC,eAAe,CAAC,SAAS,EAAE,EAAE,QAAQ,EAAE,QAAQ,IAAI,YAAY,EAAE,CAAC,CAAC;YAC/E,CAAC;QACF,CAAC;QACD,gBAAgB;YACf,cAAc,GAAG,GAAG,EAAE,CAAC;YACvB,mBAAmB,GAAG,KAAK,CAAC;QAC7B,CAAC;KACD,CAAC;AACH,CAAC"}