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

package/dist/workers.cloud.plugin.js

@@ -0,0 +1,61 @@
+import cryptoPlugin from '@vibesdotdev/crypto/plugin';
+import { createRuntimePlugin, loader } from '@vibesdotdev/kernel';
+import { workersAdmissionKind } from "./client/admission.js";
+import { jobKind } from "./kinds/job.js";
+import { workerKind } from "./kinds/worker.js";
+import { usageEmitterKind } from "./kinds/usage-emitter.js";
+import { jobEventBusKind, registerWorkerJobEventBusModules } from "./kinds/job-event-bus.js";
+import { flowKind } from "./kinds/flow.js";
+import { opsReportSliceKind } from "./kinds/ops-report-slice.kind.js";
+import { opsAlertRuleKind } from "./kinds/ops-alert-rule.kind.js";
+import opsSweepEmitReportSliceJobDescriptor, { OPS_SWEEP_EMIT_REPORT_SLICE_JOB_ID } from "./ops/emit-report-slice/ops.sweep.emit-report-slice.descriptor.js";
+import { WorkerAdapterDescriptorSchema, resolveWorkerAdapterKind } from "./schemas/adapter.js";
+import { DefaultWorkerAdapter } from "./adapters/default.js";
+import flowDescriptor from "./runtime/flow.descriptor.js";
+import workersConfigDescriptor from "./config/workers.config.descriptor.js";
+import workersCodeExecutionConfigDescriptor from "./config/workers.code-execution.config.descriptor.js";
+const workerAdapterKind = {
+    id: 'workers/adapter',
+    descriptorSchema: WorkerAdapterDescriptorSchema,
+    defaultImplementation: DefaultWorkerAdapter,
+    resolve: resolveWorkerAdapterKind
+    // No kind context: an implementation reads `runtime/workspace-path` at use,
+    // so it loads on a host that binds no workspace (C1, C9).
+};
+export function createWorkersCloudPlugin(options = {}) {
+    return createRuntimePlugin({
+        // Same id as the consumer `workers` plugin per AGENT-CONSTITUTION
+        // §PLUGIN ID PARITY: the bare id is the public capability.
+        id: 'workers',
+        name: 'Workers Module (Cloud)',
+        description: 'Cloud-safe worker kind registration without consumer CLI or IPC adapters',
+        dependencies: ['config', 'runtime-client'],
+        kinds: [workersAdmissionKind, workerKind, jobKind, workerAdapterKind, usageEmitterKind, flowKind, jobEventBusKind, opsReportSliceKind, opsAlertRuleKind],
+        descriptors: [workersConfigDescriptor, workersCodeExecutionConfigDescriptor, flowDescriptor, opsSweepEmitReportSliceJobDescriptor],
+        loaders: [
+            loader(OPS_SWEEP_EMIT_REPORT_SLICE_JOB_ID, { kind: 'workers/job', scope: 'cloud' }, () => import("./ops/emit-report-slice/ops.sweep.emit-report-slice.impl.js"))
+        ],
+        // Keyed dispatch hashes through the runtime's `crypto/hash` implementation (core/keyed-dispatch.ts).
+        async onRegister(runtime) {
+            await runtime.registerPlugin(cryptoPlugin);
+        },
+        // The canonical `workers` runtime/client must be available on cloud
+        // surfaces too — `getWorkersClient(runtime)` on the request's runtime
+        // is how cloud apps enqueue jobs onto the selected cloud adapter.
+        onActivate(runtime) {
+            registerWorkerJobEventBusModules(runtime, options.jobEventBusModules ?? []);
+            runtime.registerDescriptor('runtime/client', {
+                id: 'workers',
+                kind: 'runtime/client',
+                description: 'Canonical Workers client — enqueue/getQueue with kernel-selected adapter.'
+            });
+            runtime.registerLoader('runtime/client', 'workers', async () => {
+                const { WorkersClient } = await import("./client/runtime-client.js");
+                return { impl: WorkersClient };
+            });
+        }
+    });
+}
+const defaultExport = createWorkersCloudPlugin();
+export default defaultExport;
+//# sourceMappingURL=workers.cloud.plugin.js.map

package/dist/workers.cloud.plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workers.cloud.plugin.js","sourceRoot":"","sources":["../src/workers.cloud.plugin.ts"],"names":[],"mappings":"AAAA,OAAO,YAAY,MAAM,4BAA4B,CAAC;AACtD,OAAO,EAAE,mBAAmB,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAClE,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AACzC,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EACN,eAAe,EACf,gCAAgC,EAEhC,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAC3C,OAAO,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AACtE,OAAO,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAClE,OAAO,oCAAoC,EAAE,EAAE,kCAAkC,EAAE,MAAM,mEAAmE,CAAC;AAC7J,OAAO,EAAE,6BAA6B,EAAE,wBAAwB,EAAE,MAAM,sBAAsB,CAAC;AAC/F,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,cAAc,MAAM,8BAA8B,CAAC;AAC1D,OAAO,uBAAuB,MAAM,uCAAuC,CAAC;AAC5E,OAAO,oCAAoC,MAAM,sDAAsD,CAAC;AAExG,MAAM,iBAAiB,GAAG;IACzB,EAAE,EAAE,iBAAiB;IACrB,gBAAgB,EAAE,6BAA6B;IAC/C,qBAAqB,EAAE,oBAAoB;IAC3C,OAAO,EAAE,wBAAwB;IACjC,4EAA4E;IAC5E,0DAA0D;CAC1D,CAAC;AAOF,MAAM,UAAU,wBAAwB,CAAC,UAAqC,EAAE;IAC/E,OAAO,mBAAmB,CAAC;QAC1B,kEAAkE;QAClE,2DAA2D;QAC3D,EAAE,EAAE,SAAS;QACb,IAAI,EAAE,wBAAwB;QAC9B,WAAW,EAAE,0EAA0E;QACvF,YAAY,EAAE,CAAC,QAAQ,EAAE,gBAAgB,CAAC;QAC1C,KAAK,EAAE,CAAC,oBAAoB,EAAE,UAAU,EAAE,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,QAAQ,EAAE,eAAe,EAAE,kBAAkB,EAAE,gBAAgB,CAAC;QACxJ,WAAW,EAAE,CAAC,uBAAuB,EAAE,oCAAoC,EAAE,cAAc,EAAE,oCAAoC,CAAC;QAClI,OAAO,EAAE;YACR,MAAM,CACL,kCAAkC,EAClC,EAAE,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE,OAAO,EAAE,EACvC,GAAG,EAAE,CAAC,MAAM,CAAC,6DAA6D,CAAC,CAC3E;SACD;QACD,qGAAqG;QACrG,KAAK,CAAC,UAAU,CAAC,OAAO;YACvB,MAAM,OAAO,CAAC,cAAc,CAAC,YAAY,CAAC,CAAC;QAC5C,CAAC;QACD,oEAAoE;QACpE,sEAAsE;QACtE,kEAAkE;QAClE,UAAU,CAAC,OAAO;YACjB,gCAAgC,CAAC,OAAO,EAAE,OAAO,CAAC,kBAAkB,IAAI,EAAE,CAAC,CAAC;YAC5E,OAAO,CAAC,kBAAkB,CAAC,gBAAgB,EAAE;gBAC5C,EAAE,EAAE,SAAS;gBACb,IAAI,EAAE,gBAAgB;gBACtB,WAAW,EACV,2EAA2E;aAC5E,CAAC,CAAC;YACH,OAAO,CAAC,cAAc,CAAC,gBAAgB,EAAE,SAAS,EAAE,KAAK,IAAI,EAAE;gBAC9D,MAAM,EAAE,aAAa,EAAE,GAAG,MAAM,MAAM,CAAC,4BAA4B,CAAC,CAAC;gBACrE,OAAO,EAAE,IAAI,EAAE,aAAa,EAAE,CAAC;YAChC,CAAC,CAAC,CAAC;QACJ,CAAC;KACD,CAAC,CAAC;AACJ,CAAC;AAED,MAAM,aAAa,GAAG,wBAAwB,EAAE,CAAC;AAEjD,eAAe,aAAa,CAAC"}

package/dist/workers.consumer.plugin.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Complete consumer composition for hosts that need local adapters and services.
+ */
+import { type RuntimeRef } from '@vibesdotdev/kernel';
+import type { WorkersPluginOptions } from './schemas/plugin-options.ts';
+export declare function createWorkersConsumerPlugin(options?: WorkersPluginOptions): {
+    name: string | undefined;
+    onRegister(runtime: RuntimeRef): Promise<void>;
+    id: string;
+    description?: string;
+    dependencies?: readonly string[];
+    optionalDependencies?: readonly string[];
+    kinds?: import("@vibesdotdev/kernel").AnyRuntimeKindDescriptor[];
+    onActivate?: (runtime: RuntimeRef) => void | Promise<void>;
+    onDispose?: (runtime: RuntimeRef) => void | Promise<void>;
+    onRetire?: (runtime: RuntimeRef) => void | Promise<void>;
+};
+export declare const createWorkersPlugin: typeof createWorkersConsumerPlugin;
+declare const _default: {
+    name: string | undefined;
+    onRegister(runtime: RuntimeRef): Promise<void>;
+    id: string;
+    description?: string;
+    dependencies?: readonly string[];
+    optionalDependencies?: readonly string[];
+    kinds?: import("@vibesdotdev/kernel").AnyRuntimeKindDescriptor[];
+    onActivate?: (runtime: RuntimeRef) => void | Promise<void>;
+    onDispose?: (runtime: RuntimeRef) => void | Promise<void>;
+    onRetire?: (runtime: RuntimeRef) => void | Promise<void>;
+};
+export default _default;
+//# sourceMappingURL=workers.consumer.plugin.d.ts.map

package/dist/workers.consumer.plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workers.consumer.plugin.d.ts","sourceRoot":"","sources":["../src/workers.consumer.plugin.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAA+B,KAAK,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAInF,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AAMxE,wBAAgB,2BAA2B,CAAC,OAAO,GAAE,oBAAyB;;wBAsClD,UAAU;;;;;;;;;EAKrC;AAED,eAAO,MAAM,mBAAmB,oCAA8B,CAAC;;;wBAPnC,UAAU;;;;;;;;;;AAQtC,wBAA6C"}

package/dist/workers.consumer.plugin.js

@@ -0,0 +1,43 @@
+/**
+ * Complete consumer composition for hosts that need local adapters and services.
+ */
+import { createRuntimePlugin, loader } from '@vibesdotdev/kernel';
+import { createWorkersPlugin as createCommonWorkersPlugin } from "./workers.plugin.js";
+import consumerServicesPlugin from "./runtime/services.consumer.plugin.js";
+import schedulesConsumerPlugin from "./adapters/ipc/schedules.consumer.plugin.js";
+import ipcAdapterDescriptor from "./adapters/ipc/worker-adapter.ipc.descriptor.js";
+import queueJobRecordDescriptor from "./adapters/ipc/store/queue-job.record.descriptor.js";
+import { queueJobMetadataRecordDescriptor } from "./adapters/ipc/store/queue-job-metadata.record.descriptor.js";
+import { consumerDeadLetterStoreDescriptor } from "./dead-letter/dead-letter-store.impl.consumer.js";
+export function createWorkersConsumerPlugin(options = {}) {
+    const common = createCommonWorkersPlugin(options);
+    const consumer = createRuntimePlugin({
+        id: common.id,
+        name: 'Workers Module (Consumer)',
+        descriptors: [ipcAdapterDescriptor, queueJobRecordDescriptor, queueJobMetadataRecordDescriptor, consumerDeadLetterStoreDescriptor],
+        loaders: [
+            loader('worker-adapter.ipc', 'consumer', () => import("./adapters/ipc/worker-adapter.ipc.impl.consumer.js")),
+            // Only workers serve owns the queue socket. Other consumer hosts reach it as clients.
+            loader('worker-adapter.ipc', { scope: { hardware: ['consumer'], surfaces: ['worker'], qualifiers: { serve: 'workers.serve' } } }, () => import("./adapters/ipc/worker-adapter.ipc.impl.consumer.worker.js")),
+            loader('workers.dead-letter-store.consumer', 'consumer', () => import("./dead-letter/dead-letter-store.impl.consumer.js")),
+            loader('flow', { kind: 'workers/flow', scope: 'consumer' }, () => import("./runtime/flow.impl.consumer.js")),
+            loader('maintenance.queues-clean', { kind: 'workers/job', scope: 'consumer' }, () => import("./maintenance/jobs/queues-clean/maintenance.queues-clean.impl.consumer.js")),
+            loader('maintenance.storage-sync', { kind: 'workers/job', scope: 'consumer' }, () => import("./maintenance/jobs/storage-sync/maintenance.storage-sync.impl.consumer.js"))
+        ],
+        async onRegister(runtime) {
+            await runtime.registerPlugin(consumerServicesPlugin);
+            await runtime.registerPlugin(schedulesConsumerPlugin);
+        }
+    });
+    return {
+        ...common,
+        name: consumer.name,
+        async onRegister(runtime) {
+            await common.onRegister?.(runtime);
+            await consumer.onRegister?.(runtime);
+        }
+    };
+}
+export const createWorkersPlugin = createWorkersConsumerPlugin;
+export default createWorkersConsumerPlugin();
+//# sourceMappingURL=workers.consumer.plugin.js.map

package/dist/workers.consumer.plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workers.consumer.plugin.js","sourceRoot":"","sources":["../src/workers.consumer.plugin.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,mBAAmB,EAAE,MAAM,EAAmB,MAAM,qBAAqB,CAAC;AACnF,OAAO,EAAE,mBAAmB,IAAI,yBAAyB,EAAE,MAAM,qBAAqB,CAAC;AACvF,OAAO,sBAAsB,MAAM,uCAAuC,CAAC;AAC3E,OAAO,uBAAuB,MAAM,6CAA6C,CAAC;AAElF,OAAO,oBAAoB,MAAM,iDAAiD,CAAC;AACnF,OAAO,wBAAwB,MAAM,qDAAqD,CAAC;AAC3F,OAAO,EAAE,gCAAgC,EAAE,MAAM,8DAA8D,CAAC;AAChH,OAAO,EAAE,iCAAiC,EAAE,MAAM,kDAAkD,CAAC;AAErG,MAAM,UAAU,2BAA2B,CAAC,UAAgC,EAAE;IAC7E,MAAM,MAAM,GAAG,yBAAyB,CAAC,OAAO,CAAC,CAAC;IAClD,MAAM,QAAQ,GAAG,mBAAmB,CAAC;QACpC,EAAE,EAAE,MAAM,CAAC,EAAE;QACb,IAAI,EAAE,2BAA2B;QACjC,WAAW,EAAE,CAAC,oBAAoB,EAAE,wBAAwB,EAAE,gCAAgC,EAAE,iCAAiC,CAAC;QAClI,OAAO,EAAE;YACR,MAAM,CAAC,oBAAoB,EAAE,UAAU,EAAE,GAAG,EAAE,CAC7C,MAAM,CAAC,oDAAoD,CAAC,CAC5D;YACD,sFAAsF;YACtF,MAAM,CACL,oBAAoB,EACpB,EAAE,KAAK,EAAE,EAAE,QAAQ,EAAE,CAAC,UAAU,CAAC,EAAE,QAAQ,EAAE,CAAC,QAAQ,CAAC,EAAE,UAAU,EAAE,EAAE,KAAK,EAAE,eAAe,EAAE,EAAE,EAAE,EACnG,GAAG,EAAE,CAAC,MAAM,CAAC,2DAA2D,CAAC,CACzE;YACD,MAAM,CAAC,oCAAoC,EAAE,UAAU,EAAE,GAAG,EAAE,CAC7D,MAAM,CAAC,kDAAkD,CAAC,CAC1D;YACD,MAAM,CAAC,MAAM,EAAE,EAAE,IAAI,EAAE,cAAc,EAAE,KAAK,EAAE,UAAU,EAAE,EAAE,GAAG,EAAE,CAChE,MAAM,CAAC,iCAAiC,CAAC,CACzC;YACD,MAAM,CAAC,0BAA0B,EAAE,EAAE,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE,UAAU,EAAE,EAAE,GAAG,EAAE,CACnF,MAAM,CAAC,2EAA2E,CAAC,CACnF;YACD,MAAM,CAAC,0BAA0B,EAAE,EAAE,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE,UAAU,EAAE,EAAE,GAAG,EAAE,CACnF,MAAM,CAAC,2EAA2E,CAAC,CACnF;SACD;QACD,KAAK,CAAC,UAAU,CAAC,OAAO;YACvB,MAAM,OAAO,CAAC,cAAc,CAAC,sBAAsB,CAAC,CAAC;YACrD,MAAM,OAAO,CAAC,cAAc,CAAC,uBAAuB,CAAC,CAAC;QACvD,CAAC;KACD,CAAC,CAAC;IAEH,OAAO;QACN,GAAG,MAAM;QACT,IAAI,EAAE,QAAQ,CAAC,IAAI;QACnB,KAAK,CAAC,UAAU,CAAC,OAAmB;YACnC,MAAM,MAAM,CAAC,UAAU,EAAE,CAAC,OAAO,CAAC,CAAC;YACnC,MAAM,QAAQ,CAAC,UAAU,EAAE,CAAC,OAAO,CAAC,CAAC;QACtC,CAAC;KACD,CAAC;AACH,CAAC;AAED,MAAM,CAAC,MAAM,mBAAmB,GAAG,2BAA2B,CAAC;AAC/D,eAAe,2BAA2B,EAAE,CAAC"}

package/dist/workers.plugin.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Workers Plugin
+ *
+ * Registers worker, job, and worker/adapter kinds with the runtime.
+ * Workers, jobs, and adapters are discovered via the descriptor pattern:
+ * - Workers: `*.workers.worker.descriptor.ts` with `*.workers.worker.impl.ts`
+ * - Jobs: `*.workers.job.descriptor.ts` with `*.workers.job.impl.ts`
+ * - Adapters: `*.workers.adapter.descriptor.ts` with `*.workers.adapter.impl.ts`
+ */
+import type { WorkersPluginOptions } from './schemas/plugin-options.ts';
+/**
+ * Workers plugin - registers worker kinds with the runtime.
+ *
+ * Kinds registered:
+ * - `workers/worker` - Background task processors with queue bindings
+ * - `workers/job` - Individual job handlers executed by workers
+ * - `workers/adapter` - Queue backend implementations (each provider registers its own)
+ * - `ops/report-slice` - Thin sweep evidence document (Prefer A)
+ * - `ops/alert-rule` - Thin match → action rules (never infra/alerts)
+ *
+ * Workers, jobs, and adapters are auto-discovered via file naming conventions:
+ * - Descriptors: `{id}.workers.worker.descriptor.ts`, `{id}.workers.job.descriptor.ts`, `{id}.workers.adapter.descriptor.ts`
+ * - Implementations: `{id}.workers.worker.impl.ts`, `{id}.workers.job.impl.ts`, `{id}.workers.adapter.impl.ts`
+ * - Scoped implementations: `{id}.workers.worker.impl.cloud.ts`, `{id}.workers.job.impl.consumer.ts`
+ *
+ * @example
+ * ```ts
+ * // `runtime` is the VibesRuntime handed to your host entry or plugin hook.
+ *
+ * // Query workers for current hardware
+ * const workers = runtime.query('workers/worker')
+ *   .forHardware('consumer')
+ *   .enabled()
+ *   .descriptors();
+ *
+ * // Get queue adapter
+ * const adapter = await runtime.query('workers/adapter')
+ *   .forHardware('consumer')
+ *   .resolve();
+ *
+ * const queueAdapter = adapter.getQueueAdapter('my-queue');
+ * await queueAdapter.connect();
+ * ```
+ */
+export declare function createWorkersPlugin(options?: WorkersPluginOptions): import("@vibesdotdev/kernel").RuntimePlugin;
+declare const defaultExport: import("@vibesdotdev/kernel").RuntimePlugin;
+export default defaultExport;
+//# sourceMappingURL=workers.plugin.d.ts.map

package/dist/workers.plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workers.plugin.d.ts","sourceRoot":"","sources":["../src/workers.plugin.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAUH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AA6DxE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAEH,wBAAgB,mBAAmB,CAAC,OAAO,GAAE,oBAAyB,+CAsHrE;AAED,QAAA,MAAM,aAAa,6CAAwB,CAAC;AAE5C,eAAe,aAAa,CAAC"}

package/dist/workers.plugin.js

@@ -0,0 +1,192 @@
+/**
+ * Workers Plugin
+ *
+ * Registers worker, job, and worker/adapter kinds with the runtime.
+ * Workers, jobs, and adapters are discovered via the descriptor pattern:
+ * - Workers: `*.workers.worker.descriptor.ts` with `*.workers.worker.impl.ts`
+ * - Jobs: `*.workers.job.descriptor.ts` with `*.workers.job.impl.ts`
+ * - Adapters: `*.workers.adapter.descriptor.ts` with `*.workers.adapter.impl.ts`
+ */
+import cryptoPlugin from '@vibesdotdev/crypto/plugin';
+import { createRuntimePlugin, loader } from '@vibesdotdev/kernel';
+import { workersAdmissionKind } from "./client/admission.js";
+import { jobKind } from "./kinds/job.js";
+import { workerKind } from "./kinds/worker.js";
+import { flowKind } from "./kinds/flow.js";
+import { usageEmitterKind } from "./kinds/usage-emitter.js";
+import { jobEventBusKind, registerWorkerJobEventBusModules } from "./kinds/job-event-bus.js";
+import { opsReportSliceKind } from "./kinds/ops-report-slice.kind.js";
+import { opsAlertRuleKind } from "./kinds/ops-alert-rule.kind.js";
+import { WorkerAdapterDescriptorSchema, resolveWorkerAdapterKind } from "./schemas/adapter.js";
+import { DefaultWorkerAdapter } from "./adapters/default.js";
+import workersConfigDescriptor from "./config/workers.config.descriptor.js";
+import workersCodeExecutionConfigDescriptor from "./config/workers.code-execution.config.descriptor.js";
+// Flow descriptor (workers/flow kind)
+import flowDescriptor from "./runtime/flow.descriptor.js";
+import jobLedgerRecordDescriptor from "./runtime/ledger/job-ledger.record.descriptor.js";
+// Adapter descriptors
+import memoryAdapterDescriptor from "./adapters/memory/worker-adapter.memory.descriptor.js";
+import { deadLetterStoreKind } from "./dead-letter/dead-letter-store.kind.js";
+import deadLetterRecordDescriptor from "./dead-letter/dead-letter.record.descriptor.js";
+import { dlqReplayJobDescriptor } from "./dead-letter/workers.dlq.replay.job.js";
+import { WORKERS_QUEUE_CAPABILITY_ID, workersQueueCapabilityDescriptor, workersQueueCapabilityExposure, workersQueueCapabilityKind } from "./remote/queue-capability.js";
+// Maintenance worker + jobs
+// `maintenance.desktop-cleanup` is desktop-domain code; it lives in
+// `@vibesdotdev/bridge/desktop` per RUNTIME-FIRST-MODULES.md ("packages/workers
+// owns the abstract worker system. Feature modules own their own
+// workers/job assets when those assets are specific to the feature
+// domain."). The default schedule below still references it by string
+// ID — apps that want desktop-cleanup must also load `@vibesdotdev/
+// desktop/desktop.plugin` so the descriptor + loader register.
+import maintenanceWorker from "./maintenance/maintenance.descriptor.js";
+import dbPrune from "./maintenance/jobs/db-prune/maintenance.db-prune.descriptor.js";
+import queuesClean from "./maintenance/jobs/queues-clean/maintenance.queues-clean.descriptor.js";
+import storageSync from "./maintenance/jobs/storage-sync/maintenance.storage-sync.descriptor.js";
+import opsSweepEmitReportSliceJobDescriptor, { OPS_SWEEP_EMIT_REPORT_SLICE_JOB_ID } from "./ops/emit-report-slice/ops.sweep.emit-report-slice.descriptor.js";
+// Logging
+import workerCoreLogger from "./logging/worker-core.logger.descriptor.js";
+import workerRuntimeLogger from "./logging/worker-runtime.logger.descriptor.js";
+import workerRuntimeOutput from "./logging/worker-runtime.output.descriptor.js";
+// Docs
+import workersKinds from "./docs/workers.kinds.docs.descriptor.js";
+import workersBindings from "./docs/workers.bindings.docs.descriptor.js";
+import workersQueues from "./docs/workers.queues.docs.descriptor.js";
+import workersGraphs from "./docs/workers.graphs.docs.descriptor.js";
+/**
+ * Worker adapter kind definition
+ */
+const workerAdapterKind = {
+    id: 'workers/adapter',
+    descriptorSchema: WorkerAdapterDescriptorSchema,
+    defaultImplementation: DefaultWorkerAdapter,
+    resolve: resolveWorkerAdapterKind
+    // No kind context: an implementation reads `runtime/workspace-path` at use,
+    // so it loads on a host that binds no workspace (C1, C9).
+};
+/**
+ * Workers plugin - registers worker kinds with the runtime.
+ *
+ * Kinds registered:
+ * - `workers/worker` - Background task processors with queue bindings
+ * - `workers/job` - Individual job handlers executed by workers
+ * - `workers/adapter` - Queue backend implementations (each provider registers its own)
+ * - `ops/report-slice` - Thin sweep evidence document (Prefer A)
+ * - `ops/alert-rule` - Thin match → action rules (never infra/alerts)
+ *
+ * Workers, jobs, and adapters are auto-discovered via file naming conventions:
+ * - Descriptors: `{id}.workers.worker.descriptor.ts`, `{id}.workers.job.descriptor.ts`, `{id}.workers.adapter.descriptor.ts`
+ * - Implementations: `{id}.workers.worker.impl.ts`, `{id}.workers.job.impl.ts`, `{id}.workers.adapter.impl.ts`
+ * - Scoped implementations: `{id}.workers.worker.impl.cloud.ts`, `{id}.workers.job.impl.consumer.ts`
+ *
+ * @example
+ * ```ts
+ * // `runtime` is the VibesRuntime handed to your host entry or plugin hook.
+ *
+ * // Query workers for current hardware
+ * const workers = runtime.query('workers/worker')
+ *   .forHardware('consumer')
+ *   .enabled()
+ *   .descriptors();
+ *
+ * // Get queue adapter
+ * const adapter = await runtime.query('workers/adapter')
+ *   .forHardware('consumer')
+ *   .resolve();
+ *
+ * const queueAdapter = adapter.getQueueAdapter('my-queue');
+ * await queueAdapter.connect();
+ * ```
+ */
+// Hoisted const: tsc rewriteRelativeImportExtensions does not rewrite `.ts` specifiers inside `export default <expr>` (TS 6.0.3).
+export function createWorkersPlugin(options = {}) {
+    return createRuntimePlugin({
+        id: 'workers',
+        name: 'Workers Module',
+        description: 'Background task processing with workers, jobs, and queue adapters',
+        dependencies: ['config', 'runtime-client'],
+        kinds: [workersAdmissionKind, workerKind, jobKind, workerAdapterKind, flowKind, usageEmitterKind, jobEventBusKind, opsReportSliceKind, opsAlertRuleKind, deadLetterStoreKind, workersQueueCapabilityKind],
+        descriptors: [
+            workersConfigDescriptor,
+            // The host's queues for a consumer renderer (runtime projection)
+            workersQueueCapabilityDescriptor,
+            workersCodeExecutionConfigDescriptor,
+            // Job history (storage/record)
+            jobLedgerRecordDescriptor,
+            // Adapters
+            memoryAdapterDescriptor,
+            // Dead letters
+            deadLetterRecordDescriptor,
+            dlqReplayJobDescriptor,
+            // Flow (workers/flow)
+            flowDescriptor,
+            // Feature-specific maintenance jobs are registered by their canonical owners.
+            maintenanceWorker,
+            dbPrune,
+            queuesClean,
+            storageSync,
+            opsSweepEmitReportSliceJobDescriptor,
+            // Logging
+            workerCoreLogger,
+            workerRuntimeLogger,
+            workerRuntimeOutput,
+            // Docs
+            workersKinds,
+            workersBindings,
+            workersQueues,
+            workersGraphs
+        ],
+        loaders: [
+            // Adapters
+            loader('worker-adapter.memory', () => import("./adapters/memory/worker-adapter.memory.impl.js")),
+            loader('workers.dlq.replay', { kind: 'workers/job' }, () => import("./dead-letter/workers.dlq.replay.job.js")),
+            // Flow implementations are contributed by scoped plugins.
+            // Maintenance
+            loader('maintenance', () => import("./maintenance/maintenance.impl.js")),
+            loader('maintenance.db-prune', 'cloud', () => import("./maintenance/jobs/db-prune/maintenance.db-prune.impl.cloud.js")),
+            // maintenance.desktop-cleanup loader is registered from @vibesdotdev/bridge/desktop
+            loader('maintenance.queues-clean', 'cloud', () => import("./maintenance/jobs/queues-clean/maintenance.queues-clean.impl.cloud.js")),
+            loader(OPS_SWEEP_EMIT_REPORT_SLICE_JOB_ID, { kind: 'workers/job' }, () => import("./ops/emit-report-slice/ops.sweep.emit-report-slice.impl.js")),
+            // Host surfaces only: a renderer's own `workers/adapter` forwards to this capability.
+            loader(WORKERS_QUEUE_CAPABILITY_ID, { kind: workersQueueCapabilityKind.id, scope: 'worker.cli.tui.mcp.agent' }, () => import("./remote/queue-capability.impl.js"))
+        ],
+        remoteExposures: [
+            {
+                kindId: workersQueueCapabilityKind.id,
+                assetId: WORKERS_QUEUE_CAPABILITY_ID,
+                exposure: workersQueueCapabilityExposure
+            }
+        ],
+        onActivate(runtime) {
+            registerWorkerJobEventBusModules(runtime, options.jobEventBusModules ?? []);
+            // Canonical Workers client (`runtime/client` kind). Consumers resolve
+            // via the `getWorkersClient(runtime)` helper on the runtime
+            // they were handed. Replaces `pm.workers.*`, direct
+            // `createIPCAdapter`/`BunIPCAdapter` construction, and
+            // `getRuntimeJobQueue` callers.
+            runtime.registerDescriptor('runtime/client', {
+                id: 'workers',
+                kind: 'runtime/client',
+                description: 'Canonical Workers client — enqueue/getQueue with kernel-selected adapter.'
+            });
+            runtime.registerLoader('runtime/client', 'workers', async () => {
+                const { WorkersClient } = await import("./client/runtime-client.js");
+                return { impl: WorkersClient };
+            });
+        },
+        async onRegister(runtime) {
+            const { memoryQueuesPlugin } = await import("./adapters/memory/common/memory-root-store.js");
+            await runtime.registerPlugin(memoryQueuesPlugin);
+            // Keyed dispatch hashes through the runtime's `crypto/hash` implementation (core/keyed-dispatch.ts).
+            await runtime.registerPlugin(cryptoPlugin);
+            runtime.registerDescriptor('runtime/client', { kind: 'runtime/client', id: 'workers.circuit-breakers' });
+            runtime.registerLoader('runtime/client', 'workers.circuit-breakers', async () => {
+                const { CircuitBreakersClient } = await import("./core/circuit-breaker.js");
+                return { impl: CircuitBreakersClient };
+            });
+            await runtime.query('runtime/client').withId('workers.circuit-breakers').resolve();
+        }
+    });
+}
+const defaultExport = createWorkersPlugin();
+export default defaultExport;
+//# sourceMappingURL=workers.plugin.js.map

package/dist/workers.plugin.js.map

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