@zaalipro/dsh-workflows 0.1.0-rc.12

package/lib/types/supervisor/completion-notice.js

@@ -0,0 +1,281 @@
+import { boundContextSummary, createUserMessage } from '@deepseek-ai/dsh-llm';
+const encoder = new TextEncoder();
+const FOOTER = 'Open /workflows to inspect the run.';
+const REPORT_REFERENCE = 'The complete report is retained as scratch/report.md.';
+const TRUNCATED = '[notice truncated]';
+function renderThrown(error) {
+    try {
+        return String(error);
+    }
+    catch {
+        return '[unrenderable thrown value]';
+    }
+}
+function utf8Prefix(text, maxBytes) {
+    let output = '';
+    let bytes = 0;
+    for (const point of text) {
+        const size = encoder.encode(point).byteLength;
+        if (bytes + size > maxBytes)
+            break;
+        output += point;
+        bytes += size;
+    }
+    return output;
+}
+function jsonText(value) {
+    try {
+        return JSON.stringify(value, null, 2);
+    }
+    catch {
+        return '[result could not be serialized]';
+    }
+}
+function statusClause(status) {
+    switch (status) {
+        case 'completed': return 'completed';
+        case 'failed': return 'failed';
+        case 'cancelled': return 'was stopped';
+        case 'interrupted': return 'was interrupted';
+    }
+}
+function resultText(input) {
+    if (input.status !== 'completed')
+        return input.error === undefined || input.error === '' ? '' : `\nReason: ${input.error}`;
+    const value = input.result;
+    if (value?.state !== 'available')
+        return '\nResult:\nNo workflow result was retained.';
+    return value.content.kind === 'value'
+        ? `\nResult:\n${jsonText(value.content.value)}`
+        : `\nResult preview:\n${value.content.text}`;
+}
+function fitNotice(content, footer, maxBytes) {
+    const complete = `${content}\n${footer}`;
+    if (encoder.encode(complete).byteLength <= maxBytes)
+        return complete;
+    const fixed = `\n${TRUNCATED}\n${footer}`;
+    const fixedBytes = encoder.encode(fixed).byteLength;
+    if (fixedBytes >= maxBytes)
+        return utf8Prefix(fixed, maxBytes);
+    return `${utf8Prefix(content, maxBytes - fixedBytes)}${fixed}`;
+}
+/** Render one bounded owner-visible notice while preserving the dashboard footer. */
+export function renderWorkflowCompletionNotice(input, maxBytes = 16_384, report = input.report) {
+    if (!Number.isSafeInteger(maxBytes) || maxBytes < 1) {
+        throw new TypeError('workflow completion notice maxBytes must be a positive safe integer');
+    }
+    const heading = `workflow "${input.displayName}" ${statusClause(input.status)}.`;
+    const detail = report === undefined ? resultText(input) : `\nScratch report:\n${report}`;
+    const footer = report === undefined ? FOOTER : `${REPORT_REFERENCE}\n${FOOTER}`;
+    return fitNotice(`${heading}${detail}`, footer, maxBytes);
+}
+function isStore(value) {
+    return typeof value === 'object' && value !== null
+        && typeof value.finalizeCompletionNotice === 'function';
+}
+/**
+ * At-most-once completion outbox. Durable `claimed` state authorizes one
+ * enqueue; this class finalizes that exact claim as delivered or abandoned.
+ */
+export class WorkflowCompletionNotifier {
+    ctx;
+    store;
+    options;
+    reservations = new Map();
+    attempted = new Set();
+    owners = new Map();
+    disposed = false;
+    disposal;
+    constructor(ctx, storeOrOptions, maybeOptions = {}) {
+        this.ctx = ctx;
+        this.store = isStore(storeOrOptions) ? storeOrOptions : undefined;
+        const supplied = isStore(storeOrOptions) ? maybeOptions : (storeOrOptions ?? {});
+        this.options = {
+            maxBytes: supplied.maxBytes ?? 16_384,
+            maxItems: supplied.maxItems ?? 20,
+            maxCohortBytes: supplied.maxCohortBytes ?? 262_144,
+        };
+        for (const [name, value] of Object.entries(this.options)) {
+            if (!Number.isSafeInteger(value) || value < 1)
+                throw new TypeError(`workflow completion ${name} must be a positive safe integer`);
+        }
+    }
+    reserve(key, parent) {
+        if (this.disposed)
+            return;
+        const existing = this.reservations.get(key);
+        if (existing !== undefined && existing.parent !== parent)
+            throw new Error('workflow completion token changed owner');
+        if (existing === undefined)
+            this.reservations.set(key, { parent });
+    }
+    async notify(input) {
+        const key = input.runId;
+        if (this.attempted.has(key))
+            return false;
+        const parent = input.parent ?? this.reservations.get(key)?.parent;
+        if (parent === undefined)
+            return false;
+        this.reserve(key, parent);
+        this.attempted.add(key);
+        const noticeBytes = Math.min(this.options.maxBytes, this.options.maxCohortBytes);
+        // Supervisor-owned descriptor reads populate `report` before this queue.
+        // Deliberately do not traverse an ambient absolute path here; legacy
+        // callers that provide only scratchDir simply fall back to inline result.
+        const report = input.report;
+        const text = renderWorkflowCompletionNotice(input, noticeBytes, report);
+        const bytes = encoder.encode(text).byteLength;
+        if (this.disposed) {
+            await this.finalizeDirect({ key, input: { ...input, parent }, text, bytes, resolve: () => undefined }, 'abandoned', 'teardown');
+            return true;
+        }
+        return await new Promise(resolve => {
+            const owner = this.owners.get(parent) ?? { pending: [], pendingBytes: 0, scheduled: false };
+            this.owners.set(parent, owner);
+            owner.pending.push({ key, input: { ...input, parent }, text, bytes, resolve });
+            owner.pendingBytes += bytes;
+            this.schedule(parent, owner);
+        });
+    }
+    schedule(parent, owner) {
+        if (owner.scheduled || owner.processing !== undefined)
+            return;
+        owner.scheduled = true;
+        queueMicrotask(() => {
+            owner.scheduled = false;
+            if (owner.processing !== undefined)
+                return;
+            owner.processing = this.drainOwner(parent, owner).finally(() => {
+                owner.processing = undefined;
+                if (owner.pending.length > 0 && !this.disposed)
+                    this.schedule(parent, owner);
+                else if (owner.pending.length === 0)
+                    this.owners.delete(parent);
+            });
+        });
+    }
+    takeCohort(owner) {
+        const cohort = [];
+        let bytes = 0;
+        while (owner.pending.length > 0 && cohort.length < this.options.maxItems) {
+            const candidate = owner.pending[0];
+            const separatorBytes = cohort.length === 0 ? 0 : encoder.encode('\n\n').byteLength;
+            if (cohort.length > 0 && bytes + separatorBytes + candidate.bytes > this.options.maxCohortBytes)
+                break;
+            owner.pending.shift();
+            owner.pendingBytes -= candidate.bytes;
+            cohort.push(candidate);
+            bytes += separatorBytes + candidate.bytes;
+            if (bytes >= this.options.maxCohortBytes)
+                break;
+        }
+        return cohort;
+    }
+    async drainOwner(parent, owner) {
+        while (owner.pending.length > 0) {
+            const cohort = this.takeCohort(owner);
+            if (this.disposed) {
+                for (const item of cohort) {
+                    await this.finalize(item, 'abandoned', 'teardown');
+                    item.resolve(true);
+                }
+                continue;
+            }
+            const text = cohort.map(item => item.text).join('\n\n');
+            let delivered = false;
+            let failure;
+            try {
+                const first = cohort[0];
+                const message = createUserMessage({
+                    content: [{ type: 'text', text }],
+                    source: {
+                        kind: 'plugin', plugin: 'workflow-supervisor', form: 'notice',
+                        summary: boundContextSummary(`workflow ${first.input.displayName} ${statusClause(first.input.status)}`),
+                    },
+                });
+                // A completion is a durable conversation notification, not a new
+                // prompt.  Agent.followup() wakes the model and Agent.inject() stays
+                // invisible while the Agent is idle.  Session.append() is the public
+                // stock-Harness seam that makes plugin context durable and visible
+                // immediately without touching either inbox lane.
+                const append = parent?.session?.append;
+                if (typeof append !== 'function')
+                    throw new Error('workflow owner session is unavailable');
+                await Promise.resolve(append.call(parent.session, 'user/message', message, { surfaceOp: 'append' }));
+                delivered = true;
+            }
+            catch (error) {
+                failure = error;
+                this.ctx?.logger?.warn?.(`workflow-supervisor: completion notice delivery failed: ${renderThrown(error)}`);
+            }
+            for (const item of cohort) {
+                // The version-2 manifest calls its non-waking delivery lane `inject`.
+                // Keep that durable vocabulary compatible while delivering through
+                // the stronger immediately-visible Session append seam.
+                await this.finalize(item, delivered ? 'delivered' : 'abandoned', delivered ? 'inject' : 'enqueue-failed', failure);
+                item.resolve(true);
+            }
+        }
+    }
+    async finalizeDirect(item, state, reason) {
+        await this.finalize(item, state, reason);
+    }
+    async finalize(item, state, laneOrReason, error) {
+        const head = item.input.head;
+        const notice = head?.completionNotice;
+        if (this.store === undefined || head === undefined || notice?.state !== 'claimed' || item.input.sessionId === undefined)
+            return;
+        const base = {
+            claimId: notice.claimId,
+            processEpoch: notice.processEpoch,
+            claimedAt: notice.claimedAt,
+            finalizedAt: Math.max(Date.now(), notice.claimedAt),
+        };
+        const finalization = state === 'delivered'
+            ? { state, ...base, lane: laneOrReason }
+            : {
+                state, ...base, reason: laneOrReason,
+                ...(error === undefined ? {} : { error: utf8Prefix(renderThrown(error), 65_536) }),
+            };
+        try {
+            await this.store.finalizeCompletionNotice(item.input.sessionId, item.input.runId, head.revision, finalization);
+        }
+        catch (failure) {
+            this.ctx?.logger?.warn?.(`workflow-supervisor: completion notice finalization failed: ${renderThrown(failure)}`);
+        }
+    }
+    async whenOwnerQuiescent(agent, signal) {
+        for (;;) {
+            signal?.throwIfAborted();
+            const owner = this.owners.get(agent);
+            if (owner === undefined)
+                return;
+            if (owner.processing !== undefined)
+                await owner.processing;
+            else
+                await new Promise(resolve => queueMicrotask(resolve));
+        }
+    }
+    async dispose() {
+        if (this.disposal !== undefined)
+            return this.disposal;
+        this.disposed = true;
+        this.disposal = (async () => {
+            // Once disposal starts no new owner turn may be opened.  Every queued
+            // claim is nevertheless finalized so a terminal `claimed` row cannot
+            // remain pinned forever.
+            const pending = [];
+            for (const owner of this.owners.values())
+                pending.push(...owner.pending.splice(0));
+            await Promise.allSettled(pending.map(async (item) => {
+                await this.finalize(item, 'abandoned', 'teardown');
+                item.resolve(true);
+            }));
+            await Promise.allSettled([...this.owners.values()].map(owner => owner.processing).filter((value) => value !== undefined));
+            this.owners.clear();
+            this.reservations.clear();
+        })();
+        return this.disposal;
+    }
+}
+//# sourceMappingURL=completion-notice.js.map

package/lib/types/supervisor/completion-notice.js.map

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

package/lib/types/supervisor/cursors.d.ts

@@ -0,0 +1,68 @@
+import type { WorkflowRunCursor, WorkflowRunFeedEpoch } from './types.js';
+/** Collections which may be paged through the authorized workflow Remote. */
+export type WorkflowCursorKind = 'definitions' | 'runs' | 'members' | 'logs' | 'artifacts' | 'artifact';
+/** Canonical authenticated cursor payload. No protected data belongs here. */
+export interface WorkflowCursorPayload {
+    readonly version: 1;
+    readonly kind: WorkflowCursorKind;
+    /** Exact owning Session identity. */
+    readonly sessionId: string;
+    /** Selected run/member owner; empty for Session-wide collections. */
+    readonly entityId: string;
+    /** Process epoch which issued the baseline. */
+    readonly processEpoch: string;
+    /** Collection revision at which this offset was produced. */
+    readonly revision: number;
+    /** Row offset, or UTF-8 byte offset for `artifact`. */
+    readonly offset: number;
+}
+export interface WorkflowCursorExpectation {
+    readonly version?: 1;
+    readonly kind: WorkflowCursorKind;
+    readonly sessionId: string;
+    readonly entityId: string;
+    readonly processEpoch: string;
+    readonly revision: number;
+    /** Inclusive upper bound for the next offset. */
+    readonly total: number;
+}
+export type WorkflowCursorDecodeResult = {
+    readonly ok: true;
+    readonly value: WorkflowCursorPayload;
+} | {
+    readonly ok: false;
+    readonly reason: 'invalid' | 'stale';
+};
+/** Compatibility error used by the early package Remote adapter. */
+export declare class WorkflowCursorError extends Error {
+    readonly code: 'invalid-cursor' | 'stale-cursor';
+    constructor(message: string, code: 'invalid-cursor' | 'stale-cursor');
+}
+/**
+ * Encode an authenticated cursor. The two-argument form is the public API;
+ * the one-argument form remains for early package consumers and uses the
+ * process-local secret.
+ */
+export declare function encodeWorkflowCursor(secret: Uint8Array, payload: WorkflowCursorPayload): WorkflowRunCursor;
+export declare function encodeWorkflowCursor(payload: WorkflowCursorPayload | LegacyCursorPayload): WorkflowRunCursor;
+/** Decode a cursor with the authenticated three-argument API. */
+export declare function decodeWorkflowCursor(secret: Uint8Array, cursor: string, expected: WorkflowCursorExpectation): WorkflowCursorDecodeResult;
+/** Compatibility decoder used by the original Remote adapter. */
+export declare function decodeWorkflowCursor(cursor: WorkflowRunCursor, expected: LegacyCursorExpectation): WorkflowCursorPayload;
+interface LegacyCursorPayload {
+    readonly owner?: string;
+    readonly collection?: string;
+    readonly epoch?: string;
+    readonly revision: number;
+    readonly offset: number;
+    readonly kind?: WorkflowCursorKind;
+    readonly sessionId?: string;
+    readonly entityId?: string;
+    readonly collectionOwner?: string;
+    readonly processEpoch?: string;
+}
+interface LegacyCursorExpectation extends LegacyCursorPayload {
+    readonly total?: number;
+}
+export type { WorkflowRunCursor, WorkflowRunFeedEpoch };
+//# sourceMappingURL=cursors.d.ts.map

package/lib/types/supervisor/cursors.d.ts.map

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

package/lib/types/supervisor/cursors.js

@@ -0,0 +1,158 @@
+import { createHmac, randomBytes, timingSafeEqual } from 'node:crypto';
+/** Compatibility error used by the early package Remote adapter. */
+export class WorkflowCursorError extends Error {
+    code;
+    constructor(message, code) {
+        super(message);
+        this.name = 'WorkflowCursorError';
+        this.code = code;
+    }
+}
+const PROCESS_SECRET = randomBytes(32);
+const MAX_CURSOR_CHARS = 4096;
+const BASE64URL = /^[A-Za-z0-9_-]+$/u;
+const KINDS = new Set(['definitions', 'runs', 'members', 'logs', 'artifacts', 'artifact']);
+const encoder = new TextEncoder();
+function secretBytes(value) {
+    if (!(value instanceof Uint8Array) || value.byteLength !== 32) {
+        throw new TypeError('workflow cursor secret must be exactly 32 bytes');
+    }
+    return value;
+}
+function canonicalJson(value) {
+    // Deliberately spell the key order. JSON object insertion order is stable,
+    // but making it explicit prevents an innocuous refactor from invalidating
+    // every cursor in a running Client.
+    return JSON.stringify({
+        version: value.version,
+        kind: value.kind,
+        sessionId: value.sessionId,
+        entityId: value.entityId,
+        processEpoch: value.processEpoch,
+        revision: value.revision,
+        offset: value.offset,
+    });
+}
+function b64(value) {
+    return Buffer.from(value).toString('base64url');
+}
+function decodeB64(value) {
+    if (!BASE64URL.test(value))
+        return undefined;
+    try {
+        const bytes = Buffer.from(value, 'base64url');
+        // Node accepts non-canonical spellings. Round-tripping closes that gap.
+        if (bytes.length === 0 || b64(bytes) !== value)
+            return undefined;
+        return new Uint8Array(bytes);
+    }
+    catch {
+        return undefined;
+    }
+}
+function validText(value) {
+    return typeof value === 'string' && value.length > 0 && encoder.encode(value).byteLength <= 1024;
+}
+function validPayload(value) {
+    if (typeof value !== 'object' || value === null || Array.isArray(value))
+        return false;
+    const object = value;
+    const keys = Object.keys(object);
+    if (keys.length !== 7 || !keys.every(key => ['version', 'kind', 'sessionId', 'entityId', 'processEpoch', 'revision', 'offset'].includes(key)))
+        return false;
+    return object.version === 1
+        && typeof object.kind === 'string' && KINDS.has(object.kind)
+        && validText(object.sessionId)
+        && typeof object.entityId === 'string' && encoder.encode(object.entityId).byteLength <= 1024
+        && validText(object.processEpoch)
+        && Number.isSafeInteger(object.revision) && Number(object.revision) >= 0
+        && Number.isSafeInteger(object.offset) && Number(object.offset) >= 0;
+}
+function validExpectation(expected) {
+    return (expected.version === undefined || expected.version === 1)
+        && KINDS.has(expected.kind)
+        && validText(expected.sessionId)
+        && typeof expected.entityId === 'string'
+        && validText(expected.processEpoch)
+        && Number.isSafeInteger(expected.revision) && expected.revision >= 0
+        && Number.isSafeInteger(expected.total) && expected.total >= 0;
+}
+function encodeWithSecret(secret, payload) {
+    secretBytes(secret);
+    if (!validPayload(payload))
+        throw new TypeError('workflow cursor payload is invalid');
+    const body = b64(encoder.encode(canonicalJson(payload)));
+    const mac = b64(createHmac('sha256', secret).update(body, 'utf8').digest());
+    return `${body}.${mac}`;
+}
+export function encodeWorkflowCursor(secretOrPayload, maybePayload) {
+    if (maybePayload !== undefined)
+        return encodeWithSecret(secretBytes(secretOrPayload), maybePayload);
+    const legacy = secretOrPayload;
+    const payload = {
+        version: 1,
+        kind: legacy.kind ?? legacy.collection,
+        sessionId: legacy.sessionId ?? legacy.owner ?? '',
+        entityId: legacy.entityId ?? legacy.collectionOwner ?? '',
+        processEpoch: legacy.processEpoch ?? legacy.epoch ?? '',
+        revision: legacy.revision,
+        offset: legacy.offset,
+    };
+    return encodeWithSecret(PROCESS_SECRET, payload);
+}
+function decodeWithSecret(secret, cursor, expected) {
+    try {
+        secretBytes(secret);
+        if (typeof cursor !== 'string' || cursor.length === 0 || cursor.length > MAX_CURSOR_CHARS)
+            return { ok: false, reason: 'invalid' };
+        if (!validExpectation(expected))
+            return { ok: false, reason: 'invalid' };
+        const separator = cursor.indexOf('.');
+        if (separator <= 0 || separator !== cursor.lastIndexOf('.'))
+            return { ok: false, reason: 'invalid' };
+        const bodyText = cursor.slice(0, separator);
+        const macText = cursor.slice(separator + 1);
+        const body = decodeB64(bodyText);
+        const suppliedMac = decodeB64(macText);
+        if (!body || !suppliedMac || suppliedMac.byteLength !== 32)
+            return { ok: false, reason: 'invalid' };
+        const actualMac = createHmac('sha256', secret).update(bodyText, 'utf8').digest();
+        if (!timingSafeEqual(actualMac, Buffer.from(suppliedMac)))
+            return { ok: false, reason: 'invalid' };
+        const decodedText = new TextDecoder('utf-8', { fatal: true }).decode(body);
+        const parsed = JSON.parse(decodedText);
+        if (!validPayload(parsed) || JSON.stringify(parsed) !== decodedText)
+            return { ok: false, reason: 'invalid' };
+        if (parsed.kind !== expected.kind || parsed.sessionId !== expected.sessionId || parsed.entityId !== expected.entityId || parsed.processEpoch !== expected.processEpoch)
+            return { ok: false, reason: 'invalid' };
+        if (parsed.offset > expected.total)
+            return { ok: false, reason: 'invalid' };
+        if (parsed.revision !== expected.revision)
+            return { ok: false, reason: 'stale' };
+        return { ok: true, value: parsed };
+    }
+    catch {
+        return { ok: false, reason: 'invalid' };
+    }
+}
+export function decodeWorkflowCursor(secretOrCursor, cursorOrExpected, maybeExpected) {
+    if (maybeExpected !== undefined)
+        return decodeWithSecret(secretBytes(secretOrCursor), cursorOrExpected, maybeExpected);
+    const expected = cursorOrExpected;
+    const result = decodeWithSecret(PROCESS_SECRET, secretOrCursor, {
+        version: 1,
+        kind: (expected.kind ?? expected.collection),
+        sessionId: expected.sessionId ?? expected.owner ?? '',
+        entityId: expected.entityId ?? expected.collectionOwner ?? '',
+        processEpoch: expected.processEpoch ?? expected.epoch ?? '',
+        revision: expected.revision,
+        total: expected.total ?? Number.MAX_SAFE_INTEGER,
+    });
+    if (!result.ok) {
+        if (result.reason === 'stale')
+            throw new WorkflowCursorError('workflow page cursor is stale; refresh the collection', 'stale-cursor');
+        throw new WorkflowCursorError('workflow page cursor is invalid or belongs to another collection', 'invalid-cursor');
+    }
+    return result.value;
+}
+//# sourceMappingURL=cursors.js.map

package/lib/types/supervisor/cursors.js.map

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

package/lib/types/supervisor/engine-compat.d.ts

@@ -0,0 +1,48 @@
+/** Settlement payload the supervisor already understands. */
+export interface EngineResult {
+    readonly value: unknown;
+    readonly stopReason: 'completed' | 'cancelled' | 'error';
+    readonly error?: string;
+    readonly errorCode?: string;
+    readonly agentsStarted: number;
+}
+/** Replay journal captured after dispose. Unavailable on partial stock workers. */
+export interface WorkflowCheckpoint {
+    readonly journal: readonly {
+        readonly callId: readonly [number, ...number[]];
+        readonly fingerprint: string;
+        readonly kind: string;
+        readonly [key: string]: unknown;
+    }[];
+    readonly agentSpend: number;
+    readonly agentSeq: number;
+}
+/** Supervisor-facing live attempt. The stock worker handle implements a subset. */
+export interface EngineHandle {
+    readonly id: string;
+    readonly result: Promise<EngineResult>;
+    /**
+     * False only for a compatibility wrapper which cannot provide the replay
+     * authority required by Pause/Resume. Complete handles predate this hint, so
+     * an absent value means supported.
+     */
+    readonly supportsReplay?: boolean;
+    cancel(reason?: string): void;
+    resume(): void;
+    release(): void;
+    checkpoint(): WorkflowCheckpoint | undefined;
+    dispose(): Promise<void>;
+}
+/** True when the engine exposes the complete deferred-start and replay face. */
+export declare function isCompleteEngineHandle(raw: unknown): raw is EngineHandle;
+/**
+ * Stock `@deepseek-ai/dsh-workflow` `WorkflowRun` may expose only
+ * `id`/`result`/`cancel`/`dispose`. Wrap that thin face so the supervisor can
+ * admit a run instead of failing with "invalid run handle".
+ */
+export declare function adaptEngineHandle(raw: unknown): EngineHandle | undefined;
+/** Whether Pause/Resume can be offered without replaying committed effects. */
+export declare function supportsEngineReplay(handle: EngineHandle): boolean;
+/** Best-effort cancel/dispose of a handle the supervisor will not keep. */
+export declare function rejectPartialEngineHandle(raw: unknown): void;
+//# sourceMappingURL=engine-compat.d.ts.map

package/lib/types/supervisor/engine-compat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine-compat.d.ts","sourceRoot":"","sources":["../../../src/supervisor/engine-compat.ts"],"names":[],"mappings":"AAEA,6DAA6D;AAC7D,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAA;IACvB,QAAQ,CAAC,UAAU,EAAE,WAAW,GAAG,WAAW,GAAG,OAAO,CAAA;IACxD,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAA;CAC/B;AAED,mFAAmF;AACnF,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,OAAO,EAAE,SAAS;QACzB,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC,CAAA;QAC/C,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;QAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;QACrB,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;KAChC,EAAE,CAAA;IACH,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;CAC1B;AAED,mFAAmF;AACnF,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC,YAAY,CAAC,CAAA;IACtC;;;;OAIG;IACH,QAAQ,CAAC,cAAc,CAAC,EAAE,OAAO,CAAA;IACjC,MAAM,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC7B,MAAM,IAAI,IAAI,CAAA;IACd,OAAO,IAAI,IAAI,CAAA;IACf,UAAU,IAAI,kBAAkB,GAAG,SAAS,CAAA;IAC5C,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CACzB;AAUD,gFAAgF;AAChF,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,YAAY,CASxE;AAgBD;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,OAAO,GAAG,YAAY,GAAG,SAAS,CAgDxE;AAED,+EAA+E;AAC/E,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAElE;AAED,2EAA2E;AAC3E,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,OAAO,GAAG,IAAI,CAa5D"}