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

package/dist/runtime/surface.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Worker runtime surface semantics.
+ *
+ * The executable host owns environment registration, plugin composition and
+ * the declared scope — hardware and hosting included. Workers never chooses
+ * or defaults hardware: a worker host serves the hardware its host declared.
+ * `workers serve` is a serve command (rc02-rc03 §2.3): the CLI boots its host
+ * through the one entry, declared `surface: 'worker'`, `purpose: 'worker'`,
+ * before the action runs, so nothing here re-scopes a runtime.
+ */
+import type { RuntimeHardware } from '@vibesdotdev/kernel';
+/** The execution ABI a worker host serves: always the declared `scope.hardware`. */
+export type WorkerTarget = RuntimeHardware;
+//# sourceMappingURL=surface.d.ts.map

package/dist/runtime/surface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"surface.d.ts","sourceRoot":"","sources":["../../src/runtime/surface.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAE3D,oFAAoF;AACpF,MAAM,MAAM,YAAY,GAAG,eAAe,CAAC"}

package/dist/runtime/surface.js

@@ -0,0 +1,12 @@
+/**
+ * Worker runtime surface semantics.
+ *
+ * The executable host owns environment registration, plugin composition and
+ * the declared scope — hardware and hosting included. Workers never chooses
+ * or defaults hardware: a worker host serves the hardware its host declared.
+ * `workers serve` is a serve command (rc02-rc03 §2.3): the CLI boots its host
+ * through the one entry, declared `surface: 'worker'`, `purpose: 'worker'`,
+ * before the action runs, so nothing here re-scopes a runtime.
+ */
+export {};
+//# sourceMappingURL=surface.js.map

package/dist/runtime/surface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"surface.js","sourceRoot":"","sources":["../../src/runtime/surface.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG"}

package/dist/runtime/usage-aggregator.d.ts

@@ -0,0 +1,60 @@
+/**
+ * UsageAggregator — buffer + batch per-job execution seconds.
+ *
+ * Job-handle calls are timed at the execution boundary (WorkerRunner for
+ * Bun-based job consumers, cf-job-consumer.factory.ts for CF Queues) and
+ * pushed here synchronously. Records are bucketed by (billingUserId,
+ * organizationId, surface, hardware) and flushed in batches — one event
+ * per bucket per flush window — to whichever `workers/usage-emitter`
+ * impl the runtime resolves.
+ *
+ * Unattributed jobs (no billing subject in metadata) accumulate into a
+ * `platform-overhead-seconds` bucket for internal visibility; attributed
+ * jobs land in `code-execution-seconds` and flow to Stripe via the
+ * existing meter on that slug.
+ *
+ * Latency contract: `record()` is synchronous. Flush is async and
+ * deferred via microtask — it never blocks the job-handle path.
+ */
+import { type VibesRuntime } from '@vibesdotdev/kernel';
+import { type RuntimeLogger } from '@vibesdotdev/logging';
+import type { UsageEmitInput, UsageHardware } from '../kinds/usage-emitter.ts';
+export type AggregatorHardware = UsageHardware;
+export type EmitInput = UsageEmitInput;
+export type EmitFn = (input: UsageEmitInput) => void;
+export interface RecordSample {
+    billingUserId?: string | null;
+    organizationId?: string | null;
+    surface: string;
+    hardware: AggregatorHardware;
+    seconds: number;
+    jobId: string;
+}
+export interface UsageAggregatorOptions {
+    /** The runtime whose lifecycle owns the flush tick; it ends with the runtime. */
+    runtime: VibesRuntime;
+    emit: EmitFn;
+    flushIntervalMs?: number;
+    maxBuckets?: number;
+    logger?: RuntimeLogger;
+    now?: () => number;
+}
+export declare class UsageAggregator {
+    private buckets;
+    private stopTimer;
+    private readonly runtime;
+    private readonly emit;
+    private readonly flushIntervalMs;
+    private readonly maxBuckets;
+    private readonly logger;
+    private readonly now;
+    private started;
+    private inFlight;
+    constructor(options: UsageAggregatorOptions);
+    start(): void;
+    stop(): Promise<void>;
+    record(sample: RecordSample): void;
+    getBucketCount(): number;
+    flush(trigger: 'interval' | 'size' | 'shutdown' | 'manual'): Promise<void>;
+}
+//# sourceMappingURL=usage-aggregator.d.ts.map

package/dist/runtime/usage-aggregator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage-aggregator.d.ts","sourceRoot":"","sources":["../../src/runtime/usage-aggregator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,OAAO,EAAoB,KAAK,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAC1E,OAAO,EAAa,KAAK,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAErE,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAE/E,MAAM,MAAM,kBAAkB,GAAG,aAAa,CAAC;AAC/C,MAAM,MAAM,SAAS,GAAG,cAAc,CAAC;AACvC,MAAM,MAAM,MAAM,GAAG,CAAC,KAAK,EAAE,cAAc,KAAK,IAAI,CAAC;AAOrD,MAAM,WAAW,YAAY;IAC5B,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,kBAAkB,CAAC;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;CACd;AAcD,MAAM,WAAW,sBAAsB;IACtC,iFAAiF;IACjF,OAAO,EAAE,YAAY,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,aAAa,CAAC;IACvB,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;CACnB;AAED,qBAAa,eAAe;IAC3B,OAAO,CAAC,OAAO,CAA6B;IAC5C,OAAO,CAAC,SAAS,CAA6B;IAC9C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAe;IACvC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;IAC9B,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAS;IACzC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgB;IACvC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAe;IACnC,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,QAAQ,CAA8B;gBAElC,OAAO,EAAE,sBAAsB;IAS3C,KAAK,IAAI,IAAI;IAWP,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAiB3B,MAAM,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI;IAwClC,cAAc,IAAI,MAAM;IAIlB,KAAK,CAAC,OAAO,EAAE,UAAU,GAAG,MAAM,GAAG,UAAU,GAAG,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;CAsDhF"}

package/dist/runtime/usage-aggregator.js

@@ -0,0 +1,169 @@
+/**
+ * UsageAggregator — buffer + batch per-job execution seconds.
+ *
+ * Job-handle calls are timed at the execution boundary (WorkerRunner for
+ * Bun-based job consumers, cf-job-consumer.factory.ts for CF Queues) and
+ * pushed here synchronously. Records are bucketed by (billingUserId,
+ * organizationId, surface, hardware) and flushed in batches — one event
+ * per bucket per flush window — to whichever `workers/usage-emitter`
+ * impl the runtime resolves.
+ *
+ * Unattributed jobs (no billing subject in metadata) accumulate into a
+ * `platform-overhead-seconds` bucket for internal visibility; attributed
+ * jobs land in `code-execution-seconds` and flow to Stripe via the
+ * existing meter on that slug.
+ *
+ * Latency contract: `record()` is synchronous. Flush is async and
+ * deferred via microtask — it never blocks the job-handle path.
+ */
+import { valueFreeFailure } from '@vibesdotdev/kernel';
+import { getLogger } from '@vibesdotdev/logging';
+import { settle } from "../core/settle.js";
+const ATTRIBUTED_FEATURE_SLUG = 'code-execution-seconds';
+const UNATTRIBUTED_FEATURE_SLUG = 'platform-overhead-seconds';
+const DEFAULT_FLUSH_INTERVAL_MS = 30_000;
+const DEFAULT_MAX_BUCKETS = 256;
+export class UsageAggregator {
+    buckets = new Map();
+    stopTimer = null;
+    runtime;
+    emit;
+    flushIntervalMs;
+    maxBuckets;
+    logger;
+    now;
+    started = false;
+    inFlight = null;
+    constructor(options) {
+        this.runtime = options.runtime;
+        this.emit = options.emit;
+        this.flushIntervalMs = options.flushIntervalMs ?? DEFAULT_FLUSH_INTERVAL_MS;
+        this.maxBuckets = options.maxBuckets ?? DEFAULT_MAX_BUCKETS;
+        this.logger = options.logger ?? getLogger('worker-runtime', options.runtime).child('usage-aggregator');
+        this.now = options.now ?? Date.now;
+    }
+    start() {
+        if (this.started)
+            return;
+        this.started = true;
+        // A finite host starts no autonomous background work (`interval` refuses it): buckets
+        // are flushed at `stop()` and when `maxBuckets` is reached instead of on a timer.
+        if (this.runtime.scope.lifecycle === 'finite')
+            return;
+        this.stopTimer = this.runtime.lifecycle.interval(() => {
+            void this.flush('interval');
+        }, this.flushIntervalMs);
+    }
+    async stop() {
+        this.started = false;
+        this.stopTimer?.();
+        this.stopTimer = null;
+        await this.flush('shutdown');
+        const inFlight = this.inFlight;
+        if (inFlight) {
+            const joined = await settle(() => inFlight);
+            if (!joined.ok) {
+                // The in-flight flush's own failure was already logged where it ran; stop() only joins it.
+                this.logger.warn('usage-aggregator: in-flight flush failed during stop', {
+                    error: valueFreeFailure(joined.caught)
+                });
+            }
+        }
+    }
+    record(sample) {
+        if (!Number.isFinite(sample.seconds) || sample.seconds <= 0)
+            return;
+        const attributed = Boolean(sample.billingUserId || sample.organizationId);
+        const billingUserId = sample.billingUserId ?? null;
+        const organizationId = sample.organizationId ?? null;
+        const featureSlug = attributed ? ATTRIBUTED_FEATURE_SLUG : UNATTRIBUTED_FEATURE_SLUG;
+        const key = [
+            billingUserId ?? '',
+            organizationId ?? '',
+            sample.surface,
+            sample.hardware,
+            featureSlug
+        ].join('|');
+        const existing = this.buckets.get(key);
+        if (existing) {
+            existing.seconds += sample.seconds;
+            existing.jobCount += 1;
+            existing.lastResourceId = sample.jobId;
+        }
+        else {
+            this.buckets.set(key, {
+                billingUserId,
+                organizationId,
+                featureSlug,
+                surface: sample.surface,
+                hardware: sample.hardware,
+                seconds: sample.seconds,
+                jobCount: 1,
+                lastResourceId: sample.jobId,
+                windowStartedAt: this.now()
+            });
+        }
+        if (this.buckets.size >= this.maxBuckets) {
+            void this.flush('size');
+        }
+    }
+    getBucketCount() {
+        return this.buckets.size;
+    }
+    async flush(trigger) {
+        if (this.buckets.size === 0)
+            return;
+        const snapshot = this.buckets;
+        this.buckets = new Map();
+        const endedAt = this.now();
+        const work = (async () => {
+            // Yield once so size-triggered flushes don't run emit synchronously
+            // inside the caller's stack — record() must remain non-blocking.
+            await Promise.resolve();
+            let emitted = 0;
+            let errors = 0;
+            for (const bucket of snapshot.values()) {
+                // The emitter is synchronous: only a throw from the call itself is its failure.
+                const sent = await settle(() => {
+                    this.emit({
+                        billingUserId: bucket.billingUserId,
+                        organizationId: bucket.organizationId,
+                        featureSlug: bucket.featureSlug,
+                        surface: bucket.surface,
+                        hardware: bucket.hardware,
+                        resourceId: bucket.lastResourceId,
+                        seconds: bucket.seconds,
+                        jobCount: bucket.jobCount,
+                        windowStartedAt: bucket.windowStartedAt,
+                        windowEndedAt: endedAt
+                    });
+                });
+                if (sent.ok) {
+                    emitted += 1;
+                }
+                else {
+                    errors += 1;
+                    this.logger.warn('usage-aggregator: emit threw', {
+                        featureSlug: bucket.featureSlug,
+                        surface: bucket.surface,
+                        error: valueFreeFailure(sent.caught)
+                    });
+                }
+            }
+            this.logger.debug('usage-aggregator: flushed', {
+                trigger,
+                emitted,
+                errors
+            });
+        })();
+        this.inFlight = work;
+        try {
+            await work;
+        }
+        finally {
+            if (this.inFlight === work)
+                this.inFlight = null;
+        }
+    }
+}
+//# sourceMappingURL=usage-aggregator.js.map

package/dist/runtime/usage-aggregator.js.map

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

package/dist/runtime/usage-emitter-resolve.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Resolve a `workers/usage-emitter` implementation from the runtime.
+ *
+ * Returns `undefined` when no impl is registered for the current scope.
+ * Callers (WorkerRuntime, cf-job-consumer) treat metering as opt-in:
+ * the workers package never installs a default impl; the billing layer
+ * (account package) does.
+ */
+import type { VibesRuntime } from '@vibesdotdev/kernel';
+import type { RuntimeLogger } from '@vibesdotdev/logging';
+import type { UsageEmitter } from '../kinds/usage-emitter.ts';
+/**
+ * The scope's usage emitter, or `undefined` when none is composed: the kind is
+ * not registered, or no descriptor (or the kind's resolver) selects one for
+ * this scope. A registered emitter that fails to load is a real failure and
+ * propagates.
+ */
+export declare function resolveUsageEmitter(runtime: VibesRuntime, logger?: RuntimeLogger): Promise<UsageEmitter | undefined>;
+//# sourceMappingURL=usage-emitter-resolve.d.ts.map

package/dist/runtime/usage-emitter-resolve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage-emitter-resolve.d.ts","sourceRoot":"","sources":["../../src/runtime/usage-emitter-resolve.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAExD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAO9D;;;;;GAKG;AACH,wBAAsB,mBAAmB,CACxC,OAAO,EAAE,YAAY,EACrB,MAAM,CAAC,EAAE,aAAa,GACpB,OAAO,CAAC,YAAY,GAAG,SAAS,CAAC,CAWnC"}

package/dist/runtime/usage-emitter-resolve.js

@@ -0,0 +1,23 @@
+/** A resolved implementation that can actually emit. */
+function canEmit(impl) {
+    return impl.emit instanceof Function;
+}
+/**
+ * The scope's usage emitter, or `undefined` when none is composed: the kind is
+ * not registered, or no descriptor (or the kind's resolver) selects one for
+ * this scope. A registered emitter that fails to load is a real failure and
+ * propagates.
+ */
+export async function resolveUsageEmitter(runtime, logger) {
+    if (!runtime.hasKind('workers/usage-emitter')) {
+        logger?.debug('workers/usage-emitter not resolvable: the kind is not registered');
+        return undefined;
+    }
+    const selected = await runtime.query('workers/usage-emitter').enabled().select();
+    if (!selected) {
+        logger?.debug('workers/usage-emitter not resolvable: no emitter is selected for this scope');
+        return undefined;
+    }
+    return canEmit(selected.impl) ? selected.impl : undefined;
+}
+//# sourceMappingURL=usage-emitter-resolve.js.map

package/dist/runtime/usage-emitter-resolve.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage-emitter-resolve.js","sourceRoot":"","sources":["../../src/runtime/usage-emitter-resolve.ts"],"names":[],"mappings":"AAaA,wDAAwD;AACxD,SAAS,OAAO,CAAC,IAAkB;IAClC,OAAO,IAAI,CAAC,IAAI,YAAY,QAAQ,CAAC;AACtC,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACxC,OAAqB,EACrB,MAAsB;IAEtB,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,uBAAuB,CAAC,EAAE,CAAC;QAC/C,MAAM,EAAE,KAAK,CAAC,kEAAkE,CAAC,CAAC;QAClF,OAAO,SAAS,CAAC;IAClB,CAAC;IACD,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,KAAK,CAAkC,uBAAuB,CAAC,CAAC,OAAO,EAAE,CAAC,MAAM,EAAE,CAAC;IAClH,IAAI,CAAC,QAAQ,EAAE,CAAC;QACf,MAAM,EAAE,KAAK,CAAC,6EAA6E,CAAC,CAAC;QAC7F,OAAO,SAAS,CAAC;IAClB,CAAC;IACD,OAAO,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;AAC3D,CAAC"}

package/dist/runtime/usage-hardware.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Usage/billing attribution for worker job handles.
+ *
+ * Execution ABI (`scope.hardware`) and billing class are distinct axes. The
+ * billing class follows the declared `scope.hosting.owner` (workers DECISIONS
+ * 9): `consumer` is the user's own device; any other owner (`vibes`,
+ * `customer`) is operated compute and is metered as cloud. A hosted Bun worker
+ * therefore executes on the consumer ABI yet bills as cloud because its
+ * environment declares a non-consumer owner — never because of a venue name.
+ */
+import type { RuntimeScope } from '@vibesdotdev/kernel';
+import type { UsageHardware } from '../kinds/usage-emitter.ts';
+/** The billing class recorded on usage events, from the declared hosting owner. */
+export declare function resolveUsageAttributionHardware(scope: Pick<RuntimeScope, 'hosting'>): UsageHardware;
+//# sourceMappingURL=usage-hardware.d.ts.map

package/dist/runtime/usage-hardware.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage-hardware.d.ts","sourceRoot":"","sources":["../../src/runtime/usage-hardware.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAE/D,mFAAmF;AACnF,wBAAgB,+BAA+B,CAC9C,KAAK,EAAE,IAAI,CAAC,YAAY,EAAE,SAAS,CAAC,GAClC,aAAa,CAEf"}

package/dist/runtime/usage-hardware.js

@@ -0,0 +1,15 @@
+/**
+ * Usage/billing attribution for worker job handles.
+ *
+ * Execution ABI (`scope.hardware`) and billing class are distinct axes. The
+ * billing class follows the declared `scope.hosting.owner` (workers DECISIONS
+ * 9): `consumer` is the user's own device; any other owner (`vibes`,
+ * `customer`) is operated compute and is metered as cloud. A hosted Bun worker
+ * therefore executes on the consumer ABI yet bills as cloud because its
+ * environment declares a non-consumer owner — never because of a venue name.
+ */
+/** The billing class recorded on usage events, from the declared hosting owner. */
+export function resolveUsageAttributionHardware(scope) {
+    return scope.hosting.owner === 'consumer' ? 'consumer' : 'cloud';
+}
+//# sourceMappingURL=usage-hardware.js.map

package/dist/runtime/usage-hardware.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage-hardware.js","sourceRoot":"","sources":["../../src/runtime/usage-hardware.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAKH,mFAAmF;AACnF,MAAM,UAAU,+BAA+B,CAC9C,KAAoC;IAEpC,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,KAAK,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,OAAO,CAAC;AAClE,CAAC"}

package/dist/runtime/worker-runner.d.ts

@@ -0,0 +1,65 @@
+/** Bridges a runtime worker implementation to a QueueAdapter (dispatch by metadata.type). */
+import { type QueueAdapter } from '../core/queue-adapter.ts';
+import type { WorkerImplementation } from '../kinds/schemas/index.ts';
+import type { VibesRuntime } from '@vibesdotdev/kernel';
+import type { WorkerAdapterInterface } from '../interfaces/adapter.ts';
+import type { WorkerRunnerOptions } from './schemas/contracts.ts';
+export type { WorkerRunnerOptions } from './schemas/contracts.ts';
+export declare class WorkerRunner {
+    private readonly runtime;
+    private readonly worker;
+    private readonly queue;
+    private readonly adapter;
+    private readonly options?;
+    private readonly logger;
+    private readonly runningTasks;
+    private readonly activeJobs;
+    /** Active jobs waiting on children or producer settlement do not hold a handler slot. */
+    private parkedJobs;
+    /** Parked jobs whose wait is over, queued to take back a slot (handed over the moment one frees, before any claim). */
+    private readonly resumeWaiters;
+    private running;
+    /** Aborted by stop() so an idle worker loop wakes now, not a poll interval later. */
+    private loopIdle;
+    private unsubscribeJobAvailable;
+    private dequeueInProgress;
+    private maxConcurrency;
+    private workerHandlerIdsInvalid;
+    private consecutiveDequeueFailures;
+    private dequeueBackoffUntil;
+    private consecutiveHeartbeatFailures;
+    private readonly activeCancellationControllers;
+    private servedJobs?;
+    constructor(runtime: VibesRuntime, worker: WorkerImplementation, queue: QueueAdapter, adapter: WorkerAdapterInterface, options?: WorkerRunnerOptions | undefined);
+    /**
+     * The job types this worker claims: every job the registry puts on the
+     * worker's queue, plus any handler ids the worker declares. Refreshed so
+     * jobs registered after start are served too. An empty set claims nothing.
+     */
+    private resolveJobTypes;
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    private workerLoop;
+    /** A parked job takes its slot back, waiting (first come, first served) while every slot is held. */
+    private unpark;
+    /** The handler ended (returned, threw or timed out): a job still parked stops counting, and leaves the resume queue. */
+    private endParking;
+    /** Hand freed slots to parked jobs waiting to resume (each stops counting as parked as it resumes). */
+    private resumeParked;
+    private tryDequeue;
+    /** Claim the next job this worker serves and start running it; `null` when there is none (or nothing to serve). */
+    private claimNextJob;
+    /** End this claim: the next job-available signal may dequeue at once. (A failed claim is released by tryDequeue after its backoff is set.) */
+    private releaseDequeue;
+    private waitForActiveJobs;
+    /**
+     * Run one job as its own invocation, acting as the envelope actor the
+     * producer stamped from its host (`metadata.actorUserId`, never caller
+     * input), with its organization. A job without one runs with no actor.
+     */
+    private runJobInvocation;
+    /** The host's empty request-values scope; a host without request values has none to leak. */
+    private requestValuesIsolation;
+    private processJob;
+}
+//# sourceMappingURL=worker-runner.d.ts.map

package/dist/runtime/worker-runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker-runner.d.ts","sourceRoot":"","sources":["../../src/runtime/worker-runner.ts"],"names":[],"mappings":"AAAA,6FAA6F;AAC7F,OAAO,EAAyC,KAAK,YAAY,EAA6D,MAAM,0BAA0B,CAAC;AAC/J,OAAO,KAAK,EAIX,oBAAoB,EACpB,MAAM,2BAA2B,CAAC;AACnC,OAAO,KAAK,EAAgB,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAuBtE,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAWvE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAClE,YAAY,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAkIlE,qBAAa,YAAY;IAsBvB,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC;IAzB1B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgB;IACvC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAA4B;IACzD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAA4B;IACvD,yFAAyF;IACzF,OAAO,CAAC,UAAU,CAAK;IACvB,uHAAuH;IACvH,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAyB;IACvD,OAAO,CAAC,OAAO,CAAS;IACxB,qFAAqF;IACrF,OAAO,CAAC,QAAQ,CAAgC;IAChD,OAAO,CAAC,uBAAuB,CAA6B;IAC5D,OAAO,CAAC,iBAAiB,CAAS;IAClC,OAAO,CAAC,cAAc,CAAK;IAC3B,OAAO,CAAC,uBAAuB,CAAS;IACxC,OAAO,CAAC,0BAA0B,CAAK;IACvC,OAAO,CAAC,mBAAmB,CAAK;IAChC,OAAO,CAAC,4BAA4B,CAAK;IACzC,OAAO,CAAC,QAAQ,CAAC,6BAA6B,CAA8B;IAC5E,OAAO,CAAC,UAAU,CAAC,CAAgC;gBAGjC,OAAO,EAAE,YAAY,EACrB,MAAM,EAAE,oBAAoB,EAC5B,KAAK,EAAE,YAAY,EACnB,OAAO,EAAE,sBAAsB,EAC/B,OAAO,CAAC,EAAE,mBAAmB,YAAA;IAY/C;;;;OAIG;IACH,OAAO,CAAC,eAAe;IAwBjB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAwBtB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;YAkDb,UAAU;IAuBxB,qGAAqG;YACvF,MAAM;IAYpB,wHAAwH;IACxH,OAAO,CAAC,UAAU;IAYlB,uGAAuG;IACvG,OAAO,CAAC,YAAY;YAON,UAAU;IAgCxB,mHAAmH;IACnH,OAAO,CAAC,YAAY;IA2CpB,8IAA8I;IAC9I,OAAO,CAAC,cAAc;YAKR,iBAAiB;IAK/B;;;;OAIG;YACW,gBAAgB;IAsC9B,6FAA6F;YAC/E,sBAAsB;YAQtB,UAAU;CA+fxB"}