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

package/dist/helpers/testing/worker-test-utils.js

@@ -0,0 +1,195 @@
+/**
+ * Worker Testing Utilities
+ *
+ * Test harness for easy worker testing with in-memory provider
+ */
+import * as z from 'zod/v4';
+import { InMemoryAdapter } from "../../adapters/memory/provider.js";
+import { jobWriteGuard } from "../../core/queue-adapter.js";
+import { settle } from "../../core/settle.js";
+export const ProgressPayloadSchema = z.record(z.string(), z.unknown());
+export const EventPayloadSchema = z.record(z.string(), z.unknown());
+export const EventMetadataSchema = z.record(z.string(), z.unknown());
+export class WorkerTestHarness {
+    worker;
+    provider;
+    constructor(worker, runtime) {
+        this.worker = worker;
+        this.provider = new InMemoryAdapter('memory-queue', runtime);
+    }
+    /**
+     * Submit a job to the queue
+     */
+    async submitJob(data, options) {
+        return await this.provider.enqueue(data, options);
+    }
+    /**
+     * Submit multiple jobs
+     */
+    async submitJobs(jobs) {
+        const jobIds = [];
+        for (const data of jobs) {
+            jobIds.push(await this.submitJob(data));
+        }
+        return jobIds;
+    }
+    /**
+     * Process next job in queue
+     */
+    async processNextJob() {
+        const job = await this.provider.dequeue();
+        if (!job) {
+            throw new Error('No jobs in queue');
+        }
+        const claim = job.executionClaim;
+        if (claim.state !== 'held')
+            throw new Error('The test queue did not admit an execution claim');
+        const guard = jobWriteGuard(job);
+        try {
+            if (!this.worker.process)
+                throw new Error('Worker under test does not implement process method');
+            const result = await this.worker.process(job, this.createMockEvents());
+            await this.provider.updateJob(job.id, { status: 'completed', result }, guard);
+            return result;
+        }
+        catch (error) {
+            await settle(() => this.provider.updateJob(job.id, { status: 'failed', error: String(error) }, guard));
+            throw error;
+        }
+        finally {
+            await this.provider.releaseExecution(job.id, claim.identity);
+        }
+    }
+    /**
+     * Process all jobs in queue
+     */
+    async processAllJobs() {
+        const results = [];
+        let metrics = await this.provider.getMetrics();
+        while (metrics.waiting > 0 || metrics.active > 0) {
+            const outcome = await settle(() => this.processNextJob());
+            if (outcome.ok) {
+                results.push(outcome.value);
+            }
+            metrics = await this.provider.getMetrics();
+        }
+        return results;
+    }
+    /**
+     * Process job and expect failure
+     */
+    async processJobExpectingFailure(errorMatcher) {
+        const outcome = await settle(() => this.processNextJob());
+        if (outcome.ok) {
+            throw new Error('Expected job to fail but it succeeded');
+        }
+        const error = outcome.thrown instanceof Error
+            ? outcome.thrown
+            : new Error(outcome.caught instanceof Error
+                ? outcome.caught.message
+                : outcome.caught.description);
+        if (errorMatcher) {
+            const matcher = errorMatcher instanceof RegExp ? errorMatcher.source : errorMatcher;
+            if (!error.message.includes(matcher)) {
+                throw new Error(`Expected error message to contain "${matcher}" but got: ${error.message}`);
+            }
+        }
+        return error;
+    }
+    /**
+     * Get job by ID
+     */
+    async getJob(jobId) {
+        return await this.provider.getJob(jobId);
+    }
+    /**
+     * Get all jobs
+     */
+    getAllJobs() {
+        return this.provider.getAllJobs();
+    }
+    /**
+     * Get queue metrics
+     */
+    async getMetrics() {
+        return await this.provider.getMetrics();
+    }
+    /**
+     * Wait for job to complete
+     */
+    async waitForJob(jobId, options = {}) {
+        const { timeout = 5000, interval = 100 } = options;
+        const start = Date.now();
+        while (Date.now() - start < timeout) {
+            const job = await this.getJob(jobId);
+            if (job && (job.status === 'completed' || job.status === 'failed')) {
+                return job;
+            }
+            await new Promise((resolve) => setTimeout(resolve, interval));
+        }
+        throw new Error(`Job ${jobId} did not complete within ${timeout}ms`);
+    }
+    /**
+     * Clear all jobs
+     */
+    clear() {
+        this.provider.clear();
+    }
+    /**
+     * Create mock event emitter for testing
+     */
+    createMockEvents() {
+        const progressEvents = [];
+        const consumerEvents = [];
+        const stateEvents = [];
+        return {
+            emitProgress: (progress, metadata) => {
+                progressEvents.push({ progress, metadata });
+            },
+            emitConsumerEvent: (eventType, payload) => {
+                consumerEvents.push({ eventType, payload });
+            },
+            emitStateChange: (state, data) => {
+                stateEvents.push({ state, data });
+            },
+            _getProgressEvents: () => progressEvents,
+            _getConsumerEvents: () => consumerEvents,
+            _getStateEvents: () => stateEvents
+        };
+    }
+    /**
+     * Assert job status
+     */
+    async assertJobStatus(jobId, expectedStatus) {
+        const job = await this.getJob(jobId);
+        if (!job) {
+            throw new Error(`Job ${jobId} not found`);
+        }
+        if (job.status !== expectedStatus) {
+            throw new Error(`Expected job ${jobId} to have status ${expectedStatus} but got ${job.status}`);
+        }
+    }
+    /**
+     * Assert metrics
+     */
+    async assertMetrics(expected) {
+        const actual = await this.getMetrics();
+        for (const [key, value] of Object.entries(expected)) {
+            // SAFETY: Key is derived from expected metric properties
+            const metricKey = key;
+            if (actual[metricKey] !== value) {
+                throw new Error(`Expected ${key} to be ${value} but got ${actual[metricKey]}`);
+            }
+        }
+    }
+}
+/**
+ * Create an in-memory **job-queue** test harness for abstract workers/jobs.
+ *
+ * NOT Cloudflare Wrangler. For production Worker integration tests use:
+ * `import { createTestHarness } from 'wrangler'` (see docs/runbooks/worker-integration-test-harness.md).
+ */
+export function createJobTestHarness(worker, runtime) {
+    return new WorkerTestHarness(worker, runtime);
+}
+//# sourceMappingURL=worker-test-utils.js.map

package/dist/helpers/testing/worker-test-utils.js.map

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

package/dist/host-runtime.d.ts

@@ -0,0 +1,9 @@
+import type { VibesRuntime } from '@vibesdotdev/kernel';
+import type { WorkerRuntime } from './runtime/worker-runtime.ts';
+/**
+ * Build a worker host from the descriptors already composed in a runtime.
+ * The host's declared `scope.hardware` selects the workers and the adapter;
+ * host applications select only queue visibility.
+ */
+export declare function createWorkerHostRuntime(runtime: VibesRuntime, queueIds: ReadonlySet<string>): Promise<WorkerRuntime>;
+//# sourceMappingURL=host-runtime.d.ts.map

package/dist/host-runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"host-runtime.d.ts","sourceRoot":"","sources":["../src/host-runtime.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAGxD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAajE;;;;GAIG;AACH,wBAAsB,uBAAuB,CAC5C,OAAO,EAAE,YAAY,EACrB,QAAQ,EAAE,WAAW,CAAC,MAAM,CAAC,GAC3B,OAAO,CAAC,aAAa,CAAC,CAYxB"}

package/dist/host-runtime.js

@@ -0,0 +1,27 @@
+function selectQueues(workers, queueIds) {
+    if (queueIds.size === 0)
+        return workers;
+    return workers.filter((worker) => {
+        const queue = worker.descriptor.queue;
+        return queue ? queueIds.has(queue) : false;
+    });
+}
+/**
+ * Build a worker host from the descriptors already composed in a runtime.
+ * The host's declared `scope.hardware` selects the workers and the adapter;
+ * host applications select only queue visibility.
+ */
+export async function createWorkerHostRuntime(runtime, queueIds) {
+    const workers = await runtime
+        .query('workers/worker')
+        .forHardware(runtime.scope.hardware)
+        .enabled()
+        .all();
+    const selected = selectQueues(workers, queueIds);
+    const { createWorkerEntrypoint } = await import("./public/entrypoint.js");
+    return createWorkerEntrypoint(runtime, selected, {
+        verbose: true,
+        servesAllQueues: queueIds.size === 0
+    });
+}
+//# sourceMappingURL=host-runtime.js.map

package/dist/host-runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"host-runtime.js","sourceRoot":"","sources":["../src/host-runtime.ts"],"names":[],"mappings":"AAKA,SAAS,YAAY,CACpB,OAA+B,EAC/B,QAA6B;IAE7B,IAAI,QAAQ,CAAC,IAAI,KAAK,CAAC;QAAE,OAAO,OAAO,CAAC;IACxC,OAAO,OAAO,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE;QAChC,MAAM,KAAK,GAAG,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC;QACtC,OAAO,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;IAC5C,CAAC,CAAC,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC5C,OAAqB,EACrB,QAA6B;IAE7B,MAAM,OAAO,GAAG,MAAM,OAAO;SAC3B,KAAK,CAA8C,gBAAgB,CAAC;SACpE,WAAW,CAAC,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC;SACnC,OAAO,EAAE;SACT,GAAG,EAAE,CAAC;IACR,MAAM,QAAQ,GAAG,YAAY,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IACjD,MAAM,EAAE,sBAAsB,EAAE,GAAG,MAAM,MAAM,CAAC,wBAAwB,CAAC,CAAC;IAC1E,OAAO,sBAAsB,CAAC,OAAO,EAAE,QAAQ,EAAE;QAChD,OAAO,EAAE,IAAI;QACb,eAAe,EAAE,QAAQ,CAAC,IAAI,KAAK,CAAC;KACpC,CAAC,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Workers - Public Exports
+ *
+ * ONLY exports types safe for any build context.
+ *
+ * NOTE: Consumer-runtime helpers (getLocalWorkers, getLocalHandlerModulePaths)
+ * are NOT exported from this barrel because they import worker manifests
+ * which have node/filesystem dependencies. Import directly from
+ * './public/helpers.js' for consumer-runtime usage.
+ */
+export type { Worker, WorkerConfig } from './core/worker.ts';
+export type { JobHandler, JobHandlerConfig, JobContext, IsolationMode } from './core/job-handler.ts';
+export { WorkerAdapterDescriptorSchema, WorkerAdapterCapabilitiesSchema, WorkerAdapterRequirementsSchema, type WorkerAdapterDescriptor, type WorkerAdapterCapabilities, type WorkerAdapterRequirements } from './schemas/index.ts';
+export { CancellationSourceSchema, CancellationSchema, CancellationAttributionSchema, CancelJobOptionsSchema, type Cancellation, type CancellationAttribution, type CancelJobOptions } from './schemas/index.ts';
+export type { WorkerAdapterInterface, WorkerAdapterContext } from './interfaces/index.ts';
+export { WorkerJobEventBusDescriptorSchema, type WorkerJobEventBus, type WorkerJobEventBusDescriptor, type WorkerJobEventBusModule } from './kinds/job-event-bus.ts';
+export { publishWorkerJobEvent } from './core/job-event-publisher.ts';
+export { OPS_REPORT_SLICE_KIND_ID, opsReportSliceKind } from './kinds/ops-report-slice.kind.ts';
+export { OPS_ALERT_RULE_KIND_ID, opsAlertRuleKind } from './kinds/ops-alert-rule.kind.ts';
+export { OpsReportSliceDocumentSchema, OpsReportSliceDescriptorSchema, OpsAlertRuleDescriptorSchema, type OpsReportSliceDocument, type OpsReportSliceDescriptor, type OpsAlertRuleDescriptor } from './schemas/index.ts';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,YAAY,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAC7D,YAAY,EAAE,UAAU,EAAE,gBAAgB,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAGrG,OAAO,EACN,6BAA6B,EAC7B,+BAA+B,EAC/B,+BAA+B,EAC/B,KAAK,uBAAuB,EAC5B,KAAK,yBAAyB,EAC9B,KAAK,yBAAyB,EAC9B,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EAAE,wBAAwB,EAAE,kBAAkB,EAAE,6BAA6B,EAAE,sBAAsB,EAAE,KAAK,YAAY,EAAE,KAAK,uBAAuB,EAAE,KAAK,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAGjN,YAAY,EAAE,sBAAsB,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAC1F,OAAO,EACN,iCAAiC,EACjC,KAAK,iBAAiB,EACtB,KAAK,2BAA2B,EAChC,KAAK,uBAAuB,EAC5B,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AAEtE,OAAO,EACN,wBAAwB,EACxB,kBAAkB,EAClB,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EACN,sBAAsB,EACtB,gBAAgB,EAChB,MAAM,gCAAgC,CAAC;AACxC,OAAO,EACN,4BAA4B,EAC5B,8BAA8B,EAC9B,4BAA4B,EAC5B,KAAK,sBAAsB,EAC3B,KAAK,wBAAwB,EAC7B,KAAK,sBAAsB,EAC3B,MAAM,oBAAoB,CAAC"}

package/dist/index.js

@@ -0,0 +1,20 @@
+/**
+ * Workers - Public Exports
+ *
+ * ONLY exports types safe for any build context.
+ *
+ * NOTE: Consumer-runtime helpers (getLocalWorkers, getLocalHandlerModulePaths)
+ * are NOT exported from this barrel because they import worker manifests
+ * which have node/filesystem dependencies. Import directly from
+ * './public/helpers.js' for consumer-runtime usage.
+ */
+// Schemas
+export { WorkerAdapterDescriptorSchema, WorkerAdapterCapabilitiesSchema, WorkerAdapterRequirementsSchema } from "./schemas/index.js";
+// Cancellation provenance
+export { CancellationSourceSchema, CancellationSchema, CancellationAttributionSchema, CancelJobOptionsSchema } from "./schemas/index.js";
+export { WorkerJobEventBusDescriptorSchema } from "./kinds/job-event-bus.js";
+export { publishWorkerJobEvent } from "./core/job-event-publisher.js";
+export { OPS_REPORT_SLICE_KIND_ID, opsReportSliceKind } from "./kinds/ops-report-slice.kind.js";
+export { OPS_ALERT_RULE_KIND_ID, opsAlertRuleKind } from "./kinds/ops-alert-rule.kind.js";
+export { OpsReportSliceDocumentSchema, OpsReportSliceDescriptorSchema, OpsAlertRuleDescriptorSchema } from "./schemas/index.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAMH,UAAU;AACV,OAAO,EACN,6BAA6B,EAC7B,+BAA+B,EAC/B,+BAA+B,EAI/B,MAAM,oBAAoB,CAAC;AAE5B,0BAA0B;AAC1B,OAAO,EAAE,wBAAwB,EAAE,kBAAkB,EAAE,6BAA6B,EAAE,sBAAsB,EAA0E,MAAM,oBAAoB,CAAC;AAIjN,OAAO,EACN,iCAAiC,EAIjC,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AAEtE,OAAO,EACN,wBAAwB,EACxB,kBAAkB,EAClB,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EACN,sBAAsB,EACtB,gBAAgB,EAChB,MAAM,gCAAgC,CAAC;AACxC,OAAO,EACN,4BAA4B,EAC5B,8BAA8B,EAC9B,4BAA4B,EAI5B,MAAM,oBAAoB,CAAC"}

package/dist/interfaces/adapter.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Worker Adapter Interface
+ *
+ * Interface for worker/adapter implementations.
+ * Wraps the QueueAdapter with runtime context awareness.
+ */
+import type { VibesRuntime } from '@vibesdotdev/kernel';
+import type { KindContext } from '@vibesdotdev/kernel/schemas/kind';
+import type { QueueAdapter } from '../core/queue-adapter.ts';
+import type { WorkerAdapterDescriptor } from '../schemas/adapter.ts';
+/**
+ * Context provided to worker adapter implementations
+ */
+export interface WorkerAdapterContext extends KindContext {
+    /**
+     * Runtime reference. The workspace is not a kind context: an adapter that
+     * needs it reads `runtime/workspace-path` at use (C9).
+     */
+    readonly runtime: VibesRuntime;
+}
+/**
+ * Worker adapter interface - wraps QueueAdapter with runtime integration
+ */
+export interface WorkerAdapterInterface<TJob = unknown, TResult = unknown> {
+    /** Adapter identifier */
+    readonly id: string;
+    /** Descriptor for this adapter */
+    readonly descriptor: WorkerAdapterDescriptor;
+    /**
+     * Get the underlying queue adapter instance for a specific queue.
+     *
+     * A single worker adapter implementation (e.g. IPC, Kafka) can back many
+     * logical queues. The returned QueueAdapter instance may be cached per queue.
+     */
+    getQueueAdapter(queueName: string, runtime?: VibesRuntime): QueueAdapter<TJob, TResult>;
+    /**
+     * Check if adapter is initialized and connected
+     */
+    isConnected(): boolean;
+    /**
+     * Initialize and connect the adapter
+     */
+    connect(runtime?: VibesRuntime): Promise<void>;
+    /**
+     * Disconnect the adapter
+     */
+    disconnect(): Promise<void>;
+}
+//# sourceMappingURL=adapter.d.ts.map

package/dist/interfaces/adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../src/interfaces/adapter.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kCAAkC,CAAC;AACpE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAErE;;GAEG;AACH,MAAM,WAAW,oBAAqB,SAAQ,WAAW;IACxD;;;OAGG;IACH,QAAQ,CAAC,OAAO,EAAE,YAAY,CAAC;CAC/B;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB,CAAC,IAAI,GAAG,OAAO,EAAE,OAAO,GAAG,OAAO;IACxE,yBAAyB;IACzB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IAEpB,kCAAkC;IAClC,QAAQ,CAAC,UAAU,EAAE,uBAAuB,CAAC;IAE7C;;;;;OAKG;IACH,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAExF;;OAEG;IACH,WAAW,IAAI,OAAO,CAAC;IAEvB;;OAEG;IACH,OAAO,CAAC,OAAO,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE/C;;OAEG;IACH,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5B"}

package/dist/interfaces/adapter.js

@@ -0,0 +1,8 @@
+/**
+ * Worker Adapter Interface
+ *
+ * Interface for worker/adapter implementations.
+ * Wraps the QueueAdapter with runtime context awareness.
+ */
+export {};
+//# sourceMappingURL=adapter.js.map

package/dist/interfaces/adapter.js.map

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

package/dist/interfaces/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Workers Interfaces
+ *
+ * Interface definitions for worker kinds.
+ */
+export type { WorkerAdapterInterface, WorkerAdapterContext } from './adapter.ts';
+//# sourceMappingURL=index.d.ts.map

package/dist/interfaces/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/interfaces/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,YAAY,EAAE,sBAAsB,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC"}

package/dist/interfaces/index.js

@@ -0,0 +1,7 @@
+/**
+ * Workers Interfaces
+ *
+ * Interface definitions for worker kinds.
+ */
+export {};
+//# sourceMappingURL=index.js.map

package/dist/interfaces/index.js.map

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

package/dist/kinds/flow.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Flow Kind Definition
+ */
+import * as z from 'zod/v4';
+import type { KindContext, RuntimeDescriptor } from '@vibesdotdev/kernel/schemas/kind';
+import type { RuntimeScope } from '@vibesdotdev/kernel/schemas/scope';
+import type { Flow, FlowSpawnOptions } from '../runtime/schemas/index.ts';
+import type { SubtaskEventStream } from '../core/job-handler.ts';
+import type { FlowDescriptor } from './schemas/index.ts';
+export type { FlowDescriptor } from './schemas/index.ts';
+declare class DefaultFlowImplementation implements Flow {
+    readonly id: string;
+    readonly descriptor: FlowDescriptor;
+    constructor(descriptor: RuntimeDescriptor, _context: KindContext);
+    private fail;
+    spawn<TChildData = unknown>(_type: string, _data: TChildData, _options?: FlowSpawnOptions): Promise<string>;
+    wait<TChildResult = unknown>(_jobId: string): Promise<TChildResult>;
+    spawnMany<TChildData = unknown>(_jobs: Array<{
+        type: string;
+        data: TChildData;
+        options?: FlowSpawnOptions;
+    }>): Promise<string[]>;
+    spawnWithEvents<TChildData = unknown, TChildResult = unknown>(_type: string, _data: TChildData, _options?: FlowSpawnOptions): SubtaskEventStream<TChildResult>;
+    fire<TData = unknown>(_type: string, _data: TData, _options?: FlowSpawnOptions): Promise<string>;
+}
+declare function resolveFlow(candidates: RuntimeDescriptor[], scope: RuntimeScope): RuntimeDescriptor | undefined;
+export declare const flowKind: {
+    id: string;
+    descriptorSchema: z.ZodObject<{
+        [x: string]: any;
+    }, z.core.$strip>;
+    defaultImplementation: typeof DefaultFlowImplementation;
+    resolve: typeof resolveFlow;
+    contexts: never[];
+};
+//# sourceMappingURL=flow.d.ts.map

package/dist/kinds/flow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flow.d.ts","sourceRoot":"","sources":["../../src/kinds/flow.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAE5B,OAAO,KAAK,EAEX,WAAW,EACX,iBAAiB,EACjB,MAAM,kCAAkC,CAAC;AAC1C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mCAAmC,CAAC;AAEtE,OAAO,KAAK,EAAE,IAAI,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAC1E,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AACjE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEzD,YAAY,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AASzD,cAAM,yBAA0B,YAAW,IAAI;IAC9C,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,UAAU,EAAE,cAAc,CAAC;gBAExB,UAAU,EAAE,iBAAiB,EAAE,QAAQ,EAAE,WAAW;IAQhE,OAAO,CAAC,IAAI;IAQZ,KAAK,CAAC,UAAU,GAAG,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,QAAQ,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,MAAM,CAAC;IAG3G,IAAI,CAAC,YAAY,GAAG,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAGnE,SAAS,CAAC,UAAU,GAAG,OAAO,EAC7B,KAAK,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,UAAU,CAAC;QAAC,OAAO,CAAC,EAAE,gBAAgB,CAAA;KAAE,CAAC,GAC1E,OAAO,CAAC,MAAM,EAAE,CAAC;IAGpB,eAAe,CAAC,UAAU,GAAG,OAAO,EAAE,YAAY,GAAG,OAAO,EAC3D,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,UAAU,EACjB,QAAQ,CAAC,EAAE,gBAAgB,GACzB,kBAAkB,CAAC,YAAY,CAAC;IAGnC,IAAI,CAAC,KAAK,GAAG,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,MAAM,CAAC;CAGhG;AAED,iBAAS,WAAW,CACnB,UAAU,EAAE,iBAAiB,EAAE,EAC/B,KAAK,EAAE,YAAY,GACjB,iBAAiB,GAAG,SAAS,CAoB/B;AAED,eAAO,MAAM,QAAQ;;;;;;;;CAMY,CAAC"}

package/dist/kinds/flow.js

@@ -0,0 +1,71 @@
+/**
+ * Flow Kind Definition
+ */
+import * as z from 'zod/v4';
+import { CapabilityError } from '@vibesdotdev/kernel';
+import { FlowDescriptorSchema } from "../schemas/descriptors.js";
+const HardwareArraySchema = z.array(z.string());
+function readDescriptorHardware(descriptor) {
+    const parsed = HardwareArraySchema.safeParse(descriptor.hardware);
+    return parsed.success ? parsed.data : undefined;
+}
+class DefaultFlowImplementation {
+    id;
+    descriptor;
+    constructor(descriptor, _context) {
+        this.id = descriptor.id;
+        this.descriptor = {
+            ...descriptor,
+            kind: 'workers/flow'
+        };
+    }
+    fail(method) {
+        throw new CapabilityError(`No implementation registered for workers/flow '${this.id}' (called ${method}). ` +
+            `Register a per-scope implementation via runtime.registerLoader('workers/flow', '${this.id}', '<scope>', loader).`, 'UNAVAILABLE', { reason: 'workers-flow-unavailable', details: { flowId: this.id, method } });
+    }
+    spawn(_type, _data, _options) {
+        this.fail('spawn');
+    }
+    wait(_jobId) {
+        this.fail('wait');
+    }
+    spawnMany(_jobs) {
+        this.fail('spawnMany');
+    }
+    spawnWithEvents(_type, _data, _options) {
+        this.fail('spawnWithEvents');
+    }
+    fire(_type, _data, _options) {
+        this.fail('fire');
+    }
+}
+function resolveFlow(candidates, scope) {
+    if (candidates.length === 0)
+        return undefined;
+    if (candidates.length === 1)
+        return candidates[0];
+    const hardware = scope.hardware;
+    const matching = candidates.filter((d) => {
+        const descriptorHardware = readDescriptorHardware(d);
+        if (!descriptorHardware || descriptorHardware.length === 0)
+            return true;
+        return descriptorHardware.includes(hardware);
+    });
+    if (matching.length === 0)
+        return undefined;
+    const explicit = matching.filter((d) => {
+        const descriptorHardware = readDescriptorHardware(d);
+        return Boolean(descriptorHardware && descriptorHardware.length > 0);
+    });
+    if (explicit.length > 0)
+        return explicit[0];
+    return matching[0];
+}
+export const flowKind = {
+    id: 'workers/flow',
+    descriptorSchema: FlowDescriptorSchema,
+    defaultImplementation: DefaultFlowImplementation,
+    resolve: resolveFlow,
+    contexts: []
+};
+//# sourceMappingURL=flow.js.map

package/dist/kinds/flow.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"flow.js","sourceRoot":"","sources":["../../src/kinds/flow.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAC5B,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAOtD,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAOjE,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;AAEhD,SAAS,sBAAsB,CAAC,UAA6B;IAC5D,MAAM,MAAM,GAAG,mBAAmB,CAAC,SAAS,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;IAClE,OAAO,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;AACjD,CAAC;AAED,MAAM,yBAAyB;IACrB,EAAE,CAAS;IACX,UAAU,CAAiB;IAEpC,YAAY,UAA6B,EAAE,QAAqB;QAC/D,IAAI,CAAC,EAAE,GAAG,UAAU,CAAC,EAAE,CAAC;QACxB,IAAI,CAAC,UAAU,GAAG;YACjB,GAAG,UAAU;YACb,IAAI,EAAE,cAAc;SACpB,CAAC;IACH,CAAC;IAEO,IAAI,CAAC,MAAc;QAC1B,MAAM,IAAI,eAAe,CACxB,kDAAkD,IAAI,CAAC,EAAE,aAAa,MAAM,KAAK;YAChF,mFAAmF,IAAI,CAAC,EAAE,wBAAwB,EACnH,aAAa,EAAE,EAAE,MAAM,EAAE,0BAA0B,EAAE,OAAO,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,CAC3F,CAAC;IACH,CAAC;IAED,KAAK,CAAuB,KAAa,EAAE,KAAiB,EAAE,QAA2B;QACxF,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACpB,CAAC;IACD,IAAI,CAAyB,MAAc;QAC1C,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACnB,CAAC;IACD,SAAS,CACR,KAA4E;QAE5E,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IACxB,CAAC;IACD,eAAe,CACd,KAAa,EACb,KAAiB,EACjB,QAA2B;QAE3B,IAAI,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;IAC9B,CAAC;IACD,IAAI,CAAkB,KAAa,EAAE,KAAY,EAAE,QAA2B;QAC7E,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACnB,CAAC;CACD;AAED,SAAS,WAAW,CACnB,UAA+B,EAC/B,KAAmB;IAEnB,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IAC9C,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,UAAU,CAAC,CAAC,CAAC,CAAC;IAElD,MAAM,QAAQ,GAAG,KAAK,CAAC,QAAQ,CAAC;IAChC,MAAM,QAAQ,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE;QACxC,MAAM,kBAAkB,GAAG,sBAAsB,CAAC,CAAC,CAAC,CAAC;QACrD,IAAI,CAAC,kBAAkB,IAAI,kBAAkB,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC;QACxE,OAAO,kBAAkB,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IAC9C,CAAC,CAAC,CAAC;IAEH,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IAE5C,MAAM,QAAQ,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE;QACtC,MAAM,kBAAkB,GAAG,sBAAsB,CAAC,CAAC,CAAC,CAAC;QACrD,OAAO,OAAO,CAAC,kBAAkB,IAAI,kBAAkB,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IACrE,CAAC,CAAC,CAAC;IACH,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,QAAQ,CAAC,CAAC,CAAC,CAAC;IAE5C,OAAO,QAAQ,CAAC,CAAC,CAAC,CAAC;AACpB,CAAC;AAED,MAAM,CAAC,MAAM,QAAQ,GAAG;IACvB,EAAE,EAAE,cAAc;IAClB,gBAAgB,EAAE,oBAAoB;IACtC,qBAAqB,EAAE,yBAAyB;IAChD,OAAO,EAAE,WAAW;IACpB,QAAQ,EAAE,EAAE;CACoB,CAAC"}

package/dist/kinds/job-event-bus.d.ts

@@ -0,0 +1,36 @@
+import { type WorkerJobEventBusDescriptor, type WorkerJobEventBusModule } from './schemas/job-event-bus.ts';
+import type { RuntimeDescriptor } from '@vibesdotdev/kernel/schemas/kind';
+import type { RuntimeRef } from '@vibesdotdev/kernel';
+export { WorkerJobEventBusDescriptorSchema, type WorkerJobEventBus, type WorkerJobEventBusDescriptor, type WorkerJobEventBusModule } from './schemas/job-event-bus.ts';
+declare function resolveJobEventBus(candidates: RuntimeDescriptor[], scope: RuntimeRef['scope']): WorkerJobEventBusDescriptor | undefined;
+export declare const jobEventBusKind: {
+    id: string;
+    descriptorSchema: import("zod").ZodObject<{
+        id: import("zod").ZodString;
+        name: import("zod").ZodOptional<import("zod").ZodString>;
+        description: import("zod").ZodOptional<import("zod").ZodString>;
+        tags: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+        hardware: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+        enabled: import("zod").ZodOptional<import("zod").ZodBoolean>;
+        priority: import("zod").ZodOptional<import("zod").ZodNumber>;
+        capabilityId: import("zod").ZodOptional<import("zod").ZodString>;
+        requiredContext: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+        optionalContext: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+        config: import("zod").ZodOptional<import("zod").ZodUnknown>;
+        retention: import("zod").ZodOptional<import("zod").ZodUnion<readonly [import("zod").ZodString, import("zod").ZodObject<{
+            maxAgeDays: import("zod").ZodOptional<import("zod").ZodNumber>;
+            maxEntries: import("zod").ZodOptional<import("zod").ZodNumber>;
+            maxBytes: import("zod").ZodOptional<import("zod").ZodNumber>;
+            cascadeFrom: import("zod").ZodOptional<import("zod").ZodString>;
+            ageField: import("zod").ZodOptional<import("zod").ZodString>;
+            reason: import("zod").ZodString;
+            enforcedBy: import("zod").ZodOptional<import("zod").ZodString>;
+        }, import("zod/v4/core").$strip>]>>;
+        kind: import("zod").ZodLiteral<"workers/job-event-bus">;
+        provider: import("zod").ZodOptional<import("zod").ZodString>;
+    }, import("zod/v4/core").$strip>;
+    resolve: typeof resolveJobEventBus;
+    contexts: never[];
+};
+export declare function registerWorkerJobEventBusModules(runtime: RuntimeRef, modules: readonly WorkerJobEventBusModule[]): void;
+//# sourceMappingURL=job-event-bus.d.ts.map

package/dist/kinds/job-event-bus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"job-event-bus.d.ts","sourceRoot":"","sources":["../../src/kinds/job-event-bus.ts"],"names":[],"mappings":"AAAA,OAAO,EAAqC,KAAK,2BAA2B,EAAE,KAAK,uBAAuB,EAAE,MAAM,4BAA4B,CAAC;AAC/I,OAAO,KAAK,EAAE,iBAAiB,EAAyB,MAAM,kCAAkC,CAAC;AACjG,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAE,iCAAiC,EAAE,KAAK,iBAAiB,EAAE,KAAK,2BAA2B,EAAE,KAAK,uBAAuB,EAAE,MAAM,4BAA4B,CAAC;AAEvK,iBAAS,kBAAkB,CAC1B,UAAU,EAAE,iBAAiB,EAAE,EAC/B,KAAK,EAAE,UAAU,CAAC,OAAO,CAAC,GACxB,2BAA2B,GAAG,SAAS,CAezC;AAED,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAKK,CAAC;AAElC,wBAAgB,gCAAgC,CAC/C,OAAO,EAAE,UAAU,EACnB,OAAO,EAAE,SAAS,uBAAuB,EAAE,GACzC,IAAI,CAYN"}

package/dist/kinds/job-event-bus.js

@@ -0,0 +1,40 @@
+import { WorkerJobEventBusDescriptorSchema } from "./schemas/job-event-bus.js";
+export { WorkerJobEventBusDescriptorSchema } from "./schemas/job-event-bus.js";
+function resolveJobEventBus(candidates, scope) {
+    const compatible = [];
+    for (const candidate of candidates) {
+        const parsed = WorkerJobEventBusDescriptorSchema.safeParse(candidate);
+        if (!parsed.success)
+            continue;
+        if (!parsed.data.hardware?.length || parsed.data.hardware.includes(scope.hardware)) {
+            compatible.push(parsed.data);
+        }
+    }
+    const requestedProvider = scope.hosting.provider;
+    if (requestedProvider) {
+        const provider = compatible.find((candidate) => candidate.provider === requestedProvider);
+        if (provider)
+            return provider;
+    }
+    return compatible.find((candidate) => !candidate.provider) ?? compatible[0];
+}
+export const jobEventBusKind = {
+    id: 'workers/job-event-bus',
+    descriptorSchema: WorkerJobEventBusDescriptorSchema,
+    resolve: resolveJobEventBus,
+    contexts: []
+};
+export function registerWorkerJobEventBusModules(runtime, modules) {
+    const ids = new Set();
+    for (const module of modules) {
+        if (ids.has(module.descriptor.id)) {
+            throw new Error(`Duplicate workers/job-event-bus module '${module.descriptor.id}'`);
+        }
+        ids.add(module.descriptor.id);
+        runtime.registerDescriptor('workers/job-event-bus', module.descriptor);
+        runtime.registerLoader('workers/job-event-bus', module.descriptor.id, async () => ({
+            impl: await module.load(runtime)
+        }));
+    }
+}
+//# sourceMappingURL=job-event-bus.js.map

package/dist/kinds/job-event-bus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"job-event-bus.js","sourceRoot":"","sources":["../../src/kinds/job-event-bus.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iCAAiC,EAAkE,MAAM,4BAA4B,CAAC;AAG/I,OAAO,EAAE,iCAAiC,EAA0F,MAAM,4BAA4B,CAAC;AAEvK,SAAS,kBAAkB,CAC1B,UAA+B,EAC/B,KAA0B;IAE1B,MAAM,UAAU,GAAkC,EAAE,CAAC;IACrD,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;QACpC,MAAM,MAAM,GAAG,iCAAiC,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;QACtE,IAAI,CAAC,MAAM,CAAC,OAAO;YAAE,SAAS;QAC9B,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,EAAE,MAAM,IAAI,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC;YACpF,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAC9B,CAAC;IACF,CAAC;IACD,MAAM,iBAAiB,GAAG,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC;IACjD,IAAI,iBAAiB,EAAE,CAAC;QACvB,MAAM,QAAQ,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,QAAQ,KAAK,iBAAiB,CAAC,CAAC;QAC1F,IAAI,QAAQ;YAAE,OAAO,QAAQ,CAAC;IAC/B,CAAC;IACD,OAAO,UAAU,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,UAAU,CAAC,CAAC,CAAC,CAAC;AAC7E,CAAC;AAED,MAAM,CAAC,MAAM,eAAe,GAAG;IAC9B,EAAE,EAAE,uBAAuB;IAC3B,gBAAgB,EAAE,iCAAiC;IACnD,OAAO,EAAE,kBAAkB;IAC3B,QAAQ,EAAE,EAAE;CACoB,CAAC;AAElC,MAAM,UAAU,gCAAgC,CAC/C,OAAmB,EACnB,OAA2C;IAE3C,MAAM,GAAG,GAAG,IAAI,GAAG,EAAU,CAAC;IAC9B,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC9B,IAAI,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,UAAU,CAAC,EAAE,CAAC,EAAE,CAAC;YACnC,MAAM,IAAI,KAAK,CAAC,2CAA2C,MAAM,CAAC,UAAU,CAAC,EAAE,GAAG,CAAC,CAAC;QACrF,CAAC;QACD,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC;QAC9B,OAAO,CAAC,kBAAkB,CAAC,uBAAuB,EAAE,MAAM,CAAC,UAAU,CAAC,CAAC;QACvE,OAAO,CAAC,cAAc,CAAC,uBAAuB,EAAE,MAAM,CAAC,UAAU,CAAC,EAAE,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC;YAClF,IAAI,EAAE,MAAM,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC;SAChC,CAAC,CAAC,CAAC;IACL,CAAC;AACF,CAAC"}

package/dist/kinds/job.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Job Kind Definition
+ */
+import * as z from 'zod/v4';
+import type { KindContext, RuntimeDescriptor } from '@vibesdotdev/kernel/schemas/kind';
+import type { RuntimeScope } from '@vibesdotdev/kernel/schemas/scope';
+import type { JsonObject, JsonValue } from '@vibesdotdev/kernel/schemas/json';
+import { type JobAssetDescriptor, type JobType, type JobIsolation } from '../schemas/descriptors.ts';
+import type { JobExecutionContext, JobImplementation } from './schemas/index.ts';
+export type { JobExecutionContext, JobExecutionEvents, JobSpawnOptions, JobExecutionSubtasks, JobImplementation, JobKindContext, JobDescriptor } from './schemas/index.ts';
+declare class DefaultJobImplementation implements JobImplementation<JsonObject, JsonValue> {
+    readonly id: string;
+    readonly descriptor: JobAssetDescriptor;
+    readonly type: JobType;
+    readonly isolation: JobIsolation;
+    constructor(descriptor: RuntimeDescriptor, _context: KindContext);
+    handle(_context: JobExecutionContext): Promise<JsonValue>;
+}
+declare function resolveJob(candidates: RuntimeDescriptor[], scope: RuntimeScope): RuntimeDescriptor | undefined;
+export declare const jobKind: {
+    id: string;
+    descriptorSchema: z.ZodPipe<z.ZodObject<{
+        [x: string]: any;
+    }, z.core.$strip>, z.ZodTransform<JobAssetDescriptor, Record<string, unknown>>>;
+    defaultImplementation: typeof DefaultJobImplementation;
+    resolve: typeof resolveJob;
+};
+//# sourceMappingURL=job.d.ts.map

package/dist/kinds/job.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"job.d.ts","sourceRoot":"","sources":["../../src/kinds/job.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAC5B,OAAO,KAAK,EAEX,WAAW,EACX,iBAAiB,EACjB,MAAM,kCAAkC,CAAC;AAC1C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mCAAmC,CAAC;AACtE,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,kCAAkC,CAAC;AAC9E,OAAO,EAAuB,KAAK,kBAAkB,EAAE,KAAK,OAAO,EAAE,KAAK,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAC1H,OAAO,KAAK,EACX,mBAAmB,EACnB,iBAAiB,EACjB,MAAM,oBAAoB,CAAC;AAE5B,YAAY,EACX,mBAAmB,EACnB,kBAAkB,EAClB,eAAe,EACf,oBAAoB,EACpB,iBAAiB,EACjB,cAAc,EACd,aAAa,EACb,MAAM,oBAAoB,CAAC;AAS5B,cAAM,wBAAyB,YAAW,iBAAiB,CAAC,UAAU,EAAE,SAAS,CAAC;IACjF,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,UAAU,EAAE,kBAAkB,CAAC;IACxC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,SAAS,EAAE,YAAY,CAAC;gBAErB,UAAU,EAAE,iBAAiB,EAAE,QAAQ,EAAE,WAAW;IAQhE,MAAM,CAAC,QAAQ,EAAE,mBAAmB,GAAG,OAAO,CAAC,SAAS,CAAC;CAMzD;AAED,iBAAS,UAAU,CAAC,UAAU,EAAE,iBAAiB,EAAE,EAAE,KAAK,EAAE,YAAY,GAAG,iBAAiB,GAAG,SAAS,CAoBvG;AAED,eAAO,MAAM,OAAO;;;;;;;CAOa,CAAC"}