@decaf-ts/integrations 0.10.8 → 0.11.0

package/lib/esm/graph/engine/runs/GraphRunExecutor.js

@@ -1,286 +0,0 @@
-import { isGraphJsonValue, } from "@decaf-ts/ui-decorators/graph";
-import { GraphExecutionError } from "./../errors/index.js";
-import { GraphExecutionEventType, GraphExecutionStatus, } from "@decaf-ts/ui-decorators/graph";
-import { DEFAULT_GRAPH_RUN_LIMITS, isGraphRunTerminalEventType, } from "@decaf-ts/ui-decorators/graph";
-/**
- * Executes graph runs asynchronously (DECAF-50 §4.16): schedules a run
- * against the {@link GraphExecutionEngine}, mirrors engine events into the
- * run's sequenced SSE stream, enforces run timeouts via per-run
- * `AbortController`s, and finalizes the run's terminal state in the run
- * store. Exactly one execution per `runId` — repeated schedules await the
- * same completion promise.
- */
-export class GraphRunExecutor {
-    constructor(engine, runStore, publisher, hooks = {}, limits = {}) {
-        this.controllers = new Map();
-        this.completions = new Map();
-        this.timeouts = new Map();
-        this.engine = engine;
-        this.runStore = runStore;
-        this.publisher = publisher;
-        this.hooks = hooks;
-        this.limits = { ...DEFAULT_GRAPH_RUN_LIMITS, ...limits };
-    }
-    /** Returns (creating if needed) the run's `AbortController`. */
-    begin(runId) {
-        const existing = this.controllers.get(runId);
-        if (existing)
-            return existing;
-        const controller = new AbortController();
-        this.controllers.set(runId, controller);
-        return controller;
-    }
-    /** Aborts the run, if it is still in flight. Returns whether an abort was issued. */
-    abort(runId, reason) {
-        const controller = this.controllers.get(runId);
-        if (!controller)
-            return false;
-        if (!controller.signal.aborted)
-            controller.abort(reason);
-        return true;
-    }
-    /** Whether the run's abort signal has fired. */
-    isAborted(runId) {
-        return this.controllers.get(runId)?.signal.aborted === true;
-    }
-    /** The run's abort reason, when aborted. */
-    abortReason(runId) {
-        const signal = this.controllers.get(runId)?.signal;
-        if (!signal?.aborted)
-            return undefined;
-        return signal.reason === "timeout" ? "timeout" : "user";
-    }
-    /** The run's in-flight completion promise, when one is scheduled. */
-    waitFor(runId) {
-        return this.completions.get(runId);
-    }
-    /**
-     * Schedules the run for execution and returns its completion promise
-     * (deduplicated per `runId`). Engine events are mirrored to the run's SSE
-     * stream; failures still emit a terminal event and finalize the run as
-     * `failed`.
-     */
-    schedule(run, documentProvider, inputs, ...args) {
-        const existing = this.completions.get(run.runId);
-        if (existing)
-            return existing;
-        const completion = this.runExecution({ ...run }, documentProvider, inputs, ...args).catch(async (e) => {
-            const error = errorPayloadOf(e);
-            try {
-                await this.emitTerminal({ ...run }, GraphExecutionEventType.WORKFLOW_FAILED, error);
-            }
-            catch {
-                // the last-resort terminal event is best-effort
-            }
-            return await this.finalize({ ...run }, "failed", undefined, error, ...args);
-        });
-        this.completions.set(run.runId, completion);
-        return completion;
-    }
-    /** Releases all per-run state (controller, completion, timeout, publisher sequencing). */
-    release(runId) {
-        this.controllers.delete(runId);
-        this.completions.delete(runId);
-        const timeout = this.timeouts.get(runId);
-        if (timeout) {
-            clearTimeout(timeout);
-            this.timeouts.delete(runId);
-        }
-        this.publisher.release(runId);
-    }
-    armTimeout(runId) {
-        const timeout = setTimeout(() => {
-            this.timeouts.delete(runId);
-            this.abort(runId, "timeout");
-        }, this.limits.executionTimeoutMs);
-        this.timeouts.set(runId, timeout);
-    }
-    async runExecution(current, documentProvider, inputs, ...args) {
-        const runId = current.runId;
-        let terminalEmitted = false;
-        let lastError;
-        let result;
-        const unsubscribe = this.engine.observe({
-            refresh: async (event) => {
-                if (event.runId !== runId)
-                    return;
-                if (event.error)
-                    lastError = event.error;
-                const envelope = await this.publisher.publish(this.envelopeOf(current, event));
-                if (isGraphRunTerminalEventType(envelope.type)) {
-                    terminalEmitted = true;
-                }
-                else if (event.type === GraphExecutionEventType.WORKFLOW_STARTED &&
-                    current.status === "validating") {
-                    current.status = "running";
-                    await this.persist(current, ...args);
-                }
-            },
-        });
-        this.armTimeout(runId);
-        try {
-            if (this.isAborted(runId)) {
-                const error = {
-                    name: "GraphRunCancelledError",
-                    message: `Graph run '${runId}' was cancelled before execution started`,
-                    code: "GRAPH_RUN_CANCELLED",
-                };
-                lastError = error;
-                await this.emitTerminal(current, GraphExecutionEventType.WORKFLOW_CANCELLED, error);
-                terminalEmitted = true;
-                return await this.finalize(current, "cancelled", undefined, error, ...args);
-            }
-            current.status = "validating";
-            current.startedAt = new Date().toISOString();
-            await this.persist(current, ...args);
-            let document;
-            let fingerprint;
-            try {
-                ({ document, fingerprint } = await documentProvider(...args));
-                current.documentFingerprint = fingerprint;
-                await this.persist(current, ...args);
-            }
-            catch (e) {
-                const error = errorPayloadOf(e);
-                lastError = error;
-                if (!terminalEmitted) {
-                    await this.emitTerminal(current, GraphExecutionEventType.WORKFLOW_FAILED, error);
-                    terminalEmitted = true;
-                }
-                return await this.finalize(current, "failed", undefined, error, ...args);
-            }
-            if (this.isAborted(runId)) {
-                const error = {
-                    name: "GraphRunCancelledError",
-                    message: `Graph run '${runId}' was cancelled before execution started`,
-                    code: "GRAPH_RUN_CANCELLED",
-                };
-                lastError = error;
-                if (!terminalEmitted) {
-                    await this.emitTerminal(current, GraphExecutionEventType.WORKFLOW_CANCELLED, error);
-                    terminalEmitted = true;
-                }
-                return await this.finalize(current, "cancelled", undefined, error, ...args);
-            }
-            try {
-                result = await this.engine.execute(document, inputs, {
-                    runId,
-                    abortSignal: this.controllers.get(runId)?.signal,
-                    metadata: { documentFingerprint: fingerprint },
-                });
-            }
-            catch (e) {
-                lastError = errorPayloadOf(e);
-            }
-            const abortReason = this.abortReason(runId);
-            let status;
-            let error;
-            if (abortReason === "timeout") {
-                status = "failed";
-                error =
-                    lastError ??
-                        {
-                            name: "GraphRunTimeoutError",
-                            message: `Graph run '${runId}' exceeded the configured execution timeout of ${this.limits.executionTimeoutMs}ms`,
-                            code: "GRAPH_RUN_TIMEOUT",
-                        };
-            }
-            else if (abortReason === "user") {
-                status = "cancelled";
-                error = lastError;
-            }
-            else if (result?.status === GraphExecutionStatus.SUCCEEDED) {
-                status = "succeeded";
-            }
-            else if (result?.status === GraphExecutionStatus.CANCELLED) {
-                status = "cancelled";
-                error = lastError;
-            }
-            else {
-                status = "failed";
-                error =
-                    lastError ??
-                        errorPayloadOf(new GraphExecutionError(result
-                            ? `Graph run '${runId}' failed`
-                            : `Graph run '${runId}' failed without a result`, "GRAPH_RUN_FAILED", { runId }));
-            }
-            if (!terminalEmitted) {
-                await this.emitTerminal(current, status === "succeeded"
-                    ? GraphExecutionEventType.WORKFLOW_COMPLETED
-                    : status === "cancelled"
-                        ? GraphExecutionEventType.WORKFLOW_CANCELLED
-                        : GraphExecutionEventType.WORKFLOW_FAILED, error);
-            }
-            return await this.finalize(current, status, result, error, ...args);
-        }
-        finally {
-            unsubscribe();
-            const timeout = this.timeouts.get(runId);
-            if (timeout) {
-                clearTimeout(timeout);
-                this.timeouts.delete(runId);
-            }
-        }
-    }
-    async emitTerminal(run, type, error) {
-        await this.publisher.publish({
-            runId: run.runId,
-            workflowId: run.workflowId,
-            type,
-            error,
-        });
-    }
-    async finalize(current, status, result, error, ...args) {
-        current.status = status;
-        if (result)
-            current.result = result;
-        if (error)
-            current.error = error;
-        if (!current.startedAt)
-            current.startedAt = new Date().toISOString();
-        current.finishedAt = new Date().toISOString();
-        await this.persist(current, ...args);
-        try {
-            await this.hooks.onRunCompleted?.(current, result);
-        }
-        catch {
-            // result persistence failures must not mask the run's terminal state
-        }
-        return current;
-    }
-    async persist(run, ...args) {
-        await this.runStore.saveRun({ ...run }, ...args);
-    }
-    envelopeOf(run, event) {
-        return {
-            runId: run.runId,
-            workflowId: event.workflowId ?? run.workflowId,
-            type: event.type,
-            nodeId: event.nodeId,
-            edgeId: event.edgeId,
-            payload: event.payload === undefined
-                ? undefined
-                : isGraphJsonValue(event.payload)
-                    ? event.payload
-                    : { nonSerializable: true },
-            error: event.error,
-            parentRunId: event.parentRunId,
-            path: event.path,
-        };
-    }
-}
-function errorPayloadOf(e) {
-    if (e instanceof Error) {
-        return {
-            name: e.name,
-            message: e.message,
-            stack: e.stack,
-            code: e.graphCode ??
-                (typeof e.code === "number"
-                    ? String(e.code)
-                    : e.code),
-        };
-    }
-    return { name: "UnknownError", message: String(e) };
-}
-//# sourceMappingURL=GraphRunExecutor.js.map

package/lib/esm/graph/engine/runs/GraphRunExecutor.js.map

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

package/lib/esm/graph/engine/runs/GraphRunFingerprint.js

@@ -1,25 +0,0 @@
-import { createHash } from "node:crypto";
-function stableStringify(value) {
-    if (value === null || typeof value !== "object")
-        return JSON.stringify(value);
-    if (Array.isArray(value)) {
-        return `[${value.map((item) => stableStringify(item)).join(",")}]`;
-    }
-    const record = value;
-    const keys = Object.keys(record)
-        .filter((key) => record[key] !== undefined)
-        .sort();
-    return `{${keys
-        .map((key) => `${JSON.stringify(key)}:${stableStringify(record[key])}`)
-        .join(",")}}`;
-}
-/**
- * Computes a stable SHA-256 fingerprint of a canonical
- * {@link GraphWorkflowDocument}: object keys are sorted and `undefined`
- * values skipped, so documents that serialize identically always produce the
- * same fingerprint regardless of key insertion order.
- */
-export function graphRunDocumentFingerprint(document) {
-    return createHash("sha256").update(stableStringify(document)).digest("hex");
-}
-//# sourceMappingURL=GraphRunFingerprint.js.map

package/lib/esm/graph/engine/runs/GraphRunFingerprint.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"GraphRunFingerprint.js","sourceRoot":"","sources":["../../../../../src/graph/engine/runs/GraphRunFingerprint.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAGzC,SAAS,eAAe,CAAC,KAAc;IACrC,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IAC9E,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,IAAI,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;IACrE,CAAC;IACD,MAAM,MAAM,GAAG,KAAgC,CAAC;IAChD,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC;SAC7B,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,SAAS,CAAC;SAC1C,IAAI,EAAE,CAAC;IACV,OAAO,IAAI,IAAI;SACZ,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,eAAe,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;SACtE,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;AAClB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,2BAA2B,CACzC,QAA+B;IAE/B,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,eAAe,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC"}

package/lib/esm/graph/engine/runs/GraphRunService.js

@@ -1,254 +0,0 @@
-/**
- * @module integrations/graph/engine/runs/GraphRunService
- * @summary Graph run lifecycle service (DECAF-50 §4.16).
- * @description Creates, tracks, cancels, and observes graph runs on top of a
- * {@link GraphRunStore} and {@link GraphRunEventStore}: per-caller run
- * limits (concurrency buckets keyed by owner or caller key, timeout, event
- * payload size), fail-closed ownership scoping on every read/cancel,
- * event-state auto-release after the replay window (SAA-595), and the
- * sequenced event stream the SSE controller replays.
- */
-import { NotFoundError, ValidationError } from "@decaf-ts/db-decorators";
-import { isGraphJsonSafeValue, isGraphWorkflowDocumentShape, } from "@decaf-ts/ui-decorators/graph";
-import { GraphRunEventPublisher, GraphRunExecutor, } from "./index.js";
-import { graphRunDocumentFingerprint } from "./GraphRunFingerprint.js";
-import { DEFAULT_GRAPH_RUN_LIMITS, isGraphRunTerminalStatus, } from "@decaf-ts/ui-decorators/graph";
-import { assertGraphResourceOwnership } from "./ownership.js";
-/**
- * Run lifecycle service (DECAF-50 §4.16): creates, tracks, cancels, and
- * observes graph runs on top of a {@link GraphRunStore} and
- * {@link GraphRunEventStore}. Enforces per-caller run limits (concurrency
- * buckets keyed by owner or caller key, timeout, event payload size), scopes
- * every read/cancel to the owning user, auto-releases retained event state
- * after the configured replay window (SAA-595), and exposes the sequenced
- * event stream the SSE controller replays.
- */
-export class GraphRunService {
-    constructor(engine, runStore, eventStore, options = {}) {
-        this.activeByCaller = new Map();
-        this.callerKeysByRun = new Map();
-        this.releaseTimers = new Map();
-        this.engine = engine;
-        this.runStore = runStore;
-        this.eventStore = eventStore;
-        this.publisher = new GraphRunEventPublisher(eventStore, options.limits);
-        this.executor = new GraphRunExecutor(engine, runStore, this.publisher, { onRunCompleted: options.onRunCompleted }, options.limits);
-        this.options = {
-            ...options,
-            limits: { ...DEFAULT_GRAPH_RUN_LIMITS, ...options.limits },
-        };
-    }
-    /** Effective run limits, with defaults applied. */
-    get limits() {
-        return this.options.limits;
-    }
-    /**
-     * Creates and schedules a run for a saved `workflowId` or an inline
-     * workflow document, enforcing the per-caller concurrency limit and
-     * ownership bookkeeping. Returns the queued run immediately; execution
-     * continues in the background.
-     *
-     * `concurrencyKey` buckets anonymous callers for the per-caller
-     * concurrency cap (e.g. a per-IP key from the HTTP layer); it defaults to
-     * the owner user, or `"anonymous"` when both are absent.
-     *
-     * @throws ValidationError when the request carries no workflow identity, a
-     * `workflowId` without a configured resolver, or the per-caller concurrency
-     * limit is exhausted.
-     */
-    async createRun(request, ownerUser, concurrencyKey, ...args) {
-        this.validateCreateRequest(request);
-        const workflowId = request.workflowId ?? request.workflow?.id ?? "";
-        if (!workflowId) {
-            throw new ValidationError("Graph run request must carry a workflow document with an id or a saved workflowId");
-        }
-        if (request.workflowId && !this.options.documentResolver) {
-            throw new ValidationError("Graph run requests by workflowId require a document resolver");
-        }
-        const callerKey = concurrencyKey ?? ownerUser ?? "anonymous";
-        const activeForCaller = this.activeByCaller.get(callerKey) ?? new Set();
-        if (activeForCaller.size >= this.options.limits.maxConcurrentRuns) {
-            throw new ValidationError(`Graph run rejected: the configured limit of ${this.options.limits.maxConcurrentRuns} concurrent runs per caller is exhausted`);
-        }
-        const runId = this.generateRunId();
-        const run = {
-            runId,
-            workflowId,
-            ownerUser,
-            status: "queued",
-            createdAt: new Date().toISOString(),
-        };
-        this.executor.begin(runId);
-        await this.runStore.saveRun({ ...run }, ...args);
-        const provider = this.documentProviderFor(request, ownerUser);
-        activeForCaller.add(runId);
-        this.activeByCaller.set(callerKey, activeForCaller);
-        this.callerKeysByRun.set(runId, callerKey);
-        const completion = this.executor.schedule(run, provider, request.inputs ?? {}, ...args);
-        void completion
-            .catch(() => undefined)
-            .finally(() => this.finishActiveRun(runId));
-        return run;
-    }
-    /** Reads a run, asserting it belongs to `ownerUser`. */
-    async getRun(runId, ownerUser, ...args) {
-        const run = await this.runStore.readRun(runId, ...args);
-        if (!run) {
-            throw new NotFoundError(`No graph run found for runId '${runId}'`);
-        }
-        this.assertOwnership(run, ownerUser);
-        return run;
-    }
-    /**
-     * Cancels a non-terminal run: aborts in-flight execution and persists the
-     * `cancelled` status. Terminal runs are returned unchanged.
-     */
-    async cancelRun(runId, ownerUser, ...args) {
-        const run = await this.runStore.readRun(runId, ...args);
-        if (!run) {
-            throw new NotFoundError(`No graph run found for runId '${runId}'`);
-        }
-        this.assertOwnership(run, ownerUser);
-        if (isGraphRunTerminalStatus(run.status)) {
-            return run;
-        }
-        this.executor.abort(runId, "user");
-        run.status = "cancelled";
-        run.finishedAt = new Date().toISOString();
-        await this.runStore.saveRun({ ...run }, ...args);
-        return run;
-    }
-    /** Lists a run's event envelopes after the given sequence (ownership-checked). */
-    async listEvents(runId, afterSequence, ownerUser, ...args) {
-        await this.getRun(runId, ownerUser, ...args);
-        return this.eventStore.listAfter(runId, afterSequence);
-    }
-    /** Subscribes a live listener to a run's event stream (ownership-checked); returns an unsubscribe function. */
-    async subscribeEvents(runId, ownerUser, listener, ...args) {
-        await this.getRun(runId, ownerUser, ...args);
-        return this.eventStore.subscribe(runId, listener);
-    }
-    /** Subscribes a listener to a run's event stream without re-reading the run. */
-    subscribeRunEvents(run, listener) {
-        return this.eventStore.subscribe(run.runId, listener);
-    }
-    /** Waits for a scheduled run to finish, then returns its final state. */
-    async waitForRun(runId, ownerUser, ...args) {
-        const completion = this.executor.waitFor(runId);
-        if (completion)
-            await completion;
-        return this.getRun(runId, ownerUser, ...args);
-    }
-    /**
-     * Convenience helper: creates a run and waits for its completion. The
-     * optional `concurrencyKey` is forwarded to {@link createRun} to bucket
-     * anonymous callers for the per-caller concurrency cap.
-     */
-    async executeAndWait(request, ownerUser, concurrencyKey, ...args) {
-        const run = await this.createRun(request, ownerUser, concurrencyKey, ...args);
-        return this.waitForRun(run.runId, ownerUser, ...args);
-    }
-    /**
-     * Releases all per-run bookkeeping for a finished run: caller-bucket
-     * membership, executor state, publisher sequencing, retained event state,
-     * and any pending auto-release timer.
-     */
-    release(runId) {
-        this.finishActiveRun(runId);
-        const pending = this.releaseTimers.get(runId);
-        if (pending) {
-            clearTimeout(pending);
-            this.releaseTimers.delete(runId);
-        }
-        this.executor.release(runId);
-        this.eventStore.release?.(runId);
-    }
-    /**
-     * Removes a run from its caller's concurrency bucket and schedules event
-     * state release after the configured replay window.
-     */
-    finishActiveRun(runId) {
-        const callerKey = this.callerKeysByRun.get(runId);
-        if (callerKey !== undefined) {
-            this.callerKeysByRun.delete(runId);
-            const bucket = this.activeByCaller.get(callerKey);
-            if (bucket) {
-                bucket.delete(runId);
-                if (bucket.size === 0)
-                    this.activeByCaller.delete(callerKey);
-            }
-        }
-        if (this.releaseTimers.has(runId))
-            return;
-        const timer = setTimeout(() => {
-            this.releaseTimers.delete(runId);
-            this.release(runId);
-        }, this.options.limits.eventReplayWindowMs);
-        timer.unref?.();
-        this.releaseTimers.set(runId, timer);
-    }
-    validateCreateRequest(request) {
-        if (!request || typeof request !== "object" || Array.isArray(request)) {
-            throw new ValidationError("Graph run request must be an object carrying either a workflow document or a workflowId plus inputs");
-        }
-        const hasDocument = request.workflow !== undefined;
-        const hasWorkflowId = request.workflowId !== undefined;
-        if (hasDocument && hasWorkflowId) {
-            throw new ValidationError("Graph run request is ambiguous: supply either an unsaved workflow document or a saved workflowId, not both");
-        }
-        if (!hasDocument && !hasWorkflowId) {
-            throw new ValidationError("Graph run request must supply either an unsaved workflow document or a saved workflowId");
-        }
-        if (hasDocument && !isGraphWorkflowDocumentShape(request.workflow)) {
-            throw new ValidationError("Graph run request carries a payload that is not a canonical GraphWorkflowDocument");
-        }
-        if (request.inputs !== undefined && !isGraphJsonSafeValue(request.inputs)) {
-            throw new ValidationError("Graph run inputs must be JSON-safe: functions, class instances, undefined, NaN/Infinity, symbol keys and unsafe prototype keys (__proto__/prototype/constructor) are rejected");
-        }
-        const bytes = safeJsonLength(request);
-        if (bytes > this.options.limits.maxRequestBytes) {
-            throw new ValidationError(`Graph run request of ${bytes} bytes exceeds the configured limit of ${this.options.limits.maxRequestBytes} bytes`);
-        }
-    }
-    documentProviderFor(request, ownerUser) {
-        if (request.workflow) {
-            const document = request.workflow;
-            return async () => ({
-                document,
-                fingerprint: graphRunDocumentFingerprint(document),
-            });
-        }
-        const workflowId = request.workflowId;
-        return async (...args) => {
-            const resolver = this.options.documentResolver;
-            if (!resolver) {
-                throw new ValidationError("Graph run requests by workflowId require a document resolver");
-            }
-            const document = await resolver.resolve(workflowId, ownerUser, ...args);
-            return {
-                document,
-                fingerprint: graphRunDocumentFingerprint(document),
-            };
-        };
-    }
-    assertOwnership(run, ownerUser) {
-        assertGraphResourceOwnership({ owner: run.ownerUser }, ownerUser, {
-            allowAnonymousAccess: this.options.allowAnonymousAccess === true,
-            resourceKind: "Graph run",
-            resourceId: run.runId,
-        });
-    }
-    generateRunId() {
-        return (globalThis.crypto?.randomUUID?.() ??
-            `graph-run-${Date.now()}-${Math.random().toString(36).slice(2)}`);
-    }
-}
-function safeJsonLength(value) {
-    try {
-        return JSON.stringify(value)?.length ?? 0;
-    }
-    catch {
-        return Number.MAX_SAFE_INTEGER;
-    }
-}
-//# sourceMappingURL=GraphRunService.js.map

package/lib/esm/graph/engine/runs/GraphRunService.js.map

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

package/lib/esm/graph/engine/runs/InMemoryGraphRunEventStore.js

@@ -1,64 +0,0 @@
-import { DEFAULT_GRAPH_RUN_LIMITS, isGraphRunTerminalEventType, } from "@decaf-ts/ui-decorators/graph";
-/**
- * Non-persistent {@link GraphRunEventStore} backed by per-run arrays:
- * appends notify live subscribers, `listAfter` serves SSE replays, and
- * retention keeps at most `maxEventsPerRun` envelopes per run — evicting
- * non-terminal events first so terminal outcomes are never dropped.
- */
-export class InMemoryGraphRunEventStore {
-    constructor(limits = {}) {
-        this.events = new Map();
-        this.listeners = new Map();
-        this.limits = { ...DEFAULT_GRAPH_RUN_LIMITS, ...limits };
-    }
-    async append(event) {
-        let list = this.events.get(event.runId);
-        if (!list) {
-            list = [];
-            this.events.set(event.runId, list);
-        }
-        list.push(event);
-        this.enforceRetention(list);
-        for (const listener of this.listeners.get(event.runId) ?? []) {
-            try {
-                listener(event);
-            }
-            catch {
-                // a misbehaving subscriber must not break the append pipeline
-            }
-        }
-    }
-    async listAfter(runId, sequence) {
-        const list = this.events.get(runId);
-        if (!list)
-            return [];
-        return list.filter((event) => event.sequence > sequence);
-    }
-    subscribe(runId, listener) {
-        let set = this.listeners.get(runId);
-        if (!set) {
-            set = new Set();
-            this.listeners.set(runId, set);
-        }
-        set.add(listener);
-        return () => {
-            set.delete(listener);
-            if (set.size === 0)
-                this.listeners.delete(runId);
-        };
-    }
-    release(runId) {
-        this.events.delete(runId);
-        this.listeners.delete(runId);
-    }
-    enforceRetention(list) {
-        const max = this.limits.maxEventsPerRun;
-        while (list.length > max) {
-            const evictIndex = list.findIndex((event) => !isGraphRunTerminalEventType(event.type));
-            if (evictIndex === -1)
-                break;
-            list.splice(evictIndex, 1);
-        }
-    }
-}
-//# sourceMappingURL=InMemoryGraphRunEventStore.js.map