@roj-ai/sdk 0.1.35 → 0.2.1

package/dist/plugins/workers/context.d.ts

@@ -13,7 +13,7 @@ import type { SessionId } from '../../core/sessions/schema.js';
 import type { SessionState } from '../../core/sessions/state.js';
 import type { Logger } from '../../lib/logger/logger.js';
 import type { WorkerSubEvent } from './definition.js';
-import type { EmitEvent } from './plugin.js';
+import type { EmitEvent } from './state.js';
 import { WorkerId } from './worker.js';
 /**
  * Context provided to workers during execution.
@@ -32,13 +32,23 @@ export interface WorkerContext<TState, TSubEvent extends WorkerSubEvent> {
     readonly logger: Logger;
     /** File store for reading/writing files */
     readonly files: FileStore;
+    /**
+     * True when `execute()` is re-entered for a worker that already ran — after a
+     * runtime rebuild or a `resume`. The state handed to this run is already
+     * reconstructed from the event log, so a resumed worker must continue from
+     * `getState()` rather than start over.
+     */
+    readonly resumed: boolean;
     /**
      * Get current worker state (reconstructed from events).
      */
     getState(): TState;
     /**
      * Emit a worker-specific event.
-     * The event is persisted and applied to state.
+     *
+     * Applies the event to local state and persists it — but only while this run is
+     * live: once the run has been stopped (pause, cancel, session close) the emit is
+     * skipped and nothing is persisted.
      */
     emit(event: TSubEvent): Promise<void>;
     /**
@@ -47,8 +57,9 @@ export interface WorkerContext<TState, TSubEvent extends WorkerSubEvent> {
      */
     shouldContinue(): boolean;
     /**
-     * Check if worker is paused.
-     * Workers should pause their work when this returns true.
+     * Check if a pause was requested for this worker.
+     * A pause also stops execution — `shouldContinue()` goes false and `resume`
+     * re-enters `execute()` — so this only tells a pause from a cancellation.
      */
     isPaused(): boolean;
     /**
@@ -76,26 +87,29 @@ export declare class WorkerContextImpl<TState, TSubEvent extends WorkerSubEvent>
     readonly agentId: AgentId;
     readonly logger: Logger;
     readonly files: FileStore;
+    readonly resumed: boolean;
     private readonly workerType;
     private readonly emitEvent;
     private readonly getSessionStateCallback;
     private readonly reducer;
+    private readonly reserveMailboxMessageSequence;
+    private readonly acquireEffectLease;
+    private readonly inFlightEffects;
+    private readonly effectLeases;
     private localState;
     /**
      * Local cancellation flag - provides immediate signal before event is persisted.
      * This is set by cancel() and checked by shouldContinue() for fast response.
      */
     private _cancelled;
-    /**
-     * Local pause flag - provides immediate signal before event is persisted.
-     * This is set by pause() and checked by isPaused() for fast response.
-     */
+    /** Set by pause() so a winding-down run can tell a pause from a cancellation. */
     private _paused;
     /**
      * AbortController for cancelling long-running operations.
      * Aborted when cancel() is called.
      */
     private readonly abortController;
+    private active;
     private readonly scheduleCallback?;
     constructor(params: {
         sessionId: SessionId;
@@ -105,8 +119,11 @@ export declare class WorkerContextImpl<TState, TSubEvent extends WorkerSubEvent>
         files: FileStore;
         emitEvent: EmitEvent;
         getSessionState: () => SessionState;
+        reserveMailboxMessageSequence: () => number;
+        acquireEffectLease: () => (() => void) | null;
         reducer: (state: TState, event: TSubEvent) => TState;
         initialState: TState;
+        resumed: boolean;
         logger: Logger;
         schedule?: () => void;
     });
@@ -119,6 +136,8 @@ export declare class WorkerContextImpl<TState, TSubEvent extends WorkerSubEvent>
      * Applies the event to local state before persisting.
      */
     emit(event: TSubEvent): Promise<void>;
+    /** Persist a terminal worker event within the context effect lifecycle. */
+    persistTerminal(event: Parameters<EmitEvent>[0]): Promise<boolean>;
     /**
      * Check if worker should continue execution.
      * Returns false if cancelled.
@@ -147,13 +166,16 @@ export declare class WorkerContextImpl<TState, TSubEvent extends WorkerSubEvent>
      * Mark worker as cancelled and abort any pending operations.
      */
     cancel(): void;
+    /** Permanently disable callbacks — the worker is stopping and will never resume this run. */
+    invalidate(): void;
+    /** Wait for effects that started before invalidation. */
+    waitForEffects(): Promise<void>;
+    /** Give back the leases of effects that outlived their drain deadline, so a stalled write cannot pin the runtime forever. */
+    releaseEffectLeases(): void;
+    private runEffect;
     /**
-     * Mark worker as paused.
+     * Record that this run is stopping because of a pause, not a cancellation.
      */
     pause(): void;
-    /**
-     * Resume worker.
-     */
-    resume(): void;
 }
 //# sourceMappingURL=context.d.ts.map

package/dist/plugins/workers/context.d.ts.map

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

package/dist/plugins/workers/context.js

@@ -7,10 +7,9 @@
  * - Execution control (pause, cancel)
  * - Communication with owning agent
  */
-import { getNextMessageSeq, selectMailboxState } from '../../plugins/mailbox/query.js';
 import { generateMessageId } from '../../plugins/mailbox/schema.js';
 import { mailboxEvents } from '../../plugins/mailbox/state.js';
-import { workerEvents } from './plugin.js';
+import { workerEvents } from './state.js';
 // ============================================================================
 // WorkerContextImpl
 // ============================================================================
@@ -23,26 +22,29 @@ export class WorkerContextImpl {
     agentId;
     logger;
     files;
+    resumed;
     workerType;
     emitEvent;
     getSessionStateCallback;
     reducer;
+    reserveMailboxMessageSequence;
+    acquireEffectLease;
+    inFlightEffects = new Set();
+    effectLeases = new Set();
     localState;
     /**
      * Local cancellation flag - provides immediate signal before event is persisted.
      * This is set by cancel() and checked by shouldContinue() for fast response.
      */
     _cancelled = false;
-    /**
-     * Local pause flag - provides immediate signal before event is persisted.
-     * This is set by pause() and checked by isPaused() for fast response.
-     */
+    /** Set by pause() so a winding-down run can tell a pause from a cancellation. */
     _paused = false;
     /**
      * AbortController for cancelling long-running operations.
      * Aborted when cancel() is called.
      */
     abortController = new AbortController();
+    active = true;
     scheduleCallback;
     constructor(params) {
         this.sessionId = params.sessionId;
@@ -52,8 +54,11 @@ export class WorkerContextImpl {
         this.files = params.files;
         this.emitEvent = params.emitEvent;
         this.getSessionStateCallback = params.getSessionState;
+        this.reserveMailboxMessageSequence = params.reserveMailboxMessageSequence;
+        this.acquireEffectLease = params.acquireEffectLease;
         this.reducer = params.reducer;
         this.localState = params.initialState;
+        this.resumed = params.resumed;
         this.logger = params.logger;
         this.scheduleCallback = params.schedule;
     }
@@ -68,19 +73,27 @@ export class WorkerContextImpl {
      * Applies the event to local state before persisting.
      */
     async emit(event) {
-        this.localState = this.reducer(this.localState, event);
-        await this.emitEvent(workerEvents.create('worker_sub_event', {
-            workerId: this.workerId,
-            workerType: this.workerType,
-            subEvent: event,
-        }));
+        await this.runEffect(async () => {
+            this.localState = this.reducer(this.localState, event);
+            await this.emitEvent(workerEvents.create('worker_sub_event', {
+                workerId: this.workerId,
+                workerType: this.workerType,
+                subEvent: event,
+            }));
+        });
+    }
+    /** Persist a terminal worker event within the context effect lifecycle. */
+    async persistTerminal(event) {
+        return this.runEffect(async () => {
+            await this.emitEvent(event);
+        });
     }
     /**
      * Check if worker should continue execution.
      * Returns false if cancelled.
      */
     shouldContinue() {
-        return !this._cancelled;
+        return this.active && !this._cancelled;
     }
     /**
      * Check if worker is paused.
@@ -95,18 +108,23 @@ export class WorkerContextImpl {
      * as sender, but workers need to send as WorkerId. Migrate when mailbox.send supports WorkerId.
      */
     async notifyAgent(message) {
-        const messageId = generateMessageId(getNextMessageSeq(selectMailboxState(this.getSessionStateCallback())));
-        await this.emitEvent(mailboxEvents.create('mailbox_message', {
-            toAgentId: this.agentId,
-            message: {
-                id: messageId,
-                from: this.workerId,
-                content: message,
-                timestamp: Date.now(),
-                consumed: false,
-            },
-        }));
-        this.scheduleCallback?.();
+        await this.runEffect(async () => {
+            const sequence = this.reserveMailboxMessageSequence();
+            const messageId = generateMessageId(sequence);
+            await this.emitEvent(mailboxEvents.create('mailbox_message', {
+                toAgentId: this.agentId,
+                sequence,
+                message: {
+                    id: messageId,
+                    from: this.workerId,
+                    content: message,
+                    timestamp: Date.now(),
+                    consumed: false,
+                },
+            }));
+            if (this.active)
+                this.scheduleCallback?.();
+        });
     }
     /**
      * Get current session state.
@@ -127,17 +145,49 @@ export class WorkerContextImpl {
         this._cancelled = true;
         this.abortController.abort();
     }
+    /** Permanently disable callbacks — the worker is stopping and will never resume this run. */
+    invalidate() {
+        this.active = false;
+        this.cancel();
+    }
+    /** Wait for effects that started before invalidation. */
+    async waitForEffects() {
+        await Promise.allSettled([...this.inFlightEffects]);
+    }
+    /** Give back the leases of effects that outlived their drain deadline, so a stalled write cannot pin the runtime forever. */
+    releaseEffectLeases() {
+        for (const release of this.effectLeases)
+            release();
+        this.effectLeases.clear();
+    }
+    async runEffect(effect) {
+        if (!this.active)
+            return false;
+        // The runtime can start unloading between the check above and here — skip the
+        // effect rather than throw a lease error into worker code.
+        const releaseLease = this.acquireEffectLease();
+        if (!releaseLease)
+            return false;
+        this.effectLeases.add(releaseLease);
+        let promise;
+        try {
+            promise = effect();
+            this.inFlightEffects.add(promise);
+            await promise;
+        }
+        finally {
+            if (promise)
+                this.inFlightEffects.delete(promise);
+            this.effectLeases.delete(releaseLease);
+            releaseLease();
+        }
+        return true;
+    }
     /**
-     * Mark worker as paused.
+     * Record that this run is stopping because of a pause, not a cancellation.
      */
     pause() {
         this._paused = true;
     }
-    /**
-     * Resume worker.
-     */
-    resume() {
-        this._paused = false;
-    }
 }
 //# sourceMappingURL=context.js.map

package/dist/plugins/workers/context.js.map

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

package/dist/plugins/workers/definition.d.ts

@@ -84,6 +84,13 @@ export interface WorkerDefinition<TConfig = unknown, TState = unknown, TSubEvent
     /**
      * Main execution logic.
      * The worker runs until completion, failure, or cancellation.
+     *
+     * Re-entrant, and must be idempotent: a rebuilt session runtime and
+     * `workers.resume` both call this again from the top, with `context.resumed`
+     * true and the state already replayed from the event log. Drive the loop from
+     * `context.getState()` and emit the event that records a side effect before
+     * performing it — never from local variables seeded at entry, which a re-entry
+     * resets while the persisted state moves on.
      */
     execute(config: TConfig, context: WorkerContext<TState, TSubEvent>): Promise<Result<WorkerResult, WorkerError>>;
     /**

package/dist/plugins/workers/definition.d.ts.map

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

package/dist/plugins/workers/definition.js.map

@@ -1 +1 @@
-{"version":3,"file":"definition.js","sourceRoot":"","sources":["../../../src/plugins/workers/definition.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAsHH,+EAA+E;AAC/E,oCAAoC;AACpC,+EAA+E;AAE/E;;;;;;;GAOG;AACH,MAAM,UAAU,sBAAsB,CAKrC,IAAY,EACZ,WAAmB,EACnB,YAAgC,EAChC,UAaC;IAED,OAAO;QACN,IAAI;QACJ,WAAW;QACX,YAAY;QACZ,GAAG,UAAU;KACb,CAAA;AACF,CAAC"}
+{"version":3,"file":"definition.js","sourceRoot":"","sources":["../../../src/plugins/workers/definition.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AA6HH,+EAA+E;AAC/E,oCAAoC;AACpC,+EAA+E;AAE/E;;;;;;;GAOG;AACH,MAAM,UAAU,sBAAsB,CAKrC,IAAY,EACZ,WAAmB,EACnB,YAAgC,EAChC,UAaC;IAED,OAAO;QACN,IAAI;QACJ,WAAW;QACX,YAAY;QACZ,GAAG,UAAU;KACb,CAAA;AACF,CAAC"}

package/dist/plugins/workers/index.d.ts

@@ -1,11 +1,11 @@
-export { workerPlugin } from './plugin.js';
+export { MAX_CONCURRENT_WORKERS, WORKER_EFFECT_DRAIN_TIMEOUT_MS, WORKER_STOP_TIMEOUT_MS, workerPlugin } from './plugin.js';
 export type { WorkerAgentConfig, WorkerPresetConfig } from './plugin.js';
-export { workerEvents } from './plugin.js';
-export type { WorkerCompletedEvent, WorkerFailedEvent, WorkerStartedEvent, WorkerStatusChangedEvent, WorkerSubEventEmittedEvent } from './plugin.js';
+export { workerEvents } from './state.js';
+export type { WorkerCompletedEvent, WorkerFailedEvent, WorkerStartedEvent, WorkerStatusChangedEvent, WorkerSubEventEmittedEvent } from './state.js';
 export type { WorkerDefinition, WorkerSubEvent } from './definition.js';
 export { createWorkerDefinition } from './definition.js';
 export type { WorkerContext } from './context.js';
 export { WorkerContextImpl } from './context.js';
 export type { WorkerError, WorkerResult } from './worker.js';
-export type { EmitEvent } from './plugin.js';
+export type { EmitEvent } from './state.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/plugins/workers/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/plugins/workers/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAC1C,YAAY,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAA;AAGxE,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAC1C,YAAY,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,wBAAwB,EAAE,0BAA0B,EAAE,MAAM,aAAa,CAAA;AAGpJ,YAAY,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAA;AACvE,OAAO,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAA;AAGxD,YAAY,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AACjD,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAA;AAGhD,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAG5D,YAAY,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/plugins/workers/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,sBAAsB,EAAE,8BAA8B,EAAE,sBAAsB,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAC1H,YAAY,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAA;AAGxE,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AACzC,YAAY,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,wBAAwB,EAAE,0BAA0B,EAAE,MAAM,YAAY,CAAA;AAGnJ,YAAY,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAA;AACvE,OAAO,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAA;AAGxD,YAAY,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AACjD,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAA;AAGhD,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAG5D,YAAY,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA"}

package/dist/plugins/workers/index.js

@@ -1,7 +1,7 @@
 // Plugin
-export { workerPlugin } from './plugin.js';
+export { MAX_CONCURRENT_WORKERS, WORKER_EFFECT_DRAIN_TIMEOUT_MS, WORKER_STOP_TIMEOUT_MS, workerPlugin } from './plugin.js';
 // Events (now in plugin.ts)
-export { workerEvents } from './plugin.js';
+export { workerEvents } from './state.js';
 export { createWorkerDefinition } from './definition.js';
 export { WorkerContextImpl } from './context.js';
 //# sourceMappingURL=index.js.map

package/dist/plugins/workers/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/plugins/workers/index.ts"],"names":[],"mappings":"AAAA,SAAS;AACT,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAG1C,4BAA4B;AAC5B,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAK1C,OAAO,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAA;AAIxD,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/plugins/workers/index.ts"],"names":[],"mappings":"AAAA,SAAS;AACT,OAAO,EAAE,sBAAsB,EAAE,8BAA8B,EAAE,sBAAsB,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAG1H,4BAA4B;AAC5B,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAKzC,OAAO,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAA;AAIxD,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAA"}

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

@@ -1,64 +1,21 @@
 import z from 'zod/v4';
-import type { BaseEvent } from '../../core/events/types.js';
 import type { WorkerDefinition } from './definition.js';
-export declare const workerEvents: import("../../core/events/types.js").EventsFactory<{
-    worker_started: z.ZodObject<{
-        workerId: z.core.$ZodBranded<z.ZodString, "WorkerId", "out">;
-        agentId: z.core.$ZodBranded<z.ZodString, "AgentId", "out">;
-        workerType: z.ZodString;
-        config: z.ZodUnknown;
-    }, z.core.$strip>;
-    worker_sub_event: z.ZodObject<{
-        workerId: z.core.$ZodBranded<z.ZodString, "WorkerId", "out">;
-        workerType: z.ZodString;
-        subEvent: z.ZodIntersection<z.ZodRecord<z.ZodString, z.ZodUnknown>, z.ZodObject<{
-            type: z.ZodString;
-        }, z.core.$strip>>;
-    }, z.core.$strip>;
-    worker_status_changed: z.ZodObject<{
-        workerId: z.core.$ZodBranded<z.ZodString, "WorkerId", "out">;
-        fromStatus: z.ZodEnum<{
-            paused: "paused";
-            failed: "failed";
-            running: "running";
-            completed: "completed";
-            cancelled: "cancelled";
-        }>;
-        toStatus: z.ZodEnum<{
-            paused: "paused";
-            failed: "failed";
-            running: "running";
-            completed: "completed";
-            cancelled: "cancelled";
-        }>;
-        reason: z.ZodOptional<z.ZodString>;
-    }, z.core.$strip>;
-    worker_completed: z.ZodObject<{
-        workerId: z.core.$ZodBranded<z.ZodString, "WorkerId", "out">;
-        result: z.ZodObject<{
-            status: z.ZodString;
-            resultsPath: z.ZodOptional<z.ZodString>;
-            summary: z.ZodString;
-            data: z.ZodOptional<z.ZodUnknown>;
-        }, z.core.$strip>;
-    }, z.core.$strip>;
-    worker_failed: z.ZodObject<{
-        workerId: z.core.$ZodBranded<z.ZodString, "WorkerId", "out">;
-        error: z.ZodString;
-        resumable: z.ZodBoolean;
-    }, z.core.$strip>;
-}>;
-export type WorkerStartedEvent = (typeof workerEvents)['Events']['worker_started'];
-export type WorkerSubEventEmittedEvent = (typeof workerEvents)['Events']['worker_sub_event'];
-export type WorkerStatusChangedEvent = (typeof workerEvents)['Events']['worker_status_changed'];
-export type WorkerCompletedEvent = (typeof workerEvents)['Events']['worker_completed'];
-export type WorkerFailedEvent = (typeof workerEvents)['Events']['worker_failed'];
+/** Most workers a single session runtime runs at once. */
+export declare const MAX_CONCURRENT_WORKERS = 10;
+/** Default bound on waiting for a stopped worker's `execute()` to return. */
+export declare const WORKER_STOP_TIMEOUT_MS = 5000;
+/** Default bound on draining the context effects a stopped worker left in flight. */
+export declare const WORKER_EFFECT_DRAIN_TIMEOUT_MS = 5000;
 /**
  * Session-wide worker configuration.
  */
 export interface WorkerPresetConfig {
     /** Available worker definitions */
     workers: WorkerDefinition[];
+    /** Bound on waiting for `execute()` to return when stopping. Defaults to WORKER_STOP_TIMEOUT_MS. */
+    stopTimeoutMs?: number;
+    /** Bound on draining in-flight context effects after a stop. Defaults to WORKER_EFFECT_DRAIN_TIMEOUT_MS. */
+    effectDrainTimeoutMs?: number;
 }
 /**
  * Agent-specific worker configuration.
@@ -67,10 +24,6 @@ export interface WorkerAgentConfig {
     /** Worker types this agent can spawn (empty = all) */
     workers?: string[];
 }
-/**
- * Event emitter callback - emits events without sessionId (added automatically).
- */
-export type EmitEvent = (event: Omit<BaseEvent<string>, 'sessionId'>) => Promise<void>;
 export declare const workerPlugin: import("../../core/plugins/plugin-builder.js").PluginDefinition<"workers", WorkerPresetConfig, WorkerAgentConfig, {}, Record<"spawn", {
     input: {
         sessionId: string;

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

@@ -1 +1 @@
-{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../../../src/plugins/workers/plugin.ts"],"names":[],"mappings":"AAAA,OAAO,CAAC,MAAM,QAAQ,CAAA;AAItB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAA;AAMvD,OAAO,KAAK,EAA2B,gBAAgB,EAAkB,MAAM,iBAAiB,CAAA;AAGhG,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAoCvB,CAAA;AAEF,MAAM,MAAM,kBAAkB,GAAG,CAAC,OAAO,YAAY,CAAC,CAAC,QAAQ,CAAC,CAAC,gBAAgB,CAAC,CAAA;AAClF,MAAM,MAAM,0BAA0B,GAAG,CAAC,OAAO,YAAY,CAAC,CAAC,QAAQ,CAAC,CAAC,kBAAkB,CAAC,CAAA;AAC5F,MAAM,MAAM,wBAAwB,GAAG,CAAC,OAAO,YAAY,CAAC,CAAC,QAAQ,CAAC,CAAC,uBAAuB,CAAC,CAAA;AAC/F,MAAM,MAAM,oBAAoB,GAAG,CAAC,OAAO,YAAY,CAAC,CAAC,QAAQ,CAAC,CAAC,kBAAkB,CAAC,CAAA;AACtF,MAAM,MAAM,iBAAiB,GAAG,CAAC,OAAO,YAAY,CAAC,CAAC,QAAQ,CAAC,CAAC,eAAe,CAAC,CAAA;AAEhF;;GAEG;AACH,MAAM,WAAW,kBAAkB;IAClC,mCAAmC;IACnC,OAAO,EAAE,gBAAgB,EAAE,CAAA;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IACjC,sDAAsD;IACtD,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;CAClB;AAMD;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG,CAAC,KAAK,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;AAyEtF,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwjBhB,CAAA"}
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../../../src/plugins/workers/plugin.ts"],"names":[],"mappings":"AAAA,OAAO,CAAC,MAAM,QAAQ,CAAA;AActB,OAAO,KAAK,EAA2B,gBAAgB,EAAkB,MAAM,iBAAiB,CAAA;AAIhG,0DAA0D;AAC1D,eAAO,MAAM,sBAAsB,KAAK,CAAA;AAExC,6EAA6E;AAC7E,eAAO,MAAM,sBAAsB,OAAO,CAAA;AAE1C,qFAAqF;AACrF,eAAO,MAAM,8BAA8B,OAAO,CAAA;AAElD;;GAEG;AACH,MAAM,WAAW,kBAAkB;IAClC,mCAAmC;IACnC,OAAO,EAAE,gBAAgB,EAAE,CAAA;IAC3B,oGAAoG;IACpG,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,4GAA4G;IAC5G,oBAAoB,CAAC,EAAE,MAAM,CAAA;CAC7B;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IACjC,sDAAsD;IACtD,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;CAClB;AAuRD,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmsBhB,CAAA"}