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

package/dist/adapters/ipc/store/queue-job-metadata.record.descriptor.d.ts

@@ -0,0 +1,13 @@
+import * as z from 'zod/v4';
+import type { StorageRecordDescriptorInput } from '@vibesdotdev/storage/schemas/record';
+export declare const QueueJobMetadataRecordSchema: z.ZodObject<{
+    id: z.ZodString;
+    jobId: z.ZodString;
+    key: z.ZodString;
+    value: z.ZodType<import("@vibesdotdev/kernel/bootstrap").JsonValue, import("@vibesdotdev/kernel/bootstrap").JsonValue, z.core.$ZodTypeInternals<import("@vibesdotdev/kernel/bootstrap").JsonValue, import("@vibesdotdev/kernel/bootstrap").JsonValue>>;
+}, z.core.$strip>;
+export type QueueJobMetadataRecord = z.infer<typeof QueueJobMetadataRecordSchema>;
+export declare const QUEUE_JOB_METADATA_RECORD_ID = "workers.queue-job-metadata";
+export declare function queueJobMetadataId(jobId: string, key: string): string;
+export declare const queueJobMetadataRecordDescriptor: StorageRecordDescriptorInput;
+//# sourceMappingURL=queue-job-metadata.record.descriptor.d.ts.map

package/dist/adapters/ipc/store/queue-job-metadata.record.descriptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue-job-metadata.record.descriptor.d.ts","sourceRoot":"","sources":["../../../../src/adapters/ipc/store/queue-job-metadata.record.descriptor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAE5B,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,qCAAqC,CAAC;AAGxF,eAAO,MAAM,4BAA4B;;;;;iBAEvC,CAAC;AACH,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,4BAA4B,CAAC,CAAC;AAClF,eAAO,MAAM,4BAA4B,+BAA+B,CAAC;AACzE,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAErE;AAED,eAAO,MAAM,gCAAgC,EAAE,4BAe9C,CAAC"}

package/dist/adapters/ipc/store/queue-job-metadata.record.descriptor.js

@@ -0,0 +1,27 @@
+import * as z from 'zod/v4';
+import { JsonValueSchema } from '@vibesdotdev/kernel/schemas/json';
+import { QUEUE_JOB_RECORD_ID } from "./queue-job.record.descriptor.js";
+export const QueueJobMetadataRecordSchema = z.object({
+    id: z.string().min(1), jobId: z.string().min(1), key: z.string(), value: JsonValueSchema
+});
+export const QUEUE_JOB_METADATA_RECORD_ID = 'workers.queue-job-metadata';
+export function queueJobMetadataId(jobId, key) {
+    return JSON.stringify([jobId, key]);
+}
+export const queueJobMetadataRecordDescriptor = {
+    kind: 'storage/record', id: QUEUE_JOB_METADATA_RECORD_ID, name: 'Workers Consumer Job Metadata',
+    description: 'The latest value of each admitted job metadata key; retired atomically with its queue row',
+    retention: {
+        cascadeFrom: QUEUE_JOB_RECORD_ID,
+        enforcedBy: 'maintenance.queues-clean',
+        reason: 'Each latest metadata value belongs to its queue row; guarded queue cleanup retires both atomically after physical execution retirement.'
+    },
+    schema: QueueJobMetadataRecordSchema, tableName: 'workers_queue_job_metadata', primaryKey: 'id',
+    indexes: [{ fields: ['jobId'] }], version: 1, scope: 'project',
+    allowedAdapters: ['storage.localdb'], defaultAdapter: 'storage.localdb',
+    adapterConfig: { 'storage.localdb': { dbName: 'workers.db', scope: 'project' } },
+    timestamps: false, autoId: false, versioning: false, audit: false, changeTracking: false,
+    validateOnWrite: false, validateOnRead: false, namespace: QUEUE_JOB_METADATA_RECORD_ID,
+    tags: ['workers', 'queue', 'tenancy:project']
+};
+//# sourceMappingURL=queue-job-metadata.record.descriptor.js.map

package/dist/adapters/ipc/store/queue-job-metadata.record.descriptor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue-job-metadata.record.descriptor.js","sourceRoot":"","sources":["../../../../src/adapters/ipc/store/queue-job-metadata.record.descriptor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAC5B,OAAO,EAAE,eAAe,EAAE,MAAM,kCAAkC,CAAC;AAEnE,OAAO,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AAEvE,MAAM,CAAC,MAAM,4BAA4B,GAAG,CAAC,CAAC,MAAM,CAAC;IACpD,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,KAAK,EAAE,eAAe;CACxF,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,4BAA4B,GAAG,4BAA4B,CAAC;AACzE,MAAM,UAAU,kBAAkB,CAAC,KAAa,EAAE,GAAW;IAC5D,OAAO,IAAI,CAAC,SAAS,CAAC,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,CAAC;AACrC,CAAC;AAED,MAAM,CAAC,MAAM,gCAAgC,GAAiC;IAC7E,IAAI,EAAE,gBAAgB,EAAE,EAAE,EAAE,4BAA4B,EAAE,IAAI,EAAE,+BAA+B;IAC/F,WAAW,EAAE,2FAA2F;IACxG,SAAS,EAAE;QACV,WAAW,EAAE,mBAAmB;QAChC,UAAU,EAAE,0BAA0B;QACtC,MAAM,EAAE,yIAAyI;KACjJ;IACD,MAAM,EAAE,4BAA4B,EAAE,SAAS,EAAE,4BAA4B,EAAE,UAAU,EAAE,IAAI;IAC/F,OAAO,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,KAAK,EAAE,SAAS;IAC9D,eAAe,EAAE,CAAC,iBAAiB,CAAC,EAAE,cAAc,EAAE,iBAAiB;IACvE,aAAa,EAAE,EAAE,iBAAiB,EAAE,EAAE,MAAM,EAAE,YAAY,EAAE,KAAK,EAAE,SAAS,EAAE,EAAE;IAChF,UAAU,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,cAAc,EAAE,KAAK;IACxF,eAAe,EAAE,KAAK,EAAE,cAAc,EAAE,KAAK,EAAE,SAAS,EAAE,4BAA4B;IACtF,IAAI,EAAE,CAAC,SAAS,EAAE,OAAO,EAAE,iBAAiB,CAAC;CAC7C,CAAC"}

package/dist/adapters/ipc/store/queue-job.record.descriptor.d.ts

@@ -0,0 +1,88 @@
+/**
+ * Consumer queue jobs — one row per job the IPC adapter has accepted.
+ *
+ * The worker runtime process keeps its queue in memory for fast claims and
+ * writes every change through to this record. On start it rebuilds the queue
+ * from here, so a job accepted before a restart, a crash or a laptop sleep
+ * still runs, and a finished job's result stays readable.
+ */
+import * as z from 'zod/v4';
+import type { StorageRecordDescriptorInput } from '@vibesdotdev/storage/schemas/record';
+export declare const QueueJobRecordSchema: z.ZodObject<{
+    id: z.ZodString;
+    queue: z.ZodString;
+    status: z.ZodEnum<{
+        cancelled: "cancelled";
+        failed: "failed";
+        pending: "pending";
+        delayed: "delayed";
+        processing: "processing";
+        completed: "completed";
+    }>;
+    cancellation: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        by: z.ZodLiteral<"invocation">;
+        actor: z.ZodObject<{
+            agentId: z.ZodOptional<z.ZodPipe<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>, z.ZodString>>;
+            harness: z.ZodOptional<z.ZodPipe<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>, z.ZodString>>;
+            agentSystemId: z.ZodOptional<z.ZodPipe<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>, z.ZodString>>;
+            harnessSessionId: z.ZodOptional<z.ZodPipe<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>, z.ZodString>>;
+            userId: z.ZodOptional<z.ZodPipe<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>, z.ZodString>>;
+            orgId: z.ZodOptional<z.ZodPipe<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>, z.ZodString>>;
+            projectId: z.ZodOptional<z.ZodPipe<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>, z.ZodString>>;
+            teamId: z.ZodOptional<z.ZodPipe<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>, z.ZodString>>;
+            home: z.ZodOptional<z.ZodEnum<{
+                user: "user";
+                organization: "organization";
+                team: "team";
+            }>>;
+            projectIds: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodPipe<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>, z.ZodString>>>>;
+            participantId: z.ZodOptional<z.ZodPipe<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>, z.ZodString>>;
+            sessionId: z.ZodOptional<z.ZodPipe<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>, z.ZodString>>;
+            instanceId: z.ZodOptional<z.ZodPipe<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>, z.ZodString>>;
+        }, z.core.$strip>;
+        reason: z.ZodString;
+        cascadedFrom: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>, z.ZodObject<{
+        by: z.ZodLiteral<"system">;
+        source: z.ZodEnum<{
+            cascade: "cascade";
+            "graph-stop": "graph-stop";
+            "graph-cancel": "graph-cancel";
+            deadline: "deadline";
+            disposal: "disposal";
+            "launcher-exit": "launcher-exit";
+        }>;
+        reason: z.ZodString;
+        cascadedFrom: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>], "by">>;
+    data: z.ZodUnknown;
+    result: z.ZodUnknown;
+    error: z.ZodNullable<z.ZodString>;
+    progress: z.ZodNullable<z.ZodUnion<readonly [z.ZodNumber, z.ZodCustom<object, object>]>>;
+    attemptsMade: z.ZodNumber;
+    metadata: z.ZodRecord<z.ZodString, z.ZodType<import("@vibesdotdev/kernel/bootstrap").JsonValue, import("@vibesdotdev/kernel/bootstrap").JsonValue, z.core.$ZodTypeInternals<import("@vibesdotdev/kernel/bootstrap").JsonValue, import("@vibesdotdev/kernel/bootstrap").JsonValue>>>;
+    metadataFormat: z.ZodOptional<z.ZodNullable<z.ZodLiteral<"entries-v1">>>;
+    metadataKeys: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString>>>;
+    createdAt: z.ZodString;
+    startedAt: z.ZodNullable<z.ZodString>;
+    finishedAt: z.ZodNullable<z.ZodString>;
+    generation: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    revision: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    executionState: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+        unknown: "unknown";
+        none: "none";
+        held: "held";
+    }>>>;
+    claimToken: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    claimAttempt: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    claimOwner: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    claimHeartbeatAt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    retiredAt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    claimIncarnation: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    claimPid: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+}, z.core.$strip>;
+export type QueueJobRecord = z.infer<typeof QueueJobRecordSchema>;
+export declare const QUEUE_JOB_RECORD_ID = "workers.queue-job";
+export declare const queueJobRecordDescriptor: StorageRecordDescriptorInput;
+export default queueJobRecordDescriptor;
+//# sourceMappingURL=queue-job.record.descriptor.d.ts.map

package/dist/adapters/ipc/store/queue-job.record.descriptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue-job.record.descriptor.d.ts","sourceRoot":"","sources":["../../../../src/adapters/ipc/store/queue-job.record.descriptor.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAE5B,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,qCAAqC,CAAC;AAUxF,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBA6B/B,CAAC;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAElE,eAAO,MAAM,mBAAmB,sBAAsB,CAAC;AAEvD,eAAO,MAAM,wBAAwB,EAAE,4BAuCtC,CAAC;AAEF,eAAe,wBAAwB,CAAC"}

package/dist/adapters/ipc/store/queue-job.record.descriptor.js

@@ -0,0 +1,88 @@
+/**
+ * Consumer queue jobs — one row per job the IPC adapter has accepted.
+ *
+ * The worker runtime process keeps its queue in memory for fast claims and
+ * writes every change through to this record. On start it rebuilds the queue
+ * from here, so a job accepted before a restart, a crash or a laptop sleep
+ * still runs, and a finished job's result stays readable.
+ */
+import * as z from 'zod/v4';
+import { JsonValueSchema } from '@vibesdotdev/kernel/schemas/json';
+import { JobStatusSchema, JobExecutionRecordSchema } from "../../../core/schemas/index.js";
+import { CancellationSchema } from "../../../schemas/cancellation.js";
+/** A progress detail: any non-null object (a number is a percentage). */
+function isProgressDetail(value) {
+    return typeof value === 'object' && value !== null;
+}
+export const QueueJobRecordSchema = z.object({
+    id: z.string().min(1),
+    /** Physical queue name the job was enqueued on. */
+    queue: z.string().min(1),
+    status: JobStatusSchema,
+    /** Missing on records written before cancellation attribution was introduced. */
+    cancellation: CancellationSchema.optional(),
+    data: z.unknown(),
+    result: z.unknown(),
+    error: z.string().nullable(),
+    progress: z.union([z.number(), z.custom(isProgressDetail)]).nullable(),
+    attemptsMade: z.number().int().nonnegative(),
+    /** Persistent IPC queue metadata is restricted to JSON values. */
+    metadata: z.record(z.string(), JsonValueSchema),
+    /** Version 4 keeps latest metadata values in same-database entries, outside the hot fenced row. */
+    metadataFormat: z.literal('entries-v1').nullish(),
+    metadataKeys: z.array(z.string()).nullish(),
+    createdAt: z.string().datetime(),
+    startedAt: z.string().datetime().nullable(),
+    /** Logical terminal publication, independent of physical execution retirement. */
+    finishedAt: z.string().datetime().nullable()
+}).extend(JobExecutionRecordSchema.shape).extend({
+    retiredAt: z.string().datetime().nullish(),
+    /**
+     * The serve process a held claim was taken in: its incarnation (minted once per process that opens
+     * this queue) and its pid. Absent on rows stored before version 3 and on rows without a held claim.
+     */
+    claimIncarnation: z.string().min(1).nullish(),
+    claimPid: z.number().int().positive().nullish()
+});
+export const QUEUE_JOB_RECORD_ID = 'workers.queue-job';
+export const queueJobRecordDescriptor = {
+    kind: 'storage/record',
+    id: QUEUE_JOB_RECORD_ID,
+    name: 'Workers Consumer Queue',
+    description: 'Jobs accepted by the consumer IPC queue, so queued work and results survive a restart',
+    retention: {
+        enforcedBy: 'maintenance.queues-clean',
+        maxAgeDays: 7,
+        ageField: 'retiredAt',
+        reason: 'A finished job stays readable so a waiting client or flow can collect its result. ' +
+            'maintenance.queues-clean prunes completed jobs after a day and failed ones after seven; ' +
+            'Only a physically retired terminal execution has retiredAt. Held and unresolved claims never age out.'
+    },
+    schema: QueueJobRecordSchema,
+    tableName: 'workers_queue_jobs',
+    primaryKey: 'id',
+    relations: {},
+    indexes: [
+        { fields: ['queue', 'status'], unique: false },
+        { fields: ['retiredAt'], unique: false }
+    ],
+    version: 4,
+    timestamps: false,
+    autoId: false,
+    allowedAdapters: ['storage.localdb'],
+    defaultAdapter: 'storage.localdb',
+    adapterConfig: {
+        'storage.localdb': { dbName: 'workers.db', scope: 'project' }
+    },
+    scope: 'project',
+    validateOnWrite: false,
+    validateOnRead: false,
+    versioning: false,
+    audit: false,
+    changeTracking: false,
+    internal: false,
+    namespace: QUEUE_JOB_RECORD_ID,
+    tags: ['workers', 'queue', 'tenancy:project']
+};
+export default queueJobRecordDescriptor;
+//# sourceMappingURL=queue-job.record.descriptor.js.map

package/dist/adapters/ipc/store/queue-job.record.descriptor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue-job.record.descriptor.js","sourceRoot":"","sources":["../../../../src/adapters/ipc/store/queue-job.record.descriptor.ts"],"names":[],"mappings":"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"}

package/dist/adapters/ipc/store/store.d.ts

@@ -0,0 +1,122 @@
+import { type RuntimeRef } from '@vibesdotdev/kernel';
+import type { StorageRecordInterface } from '@vibesdotdev/storage/interfaces/record';
+import type { CleanupOptions, CleanupResult, EnqueueOptions, Job, JobState, JobStatus, JobUpdate, KeyedClaimOptions, KeyedClaimReceipt, CoalescedEnqueueOptions, CoalescedEnqueueReceipt, QueueMetrics, JobExecutionClaim, JobWriteGuard, JobRetryOptions, JobMutationStamp, DequeueOptions, JobListOptions } from '../../../core/queue-adapter.ts';
+import type { Cancellation } from '../../../schemas/cancellation.ts';
+import type { QueueJobRecord } from './queue-job.record.descriptor.ts';
+import { type QueueJobMetadataRecord } from './queue-job-metadata.record.descriptor.ts';
+interface DequeueJobOptions extends DequeueOptions {
+    queueName?: string;
+}
+/** A `listJobs` page scoped to one physical queue. */
+interface ListJobsOptions extends JobListOptions {
+    queueName?: string;
+}
+export declare class IpcJobStore {
+    private readonly runtime;
+    private readonly jobs;
+    private readonly queue;
+    private readonly jobAvailableCallbacks;
+    private readonly delayedTimers;
+    private readonly writes;
+    /** Jobs whose latest change was refused by storage (a full disk, say): stored again once a write lands. */
+    private readonly unstored;
+    /** The fence of each job's row as last durably stored: the next write is admitted against it. */
+    private readonly storedFences;
+    private record?;
+    private metadataRecord?;
+    private readonly normalizedJobs;
+    private readonly storedMetadataKeys;
+    private readonly metadataVersions;
+    private readonly storedMetadataVersions;
+    private metadataSequence;
+    private executionOwner?;
+    /** This process's incarnation of the queue: every claim it takes is stamped with it and its pid. */
+    private readonly incarnation;
+    private incarnationPid?;
+    /** The serve process each held claim (by token) was taken in; `null` when it was never recorded. */
+    private readonly claimStamps;
+    /** `runtime` owns the delayed-job timers; they end with it. */
+    constructor(runtime: RuntimeRef);
+    /**
+     * Restore the stored admission and claim exactly. A restart or a silent
+     * heartbeat is not proof that its producer or supervised workload stopped.
+     * The one exception is proved, not inferred: a held claim taken in another
+     * serve process whose pid is no longer running, and whose job explicitly
+     * recorded its supervised workloads (`[]` for none) with PM reporting each
+     * ended, is interrupted (`worker-incarnation-ended`).
+     * A row whose stored claim is malformed opens unresolved with its typed
+     * fault and stays as stored: that job is fenced, the others are served.
+     */
+    open(record: StorageRecordInterface<QueueJobRecord>, metadataRecord: StorageRecordInterface<QueueJobMetadataRecord>): Promise<void>;
+    /** Recovery refuses takeover until the selected owner supplies real retirement. */
+    checkExpiredExecutions(now?: number): void;
+    /** Resolve once every change made so far is stored. */
+    flush(): Promise<void>;
+    flushJob(jobId: string): Promise<void>;
+    onJobAvailable(handler: () => void): () => void;
+    enqueueJob<TJob>(jobId: string, data: TJob, options?: EnqueueOptions): string;
+    /**
+     * Claim a caller key (`QueueAdapter.claimKeyed`): the read, the decision and
+     * the write happen in this one synchronous section of the owning process.
+     */
+    claimKeyed<TJob>(jobId: string, data: TJob, options: KeyedClaimOptions): KeyedClaimReceipt<TJob>;
+    /**
+     * Coalesced enqueue (`QueueAdapter.enqueueCoalesced`): join this queue's
+     * delayed or pending job carrying the key, else write `jobId` carrying it —
+     * decided in this one synchronous section. Only jobs that have not started
+     * are scanned, so the cost follows the queue's backlog, not its history.
+     */
+    enqueueCoalesced<TJob>(jobId: string, data: TJob, options: CoalescedEnqueueOptions): CoalescedEnqueueReceipt;
+    /** Write a new admission of `jobId`, one generation past the job it replaces. */
+    private writeJob;
+    dequeueJob<TJob>(options?: DequeueJobOptions): Job<TJob> | null;
+    getJob<TJob>(jobId: string): Job<TJob> | null;
+    updateJob(jobId: string, update: JobUpdate, guard: JobWriteGuard): JobMutationStamp;
+    renewExecution(jobId: string, claim: JobExecutionClaim): void;
+    releaseExecution(jobId: string, claim: JobExecutionClaim): void;
+    admitEvent(jobId: string, guard: JobWriteGuard): JobMutationStamp;
+    cancelJob(jobId: string, cancellation: Cancellation, guard?: JobWriteGuard): JobMutationStamp | null;
+    retryJob(jobId: string, options: JobRetryOptions): string;
+    getStatus(jobId: string): JobStatus;
+    listJobs<TJob>(state?: JobState, options?: ListJobsOptions): Job<TJob>[];
+    /** Count one queue's jobs by status in place; no job is snapshotted or serialized. */
+    getMetrics(queueName: string): QueueMetrics;
+    /**
+     * Remove one queue's finished jobs older than the given ages. Cancelled jobs
+     * age with completed ones. Unfinished jobs are never removed.
+     */
+    cleanup(queueName: string, options?: CleanupOptions): Promise<CleanupResult>;
+    private notifyJobAvailable;
+    /** Admit every durable mutation for one job to its existing writer chain. */
+    private enqueueWrite;
+    /**
+     * Write the job's current state behind any earlier write for the same job. Each write stores the
+     * current row and every dirty metadata key against the row last durably stored, so a refused earlier write never blocks a
+     * later one: the later write carries every change the refused one held. A retryable refusal
+     * (`CONFLICT sqlite-busy`) is retried with backoff on the same write; a non-retryable one
+     * (`job-write-stale`: another writer owns the row) is logged and not retried.
+     */
+    private persist;
+    /** Store the job's row as it is now, retrying a retryable refusal up to `STORE_WRITE_ATTEMPTS` times. */
+    private storeCurrent;
+    private storeRow;
+    private markMetadata;
+    private isFenceMiss;
+    private restoreMetadata;
+    /** This host's process service; `undefined` when it composes none (nothing is stamped or proved then). */
+    private processService;
+    /** The job's row, with the serve process its held claim was taken in. */
+    private storedRecord;
+    private ownsRecoveryFence;
+    private hasDurableRecoveryFence;
+    private interruptEndedIncarnations;
+    /** Return the exact proved queue revision; every awaited owner call is fenced. */
+    private supervisedWorkloadsEnded;
+    private clearDelayedTimer;
+    private removeQueuedJobOccurrences;
+    private enqueuePendingJob;
+    private scheduleDelayedJob;
+}
+export declare function ipcJobStoreFor(runtime: RuntimeRef): IpcJobStore;
+export {};
+//# sourceMappingURL=store.d.ts.map

package/dist/adapters/ipc/store/store.d.ts.map

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