@sixb/core 0.1.18 → 0.1.19

package/dist/actions/run/executor.d.ts

@@ -0,0 +1,95 @@
+import type { ActionRunRecord } from "../../storage";
+import { type ActionRunRequestPayload, type AssertCanReuseActionRun, type PersistedActionRun } from "../run-persistence";
+import { type ActionRunHost } from "./execute";
+/** A request for an Action run, handed over to execute in the requesting process. */
+export interface ActionRunRequest {
+    readonly runId: string;
+    readonly payload: ActionRunRequestPayload;
+    /** Find the record of an earlier request with the same run id, or create the run's execution. */
+    readonly persist: () => Promise<PersistedActionRun>;
+    /** Refuse a run that already exists under the run id, when this request's caller may not have it. */
+    readonly assertCanReuse: AssertCanReuseActionRun;
+    /** Cancels the run before its irreversible boundary. */
+    readonly signal?: AbortSignal;
+    /** Called once the run's execution exists, before the run executes. A throw starts nothing. */
+    readonly onRequested?: (runId: string) => void | Promise<void>;
+}
+/**
+ * Runs requested Actions in the calling process, and tracks each request until its run is recorded
+ * and its effects ended, so that a stopping process can wait for them.
+ *
+ * `SixbHost` registers one on itself and on the context its bound SDKs share, so a request can
+ * execute its run without holding the host.
+ */
+export declare class ActionRunExecutor {
+    private readonly host;
+    private readonly inFlight;
+    /** Run ids held by a request of this process, until it ends. */
+    private readonly held;
+    private stopping;
+    constructor(host: ActionRunHost);
+    /**
+     * Execute a requested run to its terminal record, or answer with the record of an earlier request
+     * for the same run id.
+     *
+     * The request is tracked from before anything is persisted, so that {@link drain} waits for it
+     * from the start. Once the process is stopping, a new request is refused before anything is
+     * persisted. A request for a run id that this process is executing is refused as in progress:
+     * see {@link joinHeldRunId}. A request for the same run id in another process executes too, and
+     * the request that records it second answers with the first one's record, under the same checks
+     * as any record it finds.
+     *
+     * Once the run's execution exists, the request either resolves with the run's record or rejects
+     * with `internal.unexpected`: see {@link failRequest}.
+     */
+    request(request: ActionRunRequest): Promise<ActionRunRecord>;
+    /**
+     * Refuse new requests, then wait for at most `timeoutMs` for those in flight and for the effects
+     * they start meanwhile.
+     */
+    drain(timeoutMs: number): Promise<void>;
+    /** Track work until it settles. Whoever started it handles how it ends; this only waits. */
+    private track;
+    private dispatch;
+    /**
+     * Answer a request for a run id that a request of this process executes.
+     *
+     * Nothing is stored about a run before it ends, so this process is the only one that knows the
+     * run is in progress. The request gets what a stored run would give it: refused when its caller
+     * may not have the run or asks for something else, the record once it is written, and
+     * `action.run_in_progress` until then.
+     */
+    private joinHeldRunId;
+    private holdAndExecute;
+    private execute;
+    /**
+     * Start a recorded run's effects once the request has returned, tracked until they end. Deferring
+     * them keeps a handler that does synchronous work before its first `await` from delaying the
+     * response.
+     */
+    private startEffects;
+    /**
+     * Fail a request whose run's execution exists.
+     *
+     * The run may have executed, so the caller gets an `internal.unexpected` error that names the run
+     * and says what requesting it again does, never what went wrong inside it: that goes to
+     * `onError`, once, with the failure the run recorded or would have recorded. Errors outside the
+     * run's phases fail it in `validation`, the phase it starts in.
+     */
+    private failRequest;
+}
+/**
+ * Attach the executor to a host or runtime context. The property is enumerable so that spreading a
+ * context into a narrower one carries it along.
+ */
+export declare function registerActionRunExecutor(owner: object, executor: ActionRunExecutor): void;
+export declare function getActionRunExecutor(owner: object): ActionRunExecutor;
+/** Copy the executor, when there is one, onto an internal runtime context being reconstructed. */
+export declare function shareActionRunExecutor(source: object, target: object): void;
+/**
+ * Refuse new Action requests on this host, then wait for at most `timeoutMs` for those in flight.
+ *
+ * Every `SixbHost` has an executor from construction on, so an object without one is not a host.
+ */
+export declare function drainActionRuns(host: object, timeoutMs: number): Promise<void>;
+//# sourceMappingURL=executor.d.ts.map

package/dist/actions/run/executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"executor.d.ts","sourceRoot":"","sources":["../../../src/actions/run/executor.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AACpD,OAAO,EACL,KAAK,uBAAuB,EAC5B,KAAK,uBAAuB,EAE5B,KAAK,kBAAkB,EACxB,MAAM,oBAAoB,CAAA;AAC3B,OAAO,EAAE,KAAK,aAAa,EAAoB,MAAM,WAAW,CAAA;AAKhE,qFAAqF;AACrF,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,OAAO,EAAE,uBAAuB,CAAA;IACzC,iGAAiG;IACjG,QAAQ,CAAC,OAAO,EAAE,MAAM,OAAO,CAAC,kBAAkB,CAAC,CAAA;IACnD,qGAAqG;IACrG,QAAQ,CAAC,cAAc,EAAE,uBAAuB,CAAA;IAChD,wDAAwD;IACxD,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAA;IAC7B,+FAA+F;IAC/F,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CAC/D;AAaD;;;;;;GAMG;AACH,qBAAa,iBAAiB;IAMhB,OAAO,CAAC,QAAQ,CAAC,IAAI;IALjC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA2B;IACpD,gEAAgE;IAChE,OAAO,CAAC,QAAQ,CAAC,IAAI,CAA+B;IACpD,OAAO,CAAC,QAAQ,CAAQ;gBAEK,IAAI,EAAE,aAAa;IAEhD;;;;;;;;;;;;;OAaG;IACH,OAAO,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,eAAe,CAAC;IAc5D;;;OAGG;IACG,KAAK,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAe7C,4FAA4F;IAC5F,OAAO,CAAC,KAAK;YAYC,QAAQ;IAUtB;;;;;;;OAOG;YACW,aAAa;YAiBb,cAAc;YAed,OAAO;IAiCrB;;;;OAIG;IACH,OAAO,CAAC,YAAY;IAUpB;;;;;;;OAOG;IACH,OAAO,CAAC,WAAW;CAsBpB;AAQD;;;GAGG;AACH,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,iBAAiB,GAAG,IAAI,CAW1F;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,iBAAiB,CAMrE;AAED,kGAAkG;AAClG,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAG3E;AAED;;;;GAIG;AACH,wBAAsB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAMpF"}

package/dist/actions/run/normalize.d.ts

@@ -0,0 +1,36 @@
+import { type SixbCodedError } from "../../errors/internal";
+import { type ActionRunFailure, type ActionRunPhase } from "../../storage";
+export declare function throwIfAborted(signal: AbortSignal): void;
+/**
+ * Wait for a handler until the signal of its phase aborts, then reject with the abort's reason.
+ *
+ * A handler stops early only when it forwards its `signal` to what it awaits. One that does not
+ * keeps running after the abort, but the run no longer waits for it: nothing it does from then on
+ * reaches the run, and what it throws is dropped.
+ */
+export declare function untilAborted<T>(work: () => Promise<T>, signal: AbortSignal): Promise<T>;
+/**
+ * Translate work performed by an Action phase without misclassifying its bookkeeping.
+ *
+ * Whatever a handler throws once its phase's signal aborted is that abort's doing: the run failed
+ * with `action.timeout` when its deadline elapsed, and with `runtime.cancelled` when its caller
+ * aborted. The handler's own error stays the cause reported to `onError`. Every expectation an
+ * Action commit carries comes from the Action's own reads, so an expectation conflict at commit is
+ * a read conflict: the run can be requested again against current state.
+ */
+export declare function translateActionPhaseError(error: unknown, phase: ActionRunPhase, input: {
+    readonly actionId: string;
+    readonly runId: string;
+    /** The signal the work ran under. Omit it for work that nothing interrupts, like a commit. */
+    readonly signal?: AbortSignal;
+}): unknown;
+/** Whether a phase classified this error as the phase's own failure, rather than as an abort. */
+export declare function isActionPhaseFailure(error: unknown): error is SixbCodedError;
+/** Recover the native phase error for direct callers and error-monitoring integrations. */
+export declare function unwrapActionPhaseError(error: unknown): unknown;
+export declare function toActionRunFailure<TPhase extends ActionRunPhase>(error: unknown, phase: TPhase, input: {
+    readonly actionId: string;
+    readonly runId: string;
+    readonly at: Date;
+}): ActionRunFailure<TPhase>;
+//# sourceMappingURL=normalize.d.ts.map

package/dist/actions/run/normalize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize.d.ts","sourceRoot":"","sources":["../../../src/actions/run/normalize.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,cAAc,EAGpB,MAAM,uBAAuB,CAAA;AAE9B,OAAO,EAA4B,KAAK,gBAAgB,EAAE,KAAK,cAAc,EAAE,MAAM,eAAe,CAAA;AAIpG,wBAAgB,cAAc,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI,CAExD;AAQD;;;;;;GAMG;AACH,wBAAsB,YAAY,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,CAAC,CAAC,CAY7F;AAED;;;;;;;;GAQG;AACH,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,OAAO,EACd,KAAK,EAAE,cAAc,EACrB,KAAK,EAAE;IACL,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,8FAA8F;IAC9F,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAA;CAC9B,GACA,OAAO,CAgCT;AAED,iGAAiG;AACjG,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,cAAc,CAK5E;AAED,2FAA2F;AAC3F,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAE9D;AAED,wBAAgB,kBAAkB,CAAC,MAAM,SAAS,cAAc,EAC9D,KAAK,EAAE,OAAO,EACd,KAAK,EAAE,MAAM,EACb,KAAK,EAAE;IACL,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAA;CAClB,GACA,gBAAgB,CAAC,MAAM,CAAC,CAyB1B"}

package/dist/actions/run/phase-types.d.ts

@@ -0,0 +1,18 @@
+import type { ObjectTypeWithPropertyTokens } from "../../ontology/tokens";
+import type { ObjectRow } from "../../storage";
+import type { ActionDefinition, ActionTargetObject } from "../types";
+import type { ActionRunContext } from "./types";
+export type LoadedObjectTarget = {
+    readonly subjectObjectType: ObjectTypeWithPropertyTokens;
+    readonly snapshot: ActionTargetObject;
+    /** The exact row the subject was loaded from, recorded as a commit-time read dependency. */
+    readonly row: ObjectRow;
+};
+export type PhaseExecutionBase = {
+    readonly runtime: ActionRunContext;
+    readonly action: ActionDefinition;
+    /** The signal this phase's handler runs under; see `ActionRunSignals`. */
+    readonly signal: AbortSignal;
+};
+export type RuntimePhaseHandler = (ctx: unknown) => unknown;
+//# sourceMappingURL=phase-types.d.ts.map

package/dist/actions/run/phase-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"phase-types.d.ts","sourceRoot":"","sources":["../../../src/actions/run/phase-types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,uBAAuB,CAAA;AACzE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAA;AAC9C,OAAO,KAAK,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAA;AACpE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAA;AAE/C,MAAM,MAAM,kBAAkB,GAAG;IAC/B,QAAQ,CAAC,iBAAiB,EAAE,4BAA4B,CAAA;IACxD,QAAQ,CAAC,QAAQ,EAAE,kBAAkB,CAAA;IACrC,4FAA4F;IAC5F,QAAQ,CAAC,GAAG,EAAE,SAAS,CAAA;CACxB,CAAA;AAED,MAAM,MAAM,kBAAkB,GAAG;IAC/B,QAAQ,CAAC,OAAO,EAAE,gBAAgB,CAAA;IAClC,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAA;IACjC,0EAA0E;IAC1E,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAA;CAC7B,CAAA;AAED,MAAM,MAAM,mBAAmB,GAAG,CAAC,GAAG,EAAE,OAAO,KAAK,OAAO,CAAA"}

package/dist/actions/run/phases.d.ts

@@ -0,0 +1,20 @@
+import type { ActionDefinition } from "../types";
+import { type CommittedActionRun } from "./edits-commit";
+import type { ActionRunSignals } from "./signals";
+import type { ActionRunState } from "./state";
+import type { ActionRunContext } from "./types";
+interface PhasesInput {
+    readonly runtime: ActionRunContext;
+    readonly action: ActionDefinition;
+    readonly state: ActionRunState;
+    readonly signals: ActionRunSignals;
+}
+/**
+ * Run the phases up to the commit, keeping what they do on the run's state.
+ *
+ * Resolves with the commit, which recorded the run, for an Action with edits; and with `null` for
+ * one without, whose run is still to record. Rejects when a phase fails.
+ */
+export declare function executeActionPhases(input: PhasesInput): Promise<CommittedActionRun | null>;
+export {};
+//# sourceMappingURL=phases.d.ts.map

package/dist/actions/run/phases.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"phases.d.ts","sourceRoot":"","sources":["../../../src/actions/run/phases.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAA;AAIhD,OAAO,EAAE,KAAK,kBAAkB,EAA0B,MAAM,gBAAgB,CAAA;AAEhF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAA;AACjD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAA;AAC7C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAA;AAQ/C,UAAU,WAAW;IACnB,QAAQ,CAAC,OAAO,EAAE,gBAAgB,CAAA;IAClC,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAA;IACjC,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAA;IAC9B,QAAQ,CAAC,OAAO,EAAE,gBAAgB,CAAA;CACnC;AAED;;;;;GAKG;AACH,wBAAsB,mBAAmB,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC,CAWhG"}

package/dist/actions/run/run-action.d.ts

@@ -0,0 +1,25 @@
+import type { RecordActionRunInput } from "../../storage";
+import type { ActionRunOutcome, RunActionInput } from "./types";
+/**
+ * A run that ended, but whose terminal record could not be written.
+ *
+ * It carries that record, so that whoever reports this error still reports how the run ended. Its
+ * cause is the error that kept the record from being written.
+ */
+export declare class UnrecordedActionRunError extends Error {
+    readonly record: RecordActionRunInput;
+    readonly name = "UnrecordedActionRunError";
+    constructor(record: RecordActionRunInput, options: {
+        readonly cause: unknown;
+    });
+}
+/**
+ * Execute a requested run to its end, and record it once.
+ *
+ * A run with edits is recorded by the commit of its edits; any other run, succeeded or failed, is
+ * recorded as soon as it ends. The run's effects are left to the caller to start: see
+ * {@link ActionRunOutcome.effects}. This rejects when the run cannot execute here, or with an
+ * {@link UnrecordedActionRunError} when its record cannot be written.
+ */
+export declare function runAction(input: RunActionInput): Promise<ActionRunOutcome>;
+//# sourceMappingURL=run-action.d.ts.map

package/dist/actions/run/run-action.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-action.d.ts","sourceRoot":"","sources":["../../../src/actions/run/run-action.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAoB,oBAAoB,EAAE,MAAM,eAAe,CAAA;AAQ3E,OAAO,KAAK,EAAoB,gBAAgB,EAAE,cAAc,EAAE,MAAM,SAAS,CAAA;AAEjF;;;;;GAKG;AACH,qBAAa,wBAAyB,SAAQ,KAAK;IAI/C,QAAQ,CAAC,MAAM,EAAE,oBAAoB;IAHvC,SAAkB,IAAI,8BAA6B;gBAGxC,MAAM,EAAE,oBAAoB,EACrC,OAAO,EAAE;QAAE,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAA;KAAE;CAIvC;AAED;;;;;;;GAOG;AACH,wBAAsB,SAAS,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAgDhF"}

package/dist/actions/run/signals.d.ts

@@ -0,0 +1,67 @@
+/** How long an Action run has to reach its irreversible boundary, and its effects after commit. */
+export declare const ACTION_TIMEOUT_MS = 30000;
+/**
+ * How long a stopping process waits for its in-flight Action runs and their effects: a run's
+ * deadline, then its effects' deadline, plus a margin.
+ *
+ * It does not bound a whole run. Edits past the boundary are uninterruptible, and effects start
+ * only once they committed, so a run or its effects can still be executing when the wait ends. A
+ * deployment's kill timeout must exceed this bound.
+ */
+export declare const ACTION_RUN_DRAIN_TIMEOUT_MS: number;
+export interface ActionRunSignalsInput {
+    readonly actionId: string;
+    readonly runId: string;
+    /** The caller's cancellation. It applies before the boundary only. */
+    readonly caller?: AbortSignal;
+    /** Test-only override of {@link ACTION_TIMEOUT_MS}. */
+    readonly timeoutMs?: number;
+}
+/**
+ * The cancellation one Action run observes, phase by phase.
+ *
+ * The irreversible boundary is a succeeded writeback, or the commit of an Action without one. Before
+ * it, validation, writeback and edits run under {@link beforeBoundary}, which aborts when the run's
+ * deadline elapses or its caller aborts. After it, edits and commit run under
+ * {@link uninterruptible}: abandoning them would strand an external change that the ontology never
+ * records. Effects run after the commit under a deadline of their own, which
+ * {@link startEffects} starts.
+ *
+ * Cancellation is cooperative: a handler stops early only when it forwards its `signal` to what it
+ * awaits. The run stops waiting for one that does not, wherever abandoning it loses nothing:
+ * validation, edits before the boundary, and effects (`untilAborted`). A writeback is always waited
+ * for, since only its result says whether the external change happened.
+ */
+export declare class ActionRunSignals {
+    readonly beforeBoundary: AbortSignal;
+    /**
+     * Never aborts, for the work that must run to completion once it starts. One per run: whatever
+     * listens to it is released with the run, not kept for the life of the process.
+     */
+    readonly uninterruptible: AbortSignal;
+    private readonly input;
+    private readonly deadline;
+    constructor(input: ActionRunSignalsInput);
+    /**
+     * Why the run stopped before its boundary: its deadline's `action.timeout` when the deadline
+     * elapsed first, or else a `runtime.cancelled` error caused by what its caller aborted with.
+     */
+    stopReason(): unknown;
+    /**
+     * Start the deadline the run's effects run under. It is independent of the run's own: effects
+     * start after the run is recorded, and the caller of the deadline disposes it once they end.
+     */
+    startEffects(): ActionDeadline;
+    /** Release the run's deadline timer. */
+    dispose(): void;
+}
+/** A signal that aborts with `action.timeout` once its scope's deadline elapses. */
+export declare class ActionDeadline {
+    readonly signal: AbortSignal;
+    private readonly timer;
+    constructor(input: Pick<ActionRunSignalsInput, "actionId" | "runId" | "timeoutMs">, scope: "run" | "effects");
+    /** Release the deadline timer. */
+    dispose(): void;
+}
+export declare function isActionTimeout(error: unknown): boolean;
+//# sourceMappingURL=signals.d.ts.map

package/dist/actions/run/signals.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"signals.d.ts","sourceRoot":"","sources":["../../../src/actions/run/signals.ts"],"names":[],"mappings":"AAEA,mGAAmG;AACnG,eAAO,MAAM,iBAAiB,QAAS,CAAA;AAEvC;;;;;;;GAOG;AACH,eAAO,MAAM,2BAA2B,QAAgC,CAAA;AAExE,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,sEAAsE;IACtE,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAA;IAC7B,uDAAuD;IACvD,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAC5B;AAED;;;;;;;;;;;;;;GAcG;AACH,qBAAa,gBAAgB;IAC3B,QAAQ,CAAC,cAAc,EAAE,WAAW,CAAA;IACpC;;;OAGG;IACH,QAAQ,CAAC,eAAe,EAAE,WAAW,CAA+B;IAEpE,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAuB;IAC7C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAgB;gBAE7B,KAAK,EAAE,qBAAqB;IAQxC;;;OAGG;IACH,UAAU,IAAI,OAAO;IAUrB;;;OAGG;IACH,YAAY,IAAI,cAAc;IAI9B,wCAAwC;IACxC,OAAO,IAAI,IAAI;CAGhB;AAED,oFAAoF;AACpF,qBAAa,cAAc;IACzB,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAA;IAC5B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA+B;gBAGnD,KAAK,EAAE,IAAI,CAAC,qBAAqB,EAAE,UAAU,GAAG,OAAO,GAAG,WAAW,CAAC,EACtE,KAAK,EAAE,KAAK,GAAG,SAAS;IAgB1B,kCAAkC;IAClC,OAAO,IAAI,IAAI;CAGhB;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAEvD"}

package/dist/actions/run/state.d.ts

@@ -0,0 +1,47 @@
+import type { JsonValue } from "../../json";
+import type { ActionRunFailure, ActionRunPhase, ActionRunWritebackRecord, RecordActionRunInput } from "../../storage";
+import type { PendingActionRun } from "./types";
+export type SucceededActionRunRecord = Extract<RecordActionRunInput, {
+    readonly status: "succeeded";
+}>;
+export type FailedActionRunRecord = Extract<RecordActionRunInput, {
+    readonly status: "failed";
+}>;
+/**
+ * What a run has done so far: the phase it reached and how its writeback ended.
+ *
+ * It lives in memory while the run executes, and nothing about the run is stored before it ends:
+ * its terminal record is built from this state once, when it succeeds or fails.
+ */
+export declare class ActionRunState {
+    readonly run: PendingActionRun;
+    /** When the run started executing, as its handlers and its record see it. */
+    readonly startedAt: Date;
+    private reached;
+    private writebackRecord;
+    constructor(run: PendingActionRun, 
+    /** When the run started executing, as its handlers and its record see it. */
+    startedAt: Date);
+    /** The last phase the run reached. */
+    get phase(): ActionRunPhase;
+    get writeback(): ActionRunWritebackRecord | undefined;
+    /** The value a succeeded writeback returned, which edits and effects receive. */
+    get writebackValue(): JsonValue | undefined;
+    /**
+     * Whether the run's deadline and caller no longer apply to it.
+     *
+     * True once its writeback succeeded, or once its commit started for an Action without one: from
+     * there the run either commits or fails on its own merits.
+     */
+    get pastBoundary(): boolean;
+    /** Enter a phase before the commit. The run is recorded before its effects run. */
+    enter(phase: Exclude<ActionRunPhase, "effects">): void;
+    /** Keep how the writeback ended. A run calls its writeback once, so this is set once. */
+    recordWriteback(writeback: ActionRunWritebackRecord): void;
+    /** The record of the run succeeding in the phase it reached. */
+    succeeded(finishedAt?: Date): SucceededActionRunRecord;
+    /** The record of the run failing with `error`, in the phase the failure names. */
+    failed(error: ActionRunFailure, finishedAt?: Date): FailedActionRunRecord;
+    private recordFields;
+}
+//# sourceMappingURL=state.d.ts.map

package/dist/actions/run/state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../../src/actions/run/state.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA;AAC3C,OAAO,KAAK,EACV,gBAAgB,EAChB,cAAc,EACd,wBAAwB,EACxB,oBAAoB,EACrB,MAAM,eAAe,CAAA;AACtB,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAA;AAE/C,MAAM,MAAM,wBAAwB,GAAG,OAAO,CAC5C,oBAAoB,EACpB;IAAE,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAA;CAAE,CACjC,CAAA;AACD,MAAM,MAAM,qBAAqB,GAAG,OAAO,CAAC,oBAAoB,EAAE;IAAE,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAA;CAAE,CAAC,CAAA;AAEhG;;;;;GAKG;AACH,qBAAa,cAAc;IAKvB,QAAQ,CAAC,GAAG,EAAE,gBAAgB;IAC9B,6EAA6E;IAC7E,QAAQ,CAAC,SAAS,EAAE,IAAI;IAN1B,OAAO,CAAC,OAAO,CAA+B;IAC9C,OAAO,CAAC,eAAe,CAAsC;gBAGlD,GAAG,EAAE,gBAAgB;IAC9B,6EAA6E;IACpE,SAAS,EAAE,IAAI;IAG1B,sCAAsC;IACtC,IAAI,KAAK,IAAI,cAAc,CAE1B;IAED,IAAI,SAAS,IAAI,wBAAwB,GAAG,SAAS,CAEpD;IAED,iFAAiF;IACjF,IAAI,cAAc,IAAI,SAAS,GAAG,SAAS,CAE1C;IAED;;;;;OAKG;IACH,IAAI,YAAY,IAAI,OAAO,CAE1B;IAED,mFAAmF;IACnF,KAAK,CAAC,KAAK,EAAE,OAAO,CAAC,cAAc,EAAE,SAAS,CAAC,GAAG,IAAI;IAItD,yFAAyF;IACzF,eAAe,CAAC,SAAS,EAAE,wBAAwB,GAAG,IAAI;IAO1D,gEAAgE;IAChE,SAAS,CAAC,UAAU,GAAE,IAAiB,GAAG,wBAAwB;IAIlE,kFAAkF;IAClF,MAAM,CAAC,KAAK,EAAE,gBAAgB,EAAE,UAAU,GAAE,IAAiB,GAAG,qBAAqB;IAIrF,OAAO,CAAC,YAAY;CAgBrB"}

package/dist/actions/run/types.d.ts

@@ -0,0 +1,54 @@
+import type { BlobsRuntime } from "../../blob-storage/execution";
+import type { ConnectorRuntime } from "../../connectors/execution";
+import type { LoggingService } from "../../logging/service";
+import type { ModelsRuntime } from "../../models/generation-types";
+import type { ObjectsRuntime } from "../../objects/execution";
+import type { SixbDefinitions } from "../../runtime/definitions";
+import type { OntologyMutationRuntime } from "../../runtime/ontology-mutations";
+import type { ActionRunRecord, ActionRunStorage, Storage } from "../../storage";
+import type { ActionsRuntime } from "../execution";
+import type { ActionRunSignals } from "./signals";
+/** Execution-bound primitives exposed to Action phase handlers. */
+export interface ActionExecutionFacade {
+    readonly models: ModelsRuntime;
+    readonly objects: ObjectsRuntime;
+    readonly actions: ActionsRuntime;
+    readonly connector: ConnectorRuntime;
+    readonly blobs: BlobsRuntime;
+}
+export interface ActionRunContext {
+    readonly id: string;
+    readonly errorReporterHost: object;
+    readonly logging?: LoggingService;
+    readonly storage: Storage;
+    readonly actionRunsStorage: ActionRunStorage;
+    readonly ontologyMutations: OntologyMutationRuntime;
+    readonly sixb: ActionExecutionFacade;
+    readonly actions: Pick<SixbDefinitions["actions"], "getById">;
+}
+/**
+ * A requested run that has not ended: the request it executes, under the durable execution created
+ * for it. Nothing else about it is stored until its terminal record is written.
+ */
+export type PendingActionRun = Pick<ActionRunRecord, "id" | "projectId" | "executionId" | "actionId" | "subject" | "params" | "idempotencyKey">;
+export interface RunActionInput {
+    readonly runtime: ActionRunContext;
+    readonly run: PendingActionRun;
+    readonly signals: ActionRunSignals;
+}
+/** How a request's run ended. */
+export interface ActionRunOutcome {
+    readonly record: ActionRunRecord;
+    /**
+     * Whether this request wrote the record. When it did not, a concurrent request for the same run
+     * id recorded the run first, and the record is that request's, whatever it asked for.
+     */
+    readonly recorded: boolean;
+    /**
+     * Runs the run's effects and records their outcome. The request starts it once it returns the
+     * record, and does not wait for it. An effects failure does not reject it: it is recorded on the
+     * run.
+     */
+    readonly effects?: () => Promise<void>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/actions/run/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/actions/run/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAA;AAChE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAA;AAClE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAA;AAC3D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAA;AAClE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAA;AAC7D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAA;AAChE,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,kCAAkC,CAAA;AAC/E,OAAO,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,eAAe,CAAA;AAC/E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA;AAClD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAA;AAEjD,mEAAmE;AACnE,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAA;IAC9B,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAA;IAChC,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAA;IAChC,QAAQ,CAAC,SAAS,EAAE,gBAAgB,CAAA;IACpC,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAA;CAC7B;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAA;IAClC,QAAQ,CAAC,OAAO,CAAC,EAAE,cAAc,CAAA;IACjC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;IACzB,QAAQ,CAAC,iBAAiB,EAAE,gBAAgB,CAAA;IAC5C,QAAQ,CAAC,iBAAiB,EAAE,uBAAuB,CAAA;IACnD,QAAQ,CAAC,IAAI,EAAE,qBAAqB,CAAA;IACpC,QAAQ,CAAC,OAAO,EAAE,IAAI,CAAC,eAAe,CAAC,SAAS,CAAC,EAAE,SAAS,CAAC,CAAA;CAC9D;AAED;;;GAGG;AACH,MAAM,MAAM,gBAAgB,GAAG,IAAI,CACjC,eAAe,EACf,IAAI,GAAG,WAAW,GAAG,aAAa,GAAG,UAAU,GAAG,SAAS,GAAG,QAAQ,GAAG,gBAAgB,CAC1F,CAAA;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,OAAO,EAAE,gBAAgB,CAAA;IAClC,QAAQ,CAAC,GAAG,EAAE,gBAAgB,CAAA;IAC9B,QAAQ,CAAC,OAAO,EAAE,gBAAgB,CAAA;CACnC;AAED,iCAAiC;AACjC,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,MAAM,EAAE,eAAe,CAAA;IAChC;;;OAGG;IACH,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAA;IAC1B;;;;OAIG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;CACvC"}

package/dist/actions/run/writeback.d.ts

@@ -0,0 +1,17 @@
+import type { ActionReadRecorder } from "../read-facade";
+import { type BasePhaseContext } from "./context";
+import type { LoadedObjectTarget, PhaseExecutionBase } from "./phase-types";
+import type { ActionRunState } from "./state";
+/**
+ * Calls the Action's writeback, when it has one, and keeps how it ended on the run's state.
+ *
+ * A failed writeback fails the run with the writeback's own failure; a succeeded one is the run's
+ * irreversible boundary.
+ */
+export declare function runWritebackPhase(input: PhaseExecutionBase & {
+    readonly state: ActionRunState;
+    readonly baseContext: BasePhaseContext;
+    readonly objectTarget: LoadedObjectTarget | null;
+    readonly reads: ActionReadRecorder;
+}): Promise<void>;
+//# sourceMappingURL=writeback.d.ts.map

package/dist/actions/run/writeback.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"writeback.d.ts","sourceRoot":"","sources":["../../../src/actions/run/writeback.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAA;AAExD,OAAO,EACL,KAAK,gBAAgB,EAItB,MAAM,WAAW,CAAA;AAElB,OAAO,KAAK,EAAE,kBAAkB,EAAE,kBAAkB,EAAuB,MAAM,eAAe,CAAA;AAChG,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAA;AAE7C;;;;;GAKG;AACH,wBAAsB,iBAAiB,CACrC,KAAK,EAAE,kBAAkB,GAAG;IAC1B,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAA;IAC9B,QAAQ,CAAC,WAAW,EAAE,gBAAgB,CAAA;IACtC,QAAQ,CAAC,YAAY,EAAE,kBAAkB,GAAG,IAAI,CAAA;IAChD,QAAQ,CAAC,KAAK,EAAE,kBAAkB,CAAA;CACnC,GACA,OAAO,CAAC,IAAI,CAAC,CA0Cf"}

package/dist/actions/run-authorization.d.ts

@@ -14,7 +14,7 @@ export declare function canDelegationAccessActionRun(input: {
 export declare function actionRunBelongsToShareGrant(input: {
     readonly storage: Storage;
     readonly projectId: string;
-    readonly run: ActionRunRecord;
+    readonly run: Pick<ActionRunRecord, "id" | "actionId" | "executionId">;
     readonly grantId: string;
 }): Promise<boolean>;
 //# sourceMappingURL=run-authorization.d.ts.map

package/dist/actions/run-authorization.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"run-authorization.d.ts","sourceRoot":"","sources":["../../src/actions/run-authorization.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,4BAA4B,CAAA;AAC9E,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAA;AACzC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAA;AAG7D,kGAAkG;AAClG,wBAAsB,4BAA4B,CAAC,KAAK,EAAE;IACxD,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC,4BAA4B,EAAE;QAAE,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAA;KAAE,CAAC,CAAA;IACzF,QAAQ,CAAC,GAAG,EAAE,eAAe,CAAA;CAC9B,GAAG,OAAO,CAAC,OAAO,CAAC,CAoBnB;AAED,gGAAgG;AAChG,wBAAsB,4BAA4B,CAAC,KAAK,EAAE;IACxD,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,GAAG,EAAE,eAAe,CAAA;IAC7B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CACzB,GAAG,OAAO,CAAC,OAAO,CAAC,CAanB"}
+{"version":3,"file":"run-authorization.d.ts","sourceRoot":"","sources":["../../src/actions/run-authorization.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,4BAA4B,CAAA;AAC9E,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAA;AACzC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAA;AAG7D,kGAAkG;AAClG,wBAAsB,4BAA4B,CAAC,KAAK,EAAE;IACxD,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC,4BAA4B,EAAE;QAAE,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAA;KAAE,CAAC,CAAA;IACzF,QAAQ,CAAC,GAAG,EAAE,eAAe,CAAA;CAC9B,GAAG,OAAO,CAAC,OAAO,CAAC,CAoBnB;AAED,gGAAgG;AAChG,wBAAsB,4BAA4B,CAAC,KAAK,EAAE;IACxD,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,GAAG,EAAE,IAAI,CAAC,eAAe,EAAE,IAAI,GAAG,UAAU,GAAG,aAAa,CAAC,CAAA;IACtE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CACzB,GAAG,OAAO,CAAC,OAAO,CAAC,CAanB"}

package/dist/actions/run-persistence.d.ts

@@ -0,0 +1,53 @@
+import type { ActionRunParams, ActionRunRecord, CreateExecutionInput, Storage } from "../storage";
+import type { ExecutionRecord } from "../storage/executions";
+import type { PendingActionRun } from "./run/types";
+import type { ActionSubject } from "./types";
+/** What a request asks its run id to run. */
+export interface ActionRunRequestPayload {
+    readonly actionId: string;
+    readonly subject: ActionSubject;
+    readonly params: ActionRunParams;
+}
+/** A run that already exists under a requested run id, recorded or still executing. */
+export type ExistingActionRun = Pick<ActionRunRecord, "id" | "executionId" | "actionId" | "subject" | "params">;
+/** Refuses an existing run the requesting caller may not have. */
+export type AssertCanReuseActionRun = (run: ExistingActionRun) => void | Promise<void>;
+/**
+ * Answer a request with the run that already exists under its run id only when its caller may have
+ * that run, and only for the same request.
+ *
+ * The caller's right to the run is checked first, so that a refused caller learns nothing about it,
+ * not even whether it carries the same request.
+ */
+export declare function assertCanReuseActionRun(run: ExistingActionRun, request: {
+    readonly payload: ActionRunRequestPayload;
+    readonly assertCanReuse: AssertCanReuseActionRun;
+}): Promise<void>;
+interface PersistActionRunInput {
+    readonly projectId: string;
+    readonly storage: Storage;
+    readonly runId: string;
+    readonly payload: ActionRunRequestPayload;
+    readonly createExecution: (executionId: string, runId: string) => Promise<CreateExecutionInput>;
+    readonly assertCanReuse: AssertCanReuseActionRun;
+    /** Checks that hold only for a run this call creates; a replayed run keeps its accepted params. */
+    readonly assertNewRun?: () => Promise<void>;
+}
+/** A run this request is to execute, or the record of an earlier request with the same run id. */
+export type PersistedActionRun = {
+    readonly kind: "new";
+    readonly run: PendingActionRun;
+    readonly execution: ExecutionRecord;
+} | {
+    readonly kind: "recorded";
+    readonly run: ActionRunRecord;
+};
+/**
+ * Persist what a requested run needs before it executes: the durable execution it runs under.
+ *
+ * Nothing else is stored before the run ends. A run id that is already recorded must carry the same
+ * request, and its record answers this request without running anything.
+ */
+export declare function persistActionRun(input: PersistActionRunInput): Promise<PersistedActionRun>;
+export {};
+//# sourceMappingURL=run-persistence.d.ts.map

package/dist/actions/run-persistence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-persistence.d.ts","sourceRoot":"","sources":["../../src/actions/run-persistence.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,eAAe,EAAE,oBAAoB,EAAE,OAAO,EAAE,MAAM,YAAY,CAAA;AAGjG,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAA;AAC5D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AAEnD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAA;AAE5C,6CAA6C;AAC7C,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAA;IAC/B,QAAQ,CAAC,MAAM,EAAE,eAAe,CAAA;CACjC;AAED,uFAAuF;AACvF,MAAM,MAAM,iBAAiB,GAAG,IAAI,CAClC,eAAe,EACf,IAAI,GAAG,aAAa,GAAG,UAAU,GAAG,SAAS,GAAG,QAAQ,CACzD,CAAA;AAED,kEAAkE;AAClE,MAAM,MAAM,uBAAuB,GAAG,CAAC,GAAG,EAAE,iBAAiB,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;AAEtF;;;;;;GAMG;AACH,wBAAsB,uBAAuB,CAC3C,GAAG,EAAE,iBAAiB,EACtB,OAAO,EAAE;IACP,QAAQ,CAAC,OAAO,EAAE,uBAAuB,CAAA;IACzC,QAAQ,CAAC,cAAc,EAAE,uBAAuB,CAAA;CACjD,GACA,OAAO,CAAC,IAAI,CAAC,CAOf;AAED,UAAU,qBAAqB;IAC7B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;IACzB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,OAAO,EAAE,uBAAuB,CAAA;IACzC,QAAQ,CAAC,eAAe,EAAE,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,oBAAoB,CAAC,CAAA;IAC/F,QAAQ,CAAC,cAAc,EAAE,uBAAuB,CAAA;IAChD,mGAAmG;IACnG,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;CAC5C;AAED,kGAAkG;AAClG,MAAM,MAAM,kBAAkB,GAC1B;IACE,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAA;IACpB,QAAQ,CAAC,GAAG,EAAE,gBAAgB,CAAA;IAC9B,QAAQ,CAAC,SAAS,EAAE,eAAe,CAAA;CACpC,GACD;IAAE,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAAC,QAAQ,CAAC,GAAG,EAAE,eAAe,CAAA;CAAE,CAAA;AAEhE;;;;;GAKG;AACH,wBAAsB,gBAAgB,CAAC,KAAK,EAAE,qBAAqB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CA+BhG"}

package/dist/actions/types/context.d.ts

@@ -51,6 +51,10 @@ export type ActionBinding<TObjectType extends ObjectType = ObjectType> = {
 export interface ActionRunPhaseInfo {
     readonly id: string;
     readonly startedAt: Date;
+    /**
+     * Identifies this run to external systems. Send it as the idempotency key of the external call a
+     * writeback makes, so that call applies once even when it is retried.
+     */
     readonly idempotencyKey: string;
 }
 /** A telemetry-mode ontology property accepted by Action history reads. */
@@ -136,6 +140,12 @@ export interface BaseActionPhaseContext<TParams extends Record<string, unknown>>
     readonly run: ActionRunPhaseInfo;
     readonly params: TParams;
     readonly subject: ActionSubject;
+    /**
+     * Aborts when the caller cancels the run or it runs out of time: a run has 30 seconds until its
+     * writeback succeeds or its edits commit, and its effects have 30 more after the commit. Forward
+     * it to every call the handler awaits. Edits that follow a succeeded writeback always complete, so
+     * their signal never aborts.
+     */
     readonly signal: AbortSignal;
     readonly logger: Logger;
 }

package/dist/actions/types/context.d.ts.map

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