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

package/dist/adapters/ipc/internal/rpc/event-stream.d.ts

@@ -0,0 +1,28 @@
+import * as z from 'zod/v4';
+import { type RuntimeRef } from '@vibesdotdev/kernel';
+import { type JsonValue } from '@vibesdotdev/kernel/schemas/json';
+declare const WorkerEventReplayGapSchema: z.ZodObject<{
+    reason: z.ZodEnum<{
+        expired: "expired";
+        "cursor-ahead": "cursor-ahead";
+    }>;
+    requestedLastEventId: z.ZodNumber;
+    oldestAvailableEventId: z.ZodNumber;
+    latestEventId: z.ZodNumber;
+}, z.core.$strip>;
+export type WorkerEventReplayGap = z.infer<typeof WorkerEventReplayGapSchema>;
+interface WorkerEventStreamOptions {
+    /** The runtime whose socket service connects. */
+    runtime: RuntimeRef;
+    socketPath: string;
+    signal: AbortSignal;
+    /** Handshake timeout in ms for opening the Unix socket connection. */
+    timeoutMs?: number;
+    /** One event the server published, as its frame carried it. */
+    onEvent: (event: JsonValue) => void;
+    onOpen?: () => void;
+    onReplayGap?: (gap: WorkerEventReplayGap) => void;
+}
+export declare function runWorkerEventStream(options: WorkerEventStreamOptions): Promise<void>;
+export {};
+//# sourceMappingURL=event-stream.d.ts.map

package/dist/adapters/ipc/internal/rpc/event-stream.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-stream.d.ts","sourceRoot":"","sources":["../../../../../src/adapters/ipc/internal/rpc/event-stream.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAE5B,OAAO,EAAoB,KAAK,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACxE,OAAO,EAAmB,KAAK,SAAS,EAAE,MAAM,kCAAkC,CAAC;AAUnF,QAAA,MAAM,0BAA0B;;;;;;;;iBAK9B,CAAC;AACH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAa9E,UAAU,wBAAwB;IACjC,iDAAiD;IACjD,OAAO,EAAE,UAAU,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,WAAW,CAAC;IACpB,sEAAsE;IACtE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,+DAA+D;IAC/D,OAAO,EAAE,CAAC,KAAK,EAAE,SAAS,KAAK,IAAI,CAAC;IACpC,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;IACpB,WAAW,CAAC,EAAE,CAAC,GAAG,EAAE,oBAAoB,KAAK,IAAI,CAAC;CAClD;AAiBD,wBAAsB,oBAAoB,CAAC,OAAO,EAAE,wBAAwB,GAAG,OAAO,CAAC,IAAI,CAAC,CA0D3F"}

package/dist/adapters/ipc/internal/rpc/event-stream.js

@@ -0,0 +1,115 @@
+import * as z from 'zod/v4';
+import { connectUnix } from '@vibesdotdev/kernel-rpc/unix';
+import { valueFreeFailure } from '@vibesdotdev/kernel';
+import { JsonValueSchema } from '@vibesdotdev/kernel/schemas/json';
+import { wireConsumer, asRefId } from '@vibesdotdev/kernel-rpc';
+import { getLogger } from '@vibesdotdev/logging';
+import { settle, settleSync } from "../../../../core/settle.js";
+const SSE_RECONNECT_BASE_DELAY_MS = 500;
+const SSE_RECONNECT_MAX_DELAY_MS = 5000;
+const DEFAULT_HANDSHAKE_TIMEOUT_MS = 30_000;
+const WorkerEventReplayGapSchema = z.object({
+    reason: z.enum(['expired', 'cursor-ahead']),
+    requestedLastEventId: z.number(),
+    oldestAvailableEventId: z.number(),
+    latestEventId: z.number()
+});
+/**
+ * One frame of the worker's `events` feed (`rpc/server.ts`). Any other JSON
+ * frame is one this client does not know: it is read and ignored.
+ */
+const StreamFrameSchema = z.discriminatedUnion('type', [
+    z.looseObject({ type: z.literal('ready') }),
+    z.looseObject({ type: z.literal('event'), id: z.number(), event: JsonValueSchema }),
+    z.looseObject({ type: z.literal('replay_gap'), gap: WorkerEventReplayGapSchema }),
+    z.looseObject({ type: z.literal('disconnect') })
+]);
+async function waitForReconnect(runtime, attempt, signal) {
+    if (signal.aborted)
+        return;
+    // Exponential backoff (2^n) capped at the max delay, so a dead socket backs off
+    // instead of churning a warn per 500ms.
+    const delay = Math.min(SSE_RECONNECT_MAX_DELAY_MS, SSE_RECONNECT_BASE_DELAY_MS * 2 ** Math.max(0, attempt - 1));
+    const waited = await settle(() => runtime.lifecycle.delay(delay, signal));
+    // The caller's own abort ends the wait quietly; runtime disposal propagates.
+    if (!waited.ok && !signal.aborted)
+        throw waited.thrown;
+}
+export async function runWorkerEventStream(options) {
+    const { runtime, socketPath, signal, timeoutMs = DEFAULT_HANDSHAKE_TIMEOUT_MS, onEvent, onOpen, onReplayGap } = options;
+    let cursor;
+    let attempt = 0;
+    while (!signal.aborted) {
+        let connection;
+        let channel;
+        let finish = () => { };
+        const abort = () => { finish(); void connection?.close(); };
+        const session = await settle(async () => {
+            const opened = await connectUnix(socketPath, { runtime, timeoutMs });
+            connection = opened;
+            if (signal.aborted)
+                return 'aborted';
+            signal.addEventListener('abort', abort, { once: true });
+            // The worker root's event feed is `events` (C19).
+            const consumer = wireConsumer({ rootMethods: ['events'], rootRef: opened.rootRef, send: req => opened.send(req),
+                openStream: (ref, name) => opened.openStream(asRefId(ref), name), closed: opened.closed });
+            // SAFETY: `rootMethods` declares exactly `events`, so the root proxy turns `events(cursor)` into that invoke; the worker server's `events` answers a feed whose `__openStream` opens the frame channel.
+            const remote = consumer.root;
+            // `undefined` cannot cross the wire as a positional argument (the wire
+            // encodes it as `null`), so omit the cursor on the first call instead of
+            // handing the server `null`, which it refuses as an invalid cursor.
+            const feed = cursor === undefined ? await remote.events() : await remote.events(cursor);
+            const opening = await feed.__openStream('events');
+            channel = opening;
+            const done = new Promise(resolve => { finish = resolve; });
+            if (signal.aborted)
+                finish();
+            void opened.closed.then(finish);
+            // The channel's own end (owner ended it, or the link dropped) reconnects even
+            // while the connection stays open.
+            void opening.ended.then(finish, finish);
+            opening.onData(data => {
+                const handled = settleSync(() => {
+                    const parsed = StreamFrameSchema.safeParse(JSON.parse(new TextDecoder().decode(data)));
+                    if (!parsed.success)
+                        return;
+                    const frame = parsed.data;
+                    if (frame.type === 'ready') {
+                        attempt = 0;
+                        onOpen?.();
+                    }
+                    else if (frame.type === 'event') {
+                        cursor = frame.id;
+                        onEvent(frame.event);
+                    }
+                    else if (frame.type === 'replay_gap') {
+                        cursor = frame.gap.latestEventId;
+                        onReplayGap?.(frame.gap);
+                        finish();
+                    }
+                    else
+                        finish();
+                });
+                if (handled.ok)
+                    return;
+                getLogger('worker-event-stream', runtime).error('Failed to parse event stream frame', { error: valueFreeFailure(handled.caught) });
+                finish();
+            });
+            await done;
+            return 'ended';
+        });
+        signal.removeEventListener('abort', abort);
+        channel?.close();
+        await connection?.close();
+        if (session.ok && session.value === 'aborted')
+            break;
+        if (!session.ok) {
+            if (signal.aborted)
+                break;
+            getLogger('worker-event-stream', runtime).error('Worker event stream error', { error: valueFreeFailure(session.caught) });
+        }
+        if (!signal.aborted)
+            await waitForReconnect(runtime, ++attempt, signal);
+    }
+}
+//# sourceMappingURL=event-stream.js.map

package/dist/adapters/ipc/internal/rpc/event-stream.js.map

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

package/dist/adapters/ipc/internal/rpc/server.d.ts

@@ -0,0 +1,21 @@
+import { type RpcSocketRuntime } from '@vibesdotdev/kernel-rpc/unix';
+import type { DispatchContext, JobEventPayload, WorkerRpcServerOptions } from '../../schemas/rpc.ts';
+export declare class WorkerRpcServer {
+    private server?;
+    private clients;
+    private readonly maxReplayEvents;
+    private readonly maxReplayBytes;
+    private replayFrames;
+    private replayBytes;
+    private latestEventId;
+    constructor(options?: WorkerRpcServerOptions);
+    /** Listen at `socketPath` through `runtime`'s socket service. */
+    start(socketPath: string, ctx: DispatchContext, runtime: RpcSocketRuntime): Promise<void>;
+    stop(): Promise<void>;
+    broadcast(event: JobEventPayload): void;
+    getClientCount(): number;
+    disconnectEventStreams(): void;
+    private getReplayGap;
+    private retainReplayFrame;
+}
+//# sourceMappingURL=server.d.ts.map

package/dist/adapters/ipc/internal/rpc/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../../../../src/adapters/ipc/internal/rpc/server.ts"],"names":[],"mappings":"AACA,OAAO,EAAc,KAAK,gBAAgB,EAAqB,MAAM,8BAA8B,CAAC;AAGpG,OAAO,KAAK,EAAE,eAAe,EAAE,eAAe,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAmBrG,qBAAa,eAAe;IAC3B,OAAO,CAAC,MAAM,CAAC,CAAe;IAC9B,OAAO,CAAC,OAAO,CAAwB;IACvC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAS;IACzC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IACxC,OAAO,CAAC,YAAY,CAAqB;IACzC,OAAO,CAAC,WAAW,CAAK;IACxB,OAAO,CAAC,aAAa,CAAK;gBAEd,OAAO,GAAE,sBAA2B;IAKhD,iEAAiE;IAC3D,KAAK,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,EAAE,eAAe,EAAE,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;IAwBzF,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAC3B,SAAS,CAAC,KAAK,EAAE,eAAe,GAAG,IAAI;IAUvC,cAAc,IAAI,MAAM;IACxB,sBAAsB,IAAI,IAAI;IAG9B,OAAO,CAAC,YAAY;IA6BpB,OAAO,CAAC,iBAAiB;CAczB"}

package/dist/adapters/ipc/internal/rpc/server.js

@@ -0,0 +1,119 @@
+import { DefaultInvokePipeline } from '@vibesdotdev/kernel';
+import { listenUnix } from '@vibesdotdev/kernel-rpc/unix';
+import { dispatch } from "./dispatcher.js";
+import { RESULT_PAGE_CHARS } from "../result-pages.js";
+class EventFeed {
+    attach;
+    detach;
+    handler;
+    constructor(attach, detach) {
+        this.attach = attach;
+        this.detach = detach;
+    }
+    onData(handler) {
+        this.handler = handler;
+        this.attach(this);
+        return () => this.close();
+    }
+    send(encoded) { this.handler?.(new TextEncoder().encode(encoded)); }
+    write() { throw new Error('Worker events are read-only'); }
+    close() { this.handler = undefined; this.detach(this); }
+}
+export class WorkerRpcServer {
+    server;
+    clients = new Set();
+    maxReplayEvents;
+    maxReplayBytes;
+    replayFrames = [];
+    replayBytes = 0;
+    latestEventId = 0;
+    constructor(options = {}) {
+        this.maxReplayEvents = Math.max(1, options.maxReplayEvents ?? 1024);
+        this.maxReplayBytes = Math.max(1, options.maxReplayBytes ?? 4 * 1024 * 1024);
+    }
+    /** Listen at `socketPath` through `runtime`'s socket service. */
+    async start(socketPath, ctx, runtime) {
+        this.server = await listenUnix(socketPath, {
+            // The worker root serves `rpc` and its `events` feed, as its clients declare (C19).
+            rootMethods: ['rpc', 'events'],
+            root: {
+                rpc: (message) => dispatch(message, ctx),
+                events: (cursor) => {
+                    if (cursor !== undefined && (!Number.isSafeInteger(cursor) || cursor < 0))
+                        throw new Error('Invalid event cursor');
+                    return new EventFeed(feed => {
+                        const gap = this.getReplayGap(cursor);
+                        if (gap) {
+                            feed.send(JSON.stringify({ type: 'replay_gap', gap }));
+                            return;
+                        }
+                        this.clients.add(feed);
+                        feed.send(JSON.stringify({ type: 'ready' }));
+                        if (cursor !== undefined)
+                            for (const frame of this.replayFrames)
+                                if (frame.id > cursor)
+                                    feed.send(frame.encoded);
+                    }, feed => this.clients.delete(feed));
+                }
+            },
+            pipeline: new DefaultInvokePipeline(),
+            classifyResult: value => value instanceof EventFeed ? { mode: 'ref', kind: 'object', methods: ['close'] } : { mode: 'inline' },
+            bindChannel: (target, channel) => target instanceof EventFeed && channel === 'events' ? target : null,
+            kindOf: () => 'workers/adapter'
+        }, { runtime });
+    }
+    async stop() { this.disconnectEventStreams(); this.server?.stop(); this.server = undefined; }
+    broadcast(event) {
+        const id = ++this.latestEventId;
+        const whole = JSON.stringify({ type: 'event', id, event });
+        // An event frame is one socket record: event data past a page (a completion's whole result, say) is left
+        // out rather than ending every subscriber's feed. The job itself still holds it (`getJob`).
+        const { data: _omitted, ...withoutData } = event;
+        const encoded = whole.length <= RESULT_PAGE_CHARS ? whole : JSON.stringify({ type: 'event', id, event: withoutData });
+        this.retainReplayFrame(id, encoded);
+        for (const client of this.clients)
+            client.send(encoded);
+    }
+    getClientCount() { return this.clients.size; }
+    disconnectEventStreams() {
+        for (const client of this.clients) {
+            client.send(JSON.stringify({ type: 'disconnect' }));
+            client.close();
+        }
+    }
+    getReplayGap(cursor) {
+        if (cursor === undefined)
+            return undefined;
+        const oldestAvailableEventId = this.replayFrames[0]?.id ?? this.latestEventId + 1;
+        if (cursor > this.latestEventId) {
+            return {
+                reason: 'cursor-ahead',
+                requestedLastEventId: cursor,
+                oldestAvailableEventId,
+                latestEventId: this.latestEventId
+            };
+        }
+        if (cursor < oldestAvailableEventId - 1) {
+            return {
+                reason: 'expired',
+                requestedLastEventId: cursor,
+                oldestAvailableEventId,
+                latestEventId: this.latestEventId
+            };
+        }
+        return undefined;
+    }
+    retainReplayFrame(id, encoded) {
+        const byteLength = new TextEncoder().encode(encoded).byteLength;
+        this.replayFrames.push({ id, encoded, byteLength });
+        this.replayBytes += byteLength;
+        while (this.replayFrames.length > this.maxReplayEvents ||
+            this.replayBytes > this.maxReplayBytes) {
+            const removed = this.replayFrames.shift();
+            if (!removed)
+                break;
+            this.replayBytes -= removed.byteLength;
+        }
+    }
+}
+//# sourceMappingURL=server.js.map

package/dist/adapters/ipc/internal/rpc/server.js.map

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

package/dist/adapters/ipc/internal/schedules-state.client.d.ts

@@ -0,0 +1,21 @@
+import { RootHolders, type KindContext } from '@vibesdotdev/kernel';
+import { BaseRuntimeClient, type RuntimeClientDescriptor } from '@vibesdotdev/kernel/client';
+import type { CapabilityError } from '@vibesdotdev/kernel';
+export interface CorruptScheduleStore {
+    version: string;
+    refusal: CapabilityError;
+}
+/** Corruption fences shared by all runtime generations from one plugin registration. */
+export declare class ScheduleStoreState {
+    readonly corruptStores: Map<string, CorruptScheduleStore>;
+    readonly holders: RootHolders;
+    release(): void;
+}
+/** Semantic runtime owner for per-store corruption fences. */
+export declare class IpcSchedulesClient extends BaseRuntimeClient {
+    private readonly state;
+    constructor(descriptor: RuntimeClientDescriptor, context: KindContext | undefined, state: ScheduleStoreState);
+    get corruptStores(): Map<string, CorruptScheduleStore>;
+    protected onDispose(): void;
+}
+//# sourceMappingURL=schedules-state.client.d.ts.map

package/dist/adapters/ipc/internal/schedules-state.client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schedules-state.client.d.ts","sourceRoot":"","sources":["../../../../src/adapters/ipc/internal/schedules-state.client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,KAAK,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACpE,OAAO,EAAE,iBAAiB,EAAE,KAAK,uBAAuB,EAAE,MAAM,4BAA4B,CAAC;AAC7F,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAE3D,MAAM,WAAW,oBAAoB;IACpC,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,eAAe,CAAC;CACzB;AAED,wFAAwF;AACxF,qBAAa,kBAAkB;IAC9B,QAAQ,CAAC,aAAa,oCAA2C;IACjE,QAAQ,CAAC,OAAO,cAAyC;IAEzD,OAAO,IAAI,IAAI;CAKf;AAED,8DAA8D;AAC9D,qBAAa,kBAAmB,SAAQ,iBAAiB;IACxD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAqB;gBAE/B,UAAU,EAAE,uBAAuB,EAAE,OAAO,EAAE,WAAW,GAAG,SAAS,EAAE,KAAK,EAAE,kBAAkB;IAM5G,IAAI,aAAa,IAAI,GAAG,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAErD;cAEkB,SAAS,IAAI,IAAI;CAGpC"}

package/dist/adapters/ipc/internal/schedules-state.client.js

@@ -0,0 +1,29 @@
+import { RootHolders } from '@vibesdotdev/kernel';
+import { BaseRuntimeClient } from '@vibesdotdev/kernel/client';
+/** Corruption fences shared by all runtime generations from one plugin registration. */
+export class ScheduleStoreState {
+    corruptStores = new Map();
+    holders = new RootHolders(() => this.release());
+    release() {
+        if (this.holders.size !== 0)
+            return;
+        this.corruptStores.clear();
+        this.holders.release();
+    }
+}
+/** Semantic runtime owner for per-store corruption fences. */
+export class IpcSchedulesClient extends BaseRuntimeClient {
+    state;
+    constructor(descriptor, context, state) {
+        super(descriptor, context);
+        this.state = state;
+        this.state.holders.hold(this.runtime);
+    }
+    get corruptStores() {
+        return this.state.corruptStores;
+    }
+    onDispose() {
+        this.state.release();
+    }
+}
+//# sourceMappingURL=schedules-state.client.js.map

package/dist/adapters/ipc/internal/schedules-state.client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schedules-state.client.js","sourceRoot":"","sources":["../../../../src/adapters/ipc/internal/schedules-state.client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAoB,MAAM,qBAAqB,CAAC;AACpE,OAAO,EAAE,iBAAiB,EAAgC,MAAM,4BAA4B,CAAC;AAQ7F,wFAAwF;AACxF,MAAM,OAAO,kBAAkB;IACrB,aAAa,GAAG,IAAI,GAAG,EAAgC,CAAC;IACxD,OAAO,GAAG,IAAI,WAAW,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;IAEzD,OAAO;QACN,IAAI,IAAI,CAAC,OAAO,CAAC,IAAI,KAAK,CAAC;YAAE,OAAO;QACpC,IAAI,CAAC,aAAa,CAAC,KAAK,EAAE,CAAC;QAC3B,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;IACxB,CAAC;CACD;AAED,8DAA8D;AAC9D,MAAM,OAAO,kBAAmB,SAAQ,iBAAiB;IACvC,KAAK,CAAqB;IAE3C,YAAY,UAAmC,EAAE,OAAgC,EAAE,KAAyB;QAC3G,KAAK,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;QAC3B,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACvC,CAAC;IAED,IAAI,aAAa;QAChB,OAAO,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC;IACjC,CAAC;IAEkB,SAAS;QAC3B,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC;IACtB,CAAC;CACD"}

package/dist/adapters/ipc/internal/schedules.d.ts

@@ -0,0 +1,13 @@
+import type { EnqueueOptions, RepeatOptions, ScheduleInfo } from '../../../core/queue-adapter.ts';
+import { type VibesRuntime } from '@vibesdotdev/kernel';
+export declare function scheduleRepeatable<TJob>(runtime: VibesRuntime, queueName: string, name: string, data: TJob, options: EnqueueOptions): Promise<string>;
+export declare function removeSchedule(runtime: VibesRuntime, queueName: string, name: string, repeat?: RepeatOptions): Promise<boolean>;
+/**
+ * Restore archived records. Active storage is written first and the archive copy
+ * is dropped only for records active storage is confirmed to hold, so an
+ * interrupted restore leaves a recoverable duplicate instead of losing a record.
+ */
+export declare function restoreArchivedSchedules(runtime: VibesRuntime, queueName: string, ids?: readonly string[]): Promise<number>;
+export declare function getSchedules(runtime: VibesRuntime, queueName: string): Promise<ScheduleInfo[]>;
+export declare function runDueSchedules<TJob>(runtime: VibesRuntime, queueName: string, enqueue: (data: TJob, options?: EnqueueOptions) => Promise<string>): Promise<number>;
+//# sourceMappingURL=schedules.d.ts.map

package/dist/adapters/ipc/internal/schedules.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schedules.d.ts","sourceRoot":"","sources":["../../../../src/adapters/ipc/internal/schedules.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACX,cAAc,EACd,aAAa,EACb,YAAY,EACZ,MAAM,gCAAgC,CAAC;AAQxC,OAAO,EAAsC,KAAK,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAqL5F,wBAAsB,kBAAkB,CAAC,IAAI,EAC5C,OAAO,EAAE,YAAY,EACrB,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,IAAI,EACV,OAAO,EAAE,cAAc,GACrB,OAAO,CAAC,MAAM,CAAC,CAkFjB;AAED,wBAAsB,cAAc,CACnC,OAAO,EAAE,YAAY,EACrB,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,EACZ,MAAM,CAAC,EAAE,aAAa,GACpB,OAAO,CAAC,OAAO,CAAC,CAkBlB;AAED;;;;GAIG;AACH,wBAAsB,wBAAwB,CAC7C,OAAO,EAAE,YAAY,EACrB,SAAS,EAAE,MAAM,EACjB,GAAG,CAAC,EAAE,SAAS,MAAM,EAAE,GACrB,OAAO,CAAC,MAAM,CAAC,CAkCjB;AAED,wBAAsB,YAAY,CACjC,OAAO,EAAE,YAAY,EACrB,SAAS,EAAE,MAAM,GACf,OAAO,CAAC,YAAY,EAAE,CAAC,CAuBzB;AA+BD,wBAAsB,eAAe,CAAC,IAAI,EACzC,OAAO,EAAE,YAAY,EACrB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC,EAAE,cAAc,KAAK,OAAO,CAAC,MAAM,CAAC,GAChE,OAAO,CAAC,MAAM,CAAC,CA+FjB"}