@sixb/core 0.1.17 → 0.1.19

package/README.md

@@ -20,7 +20,7 @@ bun add @sixb/core
 
 **Blob Storage** -- Durable immutable binary objects referenced by dataset `fileRef` values. In-memory core support is included for development and tests; durable providers can be configured separately.
 
-**Events** -- All mutations are emitted to a bounded, retained event stream for live coordination and short replay. The runtime emits object/link mutation events such as `object.created`, `object.updated`, `object.deleted`, `link.created`, `link.updated`, and `link.deleted`, plus topic events like `telemetry.appended` and `action.requested`.
+**Events** -- All mutations are emitted to a bounded, retained event stream for live coordination and short replay. The runtime emits object/link mutation events such as `object.created`, `object.updated`, `object.deleted`, `link.created`, `link.updated`, and `link.deleted`, plus topic events like `telemetry.appended` and `schedule.triggered`.
 
 **Actions** -- Typed audited commands. Actions can run external writeback, declare local object/link edits, and run post-commit effects.
 
@@ -141,7 +141,8 @@ const found = await sixb
 ## Actions
 
 Actions define typed commands that can be requested globally or for an object subject.
-Local object/link mutations are declared in `.edits(...)` and committed by the action worker.
+Local object/link mutations are declared in `.edits(...)` and committed together.
+`sixb.actions.request(...)` runs the action in the calling process and returns its finished run.
 
 ```ts
 const renameRoom = defineAction("renameRoom")
@@ -160,7 +161,7 @@ const renameRoom = defineAction("renameRoom")
     })
   })
 
-await sixb.actions.request({
+const run = await sixb.actions.request({
   actionId: "renameRoom",
   subject: { kind: "object", objectTypeId: "Room", primaryId: "room:101" },
   params: { name: "Boardroom 101" },
@@ -435,7 +436,7 @@ src/
 | `.list({ limit, offset, ... })` | List stored objects with storage-system filtering and pagination |
 | `.byId(id)` | Get a handle for link/telemetry/action operations |
 | `.appendTelemetryBatch(items)` | Batch append telemetry for multiple objects |
-| `.requestAction({ actionId, params })` | Request an action on an object |
+| `.requestAction({ id, actionId, params })` | Run an action on an object and return its finished run |
 
 ### ObjectByIdHandle API (`sixb.objects(Type).byId(id)`)
 
@@ -446,7 +447,7 @@ src/
 | `.unlink(token, target)` | Remove a link |
 | `.listLinks(token?)` | List links from this object |
 | `.telemetry(token)` | Get a telemetry appender for a property |
-| `.requestAction({ actionId, params })` | Request an action |
+| `.requestAction({ actionId, params })` | Run an action and return its finished run |
 
 ### Storage And Queue Interfaces
 
@@ -469,7 +470,7 @@ In-memory implementations included: `InMemoryBroker`, `InMemoryObjectStorage`,
 
 ### Events
 
-Domain events include object/link mutations (`object.created`, `object.updated`, `object.deleted`, `link.created`, `link.updated`, `link.deleted`) and topic events such as `telemetry.appended`, `action.requested`, `schedule.triggered`, `sync.run.finished`, `pipeline.run.finished`, and `dataset.version.committed`.
+Domain events include object/link mutations (`object.created`, `object.updated`, `object.deleted`, `link.created`, `link.updated`, `link.deleted`) and topic events such as `telemetry.appended`, `schedule.triggered`, `sync.run.finished`, `pipeline.run.finished`, and `dataset.version.committed`.
 
 ### Units
 

package/dist/actions/commit-edits.d.ts

@@ -1,7 +1,7 @@
 import type { EditBatch } from "../edits";
 import type { EffectiveLinkChange, EffectiveObjectChange, ExpectedLinkRevision, ExpectedLinkScopeRevision, ExpectedObjectRevision, OntologyOperationOutcome } from "../materializer";
 import type { OntologyMutationRuntime } from "../runtime/ontology-mutations";
-import type { Storage } from "../storage/types";
+import type { RecordActionRunInput } from "../storage";
 /** Exact reads an Action handler depended on, protected by row-level CAS at commit time. */
 export interface ActionReadDependencies {
     readonly objects: readonly ExpectedObjectRevision[];
@@ -10,9 +10,8 @@ export interface ActionReadDependencies {
 }
 export interface CommitActionEditsInput {
     readonly mutations: Pick<OntologyMutationRuntime, "commitEdits">;
-    readonly projectId: string;
-    readonly runId: string;
-    readonly actionId: string;
+    /** The run's terminal record, which the commit inserts with its edits. */
+    readonly run: RecordActionRunInput;
     readonly batch: EditBatch;
     readonly dependencies?: ActionReadDependencies;
 }
@@ -28,25 +27,14 @@ export interface ActionEditCommitResult {
     };
     readonly committedAt: Date;
 }
-export interface FindActionEditCommitInput {
-    readonly storage: Pick<Storage, "ontology">;
-    readonly projectId: string;
-    readonly runId: string;
-}
 /**
  * Commits one Action run's recorded edits as a single atomic ontology commit.
  *
  * The batch lowers to canonical Materializer operations and the Materializer validates the Action run
- * identity, applies managed authority, resolves effective state, writes the authoritative commit, and
- * inserts outbox facts in one transaction. Repeating the call for the same run replays that commit;
- * a divergent request for the same run is a typed idempotency conflict.
+ * identity, applies managed authority, resolves effective state, writes the authoritative commit,
+ * inserts outbox facts, and records the run in one transaction. Repeating the call for the same run
+ * replays that commit without recording anything; a divergent request for the same run is a typed
+ * idempotency conflict.
  */
 export declare function commitActionEdits(input: CommitActionEditsInput): Promise<ActionEditCommitResult>;
-/**
- * Resolves the authoritative commit an Action run already produced, if any.
- *
- * Resume uses the exact `{ actionRunId }` origin instead of rerunning handlers, so a redelivered run
- * returns the persisted result without recomputing an idempotency hash.
- */
-export declare function findActionEditCommit(input: FindActionEditCommitInput): Promise<ActionEditCommitResult | null>;
 //# sourceMappingURL=commit-edits.d.ts.map

package/dist/actions/commit-edits.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"commit-edits.d.ts","sourceRoot":"","sources":["../../src/actions/commit-edits.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,UAAU,CAAA;AAEzC,OAAO,KAAK,EAEV,mBAAmB,EACnB,qBAAqB,EACrB,oBAAoB,EACpB,yBAAyB,EACzB,sBAAsB,EACtB,wBAAwB,EACzB,MAAM,iBAAiB,CAAA;AACxB,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,+BAA+B,CAAA;AAC5E,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAA;AAG/C,4FAA4F;AAC5F,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,OAAO,EAAE,SAAS,sBAAsB,EAAE,CAAA;IACnD,QAAQ,CAAC,KAAK,EAAE,SAAS,oBAAoB,EAAE,CAAA;IAC/C,QAAQ,CAAC,UAAU,EAAE,SAAS,yBAAyB,EAAE,CAAA;CAC1D;AAID,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAC,uBAAuB,EAAE,aAAa,CAAC,CAAA;IAChE,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAA;IACzB,QAAQ,CAAC,YAAY,CAAC,EAAE,sBAAsB,CAAA;CAC/C;AAED,gEAAgE;AAChE,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;IACzB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,QAAQ,EAAE,SAAS,wBAAwB,EAAE,CAAA;IACtD,QAAQ,CAAC,OAAO,EAAE;QAChB,QAAQ,CAAC,OAAO,EAAE,SAAS,qBAAqB,EAAE,CAAA;QAClD,QAAQ,CAAC,KAAK,EAAE,SAAS,mBAAmB,EAAE,CAAA;KAC/C,CAAA;IACD,QAAQ,CAAC,WAAW,EAAE,IAAI,CAAA;CAC3B;AAED,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,UAAU,CAAC,CAAA;IAC3C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CACvB;AAED;;;;;;;GAOG;AACH,wBAAsB,iBAAiB,CACrC,KAAK,EAAE,sBAAsB,GAC5B,OAAO,CAAC,sBAAsB,CAAC,CAWjC;AAED;;;;;GAKG;AACH,wBAAsB,oBAAoB,CACxC,KAAK,EAAE,yBAAyB,GAC/B,OAAO,CAAC,sBAAsB,GAAG,IAAI,CAAC,CAYxC"}
+{"version":3,"file":"commit-edits.d.ts","sourceRoot":"","sources":["../../src/actions/commit-edits.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,UAAU,CAAA;AAEzC,OAAO,KAAK,EAEV,mBAAmB,EACnB,qBAAqB,EACrB,oBAAoB,EACpB,yBAAyB,EACzB,sBAAsB,EACtB,wBAAwB,EACzB,MAAM,iBAAiB,CAAA;AACxB,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,+BAA+B,CAAA;AAC5E,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAA;AAEtD,4FAA4F;AAC5F,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,OAAO,EAAE,SAAS,sBAAsB,EAAE,CAAA;IACnD,QAAQ,CAAC,KAAK,EAAE,SAAS,oBAAoB,EAAE,CAAA;IAC/C,QAAQ,CAAC,UAAU,EAAE,SAAS,yBAAyB,EAAE,CAAA;CAC1D;AAID,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAC,uBAAuB,EAAE,aAAa,CAAC,CAAA;IAChE,0EAA0E;IAC1E,QAAQ,CAAC,GAAG,EAAE,oBAAoB,CAAA;IAClC,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAA;IACzB,QAAQ,CAAC,YAAY,CAAC,EAAE,sBAAsB,CAAA;CAC/C;AAED,gEAAgE;AAChE,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;IACzB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,QAAQ,EAAE,SAAS,wBAAwB,EAAE,CAAA;IACtD,QAAQ,CAAC,OAAO,EAAE;QAChB,QAAQ,CAAC,OAAO,EAAE,SAAS,qBAAqB,EAAE,CAAA;QAClD,QAAQ,CAAC,KAAK,EAAE,SAAS,mBAAmB,EAAE,CAAA;KAC/C,CAAA;IACD,QAAQ,CAAC,WAAW,EAAE,IAAI,CAAA;CAC3B;AAED;;;;;;;;GAQG;AACH,wBAAsB,iBAAiB,CACrC,KAAK,EAAE,sBAAsB,GAC5B,OAAO,CAAC,sBAAsB,CAAC,CAYjC"}

package/dist/actions/errors.d.ts

@@ -1,9 +1,6 @@
 export declare class ActionDefinitionError extends Error {
     readonly name = "ActionDefinitionError";
 }
-export declare class ActionEditCommitError extends Error {
-    readonly name = "ActionEditCommitError";
-}
 export declare function missingActionMutationMessage(actionId: string): string;
 export declare function effectsWithoutEditsMessage(actionId: string): string;
 //# sourceMappingURL=errors.d.ts.map

package/dist/actions/errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/actions/errors.ts"],"names":[],"mappings":"AAAA,qBAAa,qBAAsB,SAAQ,KAAK;IAC9C,QAAQ,CAAC,IAAI,2BAA0B;CACxC;AAED,qBAAa,qBAAsB,SAAQ,KAAK;IAC9C,QAAQ,CAAC,IAAI,2BAA0B;CACxC;AAED,wBAAgB,4BAA4B,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAErE;AAED,wBAAgB,0BAA0B,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEnE"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/actions/errors.ts"],"names":[],"mappings":"AAAA,qBAAa,qBAAsB,SAAQ,KAAK;IAC9C,QAAQ,CAAC,IAAI,2BAA0B;CACxC;AAED,wBAAgB,4BAA4B,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAErE;AAED,wBAAgB,0BAA0B,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEnE"}

package/dist/actions/execution.d.ts

@@ -3,7 +3,7 @@ import type { ObjectType } from "../ontology";
 import type { SixbRuntimeContext } from "../runtime/types";
 import type { ActionRunRecord, ListActionRunsInput, ListActionRunsResult } from "../storage/action-runs";
 import { type ActionDescriptor } from "./descriptor";
-import { type RequestActionAndWaitInput, type RequestActionInput, type RequestActionResult } from "./request";
+import { type RequestActionInput } from "./request";
 export interface ActionRunsRuntime {
     getById(runId: string): Promise<ActionRunRecord | null>;
     list(input?: Omit<ListActionRunsInput, "projectId" | "actionIds" | "objectTypeIds">): Promise<ListActionRunsResult>;
@@ -13,8 +13,15 @@ export interface ActionsRuntime {
     getById(actionId: string): ActionDescriptor | null;
     listGlobal(): readonly ActionDescriptor[];
     listForType(objectType: ObjectType): readonly ActionDescriptor[];
-    request(input: RequestActionInput): Promise<RequestActionResult>;
-    requestAndWait(input: RequestActionAndWaitInput): Promise<ActionRunRecord>;
+    /**
+     * Run an Action in this process and return its terminal record, without waiting for its effects.
+     * A run that fails resolves with status `failed`. The call rejects when the request itself is
+     * refused (unknown action, invalid params, missing authority, a run id this process is still
+     * running, a stopping runtime), and with `internal.unexpected` when a run that started could not
+     * be recorded: requesting it again with the same run id returns its record if it was recorded, and
+     * runs it again otherwise.
+     */
+    request(input: RequestActionInput): Promise<ActionRunRecord>;
     readonly runs: ActionRunsRuntime;
 }
 export declare function createActionsRuntime(runtime: SixbRuntimeContext, execution: ExecutionContext): ActionsRuntime;

package/dist/actions/execution.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"execution.d.ts","sourceRoot":"","sources":["../../src/actions/execution.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAA;AAMpD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAC7C,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAA;AAC1D,OAAO,KAAK,EACV,eAAe,EACf,mBAAmB,EACnB,oBAAoB,EACrB,MAAM,wBAAwB,CAAA;AAE/B,OAAO,EAAE,KAAK,gBAAgB,EAA4B,MAAM,cAAc,CAAA;AAC9E,OAAO,EACL,KAAK,yBAAyB,EAC9B,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,EAGzB,MAAM,WAAW,CAAA;AAIlB,MAAM,WAAW,iBAAiB;IAChC,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAAA;IACvD,IAAI,CACF,KAAK,CAAC,EAAE,IAAI,CAAC,mBAAmB,EAAE,WAAW,GAAG,WAAW,GAAG,eAAe,CAAC,GAC7E,OAAO,CAAC,oBAAoB,CAAC,CAAA;CACjC;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,IAAI,SAAS,gBAAgB,EAAE,CAAA;IACnC,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,gBAAgB,GAAG,IAAI,CAAA;IAClD,UAAU,IAAI,SAAS,gBAAgB,EAAE,CAAA;IACzC,WAAW,CAAC,UAAU,EAAE,UAAU,GAAG,SAAS,gBAAgB,EAAE,CAAA;IAChE,OAAO,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAA;IAChE,cAAc,CAAC,KAAK,EAAE,yBAAyB,GAAG,OAAO,CAAC,eAAe,CAAC,CAAA;IAC1E,QAAQ,CAAC,IAAI,EAAE,iBAAiB,CAAA;CACjC;AAED,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,kBAAkB,EAC3B,SAAS,EAAE,gBAAgB,GAC1B,cAAc,CA+GhB"}
+{"version":3,"file":"execution.d.ts","sourceRoot":"","sources":["../../src/actions/execution.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAA;AAMpD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAC7C,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAA;AAC1D,OAAO,KAAK,EACV,eAAe,EACf,mBAAmB,EACnB,oBAAoB,EACrB,MAAM,wBAAwB,CAAA;AAE/B,OAAO,EAAE,KAAK,gBAAgB,EAA4B,MAAM,cAAc,CAAA;AAC9E,OAAO,EAAE,KAAK,kBAAkB,EAAiB,MAAM,WAAW,CAAA;AAIlE,MAAM,WAAW,iBAAiB;IAChC,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAAA;IACvD,IAAI,CACF,KAAK,CAAC,EAAE,IAAI,CAAC,mBAAmB,EAAE,WAAW,GAAG,WAAW,GAAG,eAAe,CAAC,GAC7E,OAAO,CAAC,oBAAoB,CAAC,CAAA;CACjC;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,IAAI,SAAS,gBAAgB,EAAE,CAAA;IACnC,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,gBAAgB,GAAG,IAAI,CAAA;IAClD,UAAU,IAAI,SAAS,gBAAgB,EAAE,CAAA;IACzC,WAAW,CAAC,UAAU,EAAE,UAAU,GAAG,SAAS,gBAAgB,EAAE,CAAA;IAChE;;;;;;;OAOG;IACH,OAAO,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,eAAe,CAAC,CAAA;IAC5D,QAAQ,CAAC,IAAI,EAAE,iBAAiB,CAAA;CACjC;AAED,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,kBAAkB,EAC3B,SAAS,EAAE,gBAAgB,GAC1B,cAAc,CA8GhB"}

package/dist/actions/index.d.ts

@@ -1,14 +1,11 @@
 export { defineAction, optional, param } from "./builders";
-export type { ActionEditCommitResult, ActionReadDependencies, CommitActionEditsInput, FindActionEditCommitInput, } from "./commit-edits";
-export { commitActionEdits, findActionEditCommit } from "./commit-edits";
-export { ActionDefinitionError, ActionEditCommitError } from "./errors";
-export type { ActionReadFacadeOptions, ActionTelemetryReadSource, } from "./read-facade";
-export { ActionReadRecorder, createActionReadFacade } from "./read-facade";
+export { ActionDefinitionError } from "./errors";
 export type { ActionDefinitionCatalog, ActionRegistryOptions } from "./registry";
 export { ActionRegistry } from "./registry";
-export type { RequestActionAndWaitInput, RequestActionAndWaitOptions, RequestActionInput, RequestActionOptions, RequestActionResult, WaitForActionRunInput, } from "./request";
-export { requestAction, requestActionAndWait, waitForActionRun } from "./request";
+export type { RequestActionInput, RequestActionOptions } from "./request";
+export { requestAction } from "./request";
+export { drainActionRuns } from "./run/executor";
+export { ACTION_RUN_DRAIN_TIMEOUT_MS } from "./run/signals";
 export type { ActionBinding, ActionBlobContext, ActionBuilder, ActionDefinition, ActionEditsContext, ActionEditsHandler, ActionEffectsContext, ActionEffectsHandler, ActionObjectSubject, ActionParamConfig, ActionParamsConfig, ActionPhaseCommit, ActionReadFacade, ActionRunPhaseInfo, ActionRuntimeFacade, ActionSubject, ActionTargetObject, ActionTelemetryHistoryBatchInput, ActionTelemetryHistoryBatchResult, ActionTelemetryHistorySeriesInput, ActionTelemetryObjectSet, ActionTelemetryPropertyToken, ActionTelemetryReadFacade, ActionValidationContext, ActionValidator, ActionWritebackContext, ActionWritebackHandler, ActionWritebackValue, GlobalActionAfterEditsBuilder, GlobalActionAfterWritebackBuilder, GlobalActionDefinition, GlobalActionEditsContext, GlobalActionEditsHandler, GlobalActionEffectsContext, GlobalActionEffectsHandler, GlobalActionParamsBuilder, GlobalActionPhaseBuilder, GlobalActionValidationContext, GlobalActionValidator, GlobalActionWritebackContext, GlobalActionWritebackHandler, InferActionParams, ObjectActionAfterEditsBuilder, ObjectActionAfterWritebackBuilder, ObjectActionDefinition, ObjectActionParamsBuilder, ObjectActionPhaseBuilder, } from "./types";
-export { coerceActionParamsToTyped, isActionDefinition, isGlobalActionDefinition, isObjectActionDefinition, } from "./validation";
-export { runActionValidators } from "./validators";
+export { isActionDefinition, isGlobalActionDefinition, isObjectActionDefinition, } from "./validation";
 //# sourceMappingURL=index.d.ts.map

package/dist/actions/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/actions/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,YAAY,CAAA;AAC1D,YAAY,EACV,sBAAsB,EACtB,sBAAsB,EACtB,sBAAsB,EACtB,yBAAyB,GAC1B,MAAM,gBAAgB,CAAA;AACvB,OAAO,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAA;AACxE,OAAO,EAAE,qBAAqB,EAAE,qBAAqB,EAAE,MAAM,UAAU,CAAA;AACvE,YAAY,EACV,uBAAuB,EACvB,yBAAyB,GAC1B,MAAM,eAAe,CAAA;AACtB,OAAO,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAA;AAC1E,YAAY,EAAE,uBAAuB,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAA;AAChF,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAC3C,YAAY,EACV,yBAAyB,EACzB,2BAA2B,EAC3B,kBAAkB,EAClB,oBAAoB,EACpB,mBAAmB,EACnB,qBAAqB,GACtB,MAAM,WAAW,CAAA;AAClB,OAAO,EAAE,aAAa,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAA;AACjF,YAAY,EACV,aAAa,EACb,iBAAiB,EACjB,aAAa,EACb,gBAAgB,EAChB,kBAAkB,EAClB,kBAAkB,EAClB,oBAAoB,EACpB,oBAAoB,EACpB,mBAAmB,EACnB,iBAAiB,EACjB,kBAAkB,EAClB,iBAAiB,EACjB,gBAAgB,EAChB,kBAAkB,EAClB,mBAAmB,EACnB,aAAa,EACb,kBAAkB,EAClB,gCAAgC,EAChC,iCAAiC,EACjC,iCAAiC,EACjC,wBAAwB,EACxB,4BAA4B,EAC5B,yBAAyB,EACzB,uBAAuB,EACvB,eAAe,EACf,sBAAsB,EACtB,sBAAsB,EACtB,oBAAoB,EACpB,6BAA6B,EAC7B,iCAAiC,EACjC,sBAAsB,EACtB,wBAAwB,EACxB,wBAAwB,EACxB,0BAA0B,EAC1B,0BAA0B,EAC1B,yBAAyB,EACzB,wBAAwB,EACxB,6BAA6B,EAC7B,qBAAqB,EACrB,4BAA4B,EAC5B,4BAA4B,EAC5B,iBAAiB,EACjB,6BAA6B,EAC7B,iCAAiC,EACjC,sBAAsB,EACtB,yBAAyB,EACzB,wBAAwB,GACzB,MAAM,SAAS,CAAA;AAChB,OAAO,EACL,yBAAyB,EACzB,kBAAkB,EAClB,wBAAwB,EACxB,wBAAwB,GACzB,MAAM,cAAc,CAAA;AACrB,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/actions/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,YAAY,CAAA;AAC1D,OAAO,EAAE,qBAAqB,EAAE,MAAM,UAAU,CAAA;AAChD,YAAY,EAAE,uBAAuB,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAA;AAChF,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAC3C,YAAY,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAA;AACzE,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAA;AACzC,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAA;AAChD,OAAO,EAAE,2BAA2B,EAAE,MAAM,eAAe,CAAA;AAC3D,YAAY,EACV,aAAa,EACb,iBAAiB,EACjB,aAAa,EACb,gBAAgB,EAChB,kBAAkB,EAClB,kBAAkB,EAClB,oBAAoB,EACpB,oBAAoB,EACpB,mBAAmB,EACnB,iBAAiB,EACjB,kBAAkB,EAClB,iBAAiB,EACjB,gBAAgB,EAChB,kBAAkB,EAClB,mBAAmB,EACnB,aAAa,EACb,kBAAkB,EAClB,gCAAgC,EAChC,iCAAiC,EACjC,iCAAiC,EACjC,wBAAwB,EACxB,4BAA4B,EAC5B,yBAAyB,EACzB,uBAAuB,EACvB,eAAe,EACf,sBAAsB,EACtB,sBAAsB,EACtB,oBAAoB,EACpB,6BAA6B,EAC7B,iCAAiC,EACjC,sBAAsB,EACtB,wBAAwB,EACxB,wBAAwB,EACxB,0BAA0B,EAC1B,0BAA0B,EAC1B,yBAAyB,EACzB,wBAAwB,EACxB,6BAA6B,EAC7B,qBAAqB,EACrB,4BAA4B,EAC5B,4BAA4B,EAC5B,iBAAiB,EACjB,6BAA6B,EAC7B,iCAAiC,EACjC,sBAAsB,EACtB,yBAAyB,EACzB,wBAAwB,GACzB,MAAM,SAAS,CAAA;AAChB,OAAO,EACL,kBAAkB,EAClB,wBAAwB,EACxB,wBAAwB,GACzB,MAAM,cAAc,CAAA"}

package/dist/actions/index.js

@@ -3,85 +3,89 @@ import {
   defineAction2,
   param2,
   optional2,
-  commitActionEdits2,
-  findActionEditCommit2,
-  ActionReadRecorder2,
-  createActionReadFacade2,
   ActionRegistry2,
-  runActionValidators2
-} from "../chunk-9g6jz9kk.js";
-import {
-  requestAction3,
-  requestActionAndWait2,
-  waitForActionRun2
-} from "../chunk-10styjgk.js";
-import"../chunk-fggq3d9k.js";
-import"../chunk-a7er86jd.js";
-import"../chunk-pja9jfz6.js";
-import"../chunk-5yd8cchh.js";
-import"../chunk-4wn7bxxa.js";
+  ACTION_RUN_DRAIN_TIMEOUT_MS2,
+  drainActionRuns2,
+  requestAction3
+} from "../chunk-ey3pyej1.js";
+import"../chunk-t6vq7bff.js";
+import"../chunk-wz0xs816.js";
+import"../chunk-52bk93x8.js";
+import"../chunk-wwdfe68s.js";
+import"../chunk-zrmy8zvw.js";
+import"../chunk-mfs23znk.js";
+import"../chunk-7mbzgd9m.js";
+import"../chunk-99nd4rc1.js";
+import"../chunk-vyf9kfqf.js";
+import"../chunk-4tcx876c.js";
+import"../chunk-d2ync1v3.js";
+import"../chunk-nre82s12.js";
+import"../chunk-j2bp5ryw.js";
 import"../chunk-br3k6qbf.js";
 import"../chunk-jmfet9r4.js";
 import"../chunk-qf954wje.js";
-import"../chunk-t9shqx3w.js";
+import"../chunk-1f7wpmyp.js";
 import"../chunk-tw03bsmb.js";
-import"../chunk-33saed7g.js";
-import"../chunk-aq39q04r.js";
-import"../chunk-hn2r7z41.js";
+import"../chunk-7kg3k1m9.js";
+import"../chunk-s16apyk9.js";
 import"../chunk-h89wz928.js";
-import"../chunk-wt4szfec.js";
+import"../chunk-pbcbn83d.js";
 import"../chunk-qczk96d9.js";
 import"../chunk-mmagke4x.js";
-import"../chunk-y2aq6ag9.js";
-import"../chunk-fc5zfxy1.js";
-import"../chunk-69266efg.js";
+import"../chunk-9ybhtmg4.js";
+import"../chunk-hn2r7z41.js";
+import"../chunk-b38szspf.js";
+import"../chunk-a40ad1ft.js";
+import"../chunk-s54c868q.js";
 import"../chunk-ere85b8y.js";
 import"../chunk-rj69qcrd.js";
 import"../chunk-4as3wt1c.js";
-import"../chunk-b9affek3.js";
-import"../chunk-s7ftxrdr.js";
+import"../chunk-29yx306f.js";
 import"../chunk-pqajwytd.js";
-import"../chunk-xyvy73tj.js";
-import"../chunk-wr8qp979.js";
-import"../chunk-vjcd8d27.js";
-import"../chunk-kkqwzy6h.js";
-import"../chunk-9se093qz.js";
+import"../chunk-bpgy64fw.js";
+import"../chunk-3qms4nax.js";
+import"../chunk-7n440zgt.js";
+import"../chunk-m427qgq0.js";
+import"../chunk-fa02jy15.js";
+import"../chunk-7t429e3f.js";
+import"../chunk-3zxk45er.js";
+import"../chunk-5a4a52tq.js";
+import"../chunk-6gmfggss.js";
+import"../chunk-bwjcehza.js";
+import"../chunk-rz53yb4v.js";
+import"../chunk-gc4ntf7d.js";
 import"../chunk-gfdh9kqa.js";
+import"../chunk-pfp1txq2.js";
+import"../chunk-5e43w60z.js";
 import {
   ActionDefinitionError2,
-  ActionEditCommitError2,
   isActionDefinition2,
   isGlobalActionDefinition2,
-  isObjectActionDefinition2,
-  coerceActionParamsToTyped2
-} from "../chunk-svabwqdq.js";
-import"../chunk-5thzcb8g.js";
-import"../chunk-rx7h5fdx.js";
-import"../chunk-5be2ath4.js";
+  isObjectActionDefinition2
+} from "../chunk-3gnrh4ve.js";
+import"../chunk-c85m1hyj.js";
+import"../chunk-v9xd5wzd.js";
+import"../chunk-xt1zt7gv.js";
+import"../chunk-2jntasmh.js";
+import"../chunk-y7rqfrgg.js";
 import"../chunk-v4jbb3rs.js";
-import"../chunk-rpxz486p.js";
-import"../chunk-6fsr7y93.js";
+import"../chunk-hvsb78a1.js";
+import"../chunk-enpsx8k5.js";
+import"../chunk-jhm3zsa7.js";
+import"../chunk-8mx7qw3y.js";
 import"../chunk-z3y5kg1x.js";
-import"../chunk-2jntasmh.js";
 export {
+  ACTION_RUN_DRAIN_TIMEOUT_MS2 as ACTION_RUN_DRAIN_TIMEOUT_MS,
   ActionDefinitionError2 as ActionDefinitionError,
-  ActionEditCommitError2 as ActionEditCommitError,
-  ActionReadRecorder2 as ActionReadRecorder,
   ActionRegistry2 as ActionRegistry,
-  coerceActionParamsToTyped2 as coerceActionParamsToTyped,
-  commitActionEdits2 as commitActionEdits,
-  createActionReadFacade2 as createActionReadFacade,
   defineAction2 as defineAction,
-  findActionEditCommit2 as findActionEditCommit,
+  drainActionRuns2 as drainActionRuns,
   isActionDefinition2 as isActionDefinition,
   isGlobalActionDefinition2 as isGlobalActionDefinition,
   isObjectActionDefinition2 as isObjectActionDefinition,
   optional2 as optional,
   param2 as param,
-  requestAction3 as requestAction,
-  requestActionAndWait2 as requestActionAndWait,
-  runActionValidators2 as runActionValidators,
-  waitForActionRun2 as waitForActionRun
+  requestAction3 as requestAction
 };
 
-//# debugId=345D72814BC60A2D64756E2164756E21
+//# debugId=65F1AC6613EA058064756E2164756E21

package/dist/actions/index.js.map

@@ -4,6 +4,6 @@
   "sourcesContent": [
   ],
   "mappings": "",
-  "debugId": "345D72814BC60A2D64756E2164756E21",
+  "debugId": "65F1AC6613EA058064756E2164756E21",
   "names": []
 }

package/dist/actions/read-facade.d.ts

@@ -17,7 +17,7 @@ export interface ActionTelemetryReadSource {
  * reflect the handler's own intent. Objects returned by `list()` and `query()` are fenced like
  * concrete reads, but query membership is not yet: an object that starts matching a query after the
  * read, and aggregate results (`count()`, `exists()`, `facets()`), stay unfenced. Telemetry history
- * is also a call-level snapshot, not an edit dependency.
+ * and file content are also call-level snapshots, not edit dependencies.
  */
 export declare class ActionReadRecorder {
     private readonly objects;

package/dist/actions/request.d.ts

@@ -1,38 +1,27 @@
 import type { ExecutionContext } from "../execution/types";
 import type { SixbRuntimeContext } from "../runtime/types";
-import { type ActionRunRecord } from "../storage";
+import type { ActionRunRecord } from "../storage";
 import type { ActionSubject } from "./types";
-export interface RequestActionResult {
-    readonly runId: string;
-    readonly queuedAt: string;
-    readonly jobId?: string;
-    readonly created: boolean;
-}
 export interface RequestActionOptions {
     readonly runId?: string;
+    /**
+     * Cancels the run before its irreversible boundary: a succeeded writeback, or the commit of an
+     * Action without one. Past it, the run finishes whatever this signal does.
+     */
     readonly signal?: AbortSignal;
 }
-export interface RequestActionAndWaitOptions extends RequestActionOptions {
-    readonly timeoutMs?: number;
-    readonly onRequested?: (runId: string) => void | Promise<void>;
-}
-export interface RequestActionInput {
+export interface RequestActionInput extends RequestActionOptions {
     readonly actionId: string;
     readonly subject?: ActionSubject;
     readonly params?: Record<string, unknown>;
-    readonly runId?: string;
-    readonly signal?: AbortSignal;
-}
-export interface RequestActionAndWaitInput extends RequestActionInput {
-    readonly timeoutMs?: number;
+    /** Called once the run's execution exists, before the run executes. A throw starts nothing. */
     readonly onRequested?: (runId: string) => void | Promise<void>;
 }
-export interface WaitForActionRunInput {
-    readonly runId: string;
-    readonly timeoutMs?: number;
-    readonly signal?: AbortSignal;
-}
-export declare function requestAction(runtime: SixbRuntimeContext, execution: ExecutionContext, input: RequestActionInput): Promise<RequestActionResult>;
-export declare function requestActionAndWait(runtime: SixbRuntimeContext, execution: ExecutionContext, input: RequestActionAndWaitInput): Promise<ActionRunRecord>;
-export declare function waitForActionRun(runtime: SixbRuntimeContext, input: WaitForActionRunInput): Promise<ActionRunRecord>;
+/**
+ * Request an Action run and execute it in this process, returning its terminal record.
+ *
+ * Admission, authorization and params are checked before anything is persisted. A run id that is
+ * already recorded returns that run's record, without running it again.
+ */
+export declare function requestAction(runtime: SixbRuntimeContext, execution: ExecutionContext, input: RequestActionInput): Promise<ActionRunRecord>;
 //# sourceMappingURL=request.d.ts.map

package/dist/actions/request.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"request.d.ts","sourceRoot":"","sources":["../../src/actions/request.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAA;AAI1D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAA;AAE1D,OAAO,EAEL,KAAK,eAAe,EAGrB,MAAM,YAAY,CAAA;AAMnB,OAAO,KAAK,EAAoB,aAAa,EAAE,MAAM,SAAS,CAAA;AAQ9D,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;CAC1B;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAA;CAC9B;AAED,MAAM,WAAW,2BAA4B,SAAQ,oBAAoB;IACvE,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CAC/D;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,OAAO,CAAC,EAAE,aAAa,CAAA;IAChC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACzC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAA;CAC9B;AAED,MAAM,WAAW,yBAA0B,SAAQ,kBAAkB;IACnE,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CAC/D;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAA;CAC9B;AAmBD,wBAAsB,aAAa,CACjC,OAAO,EAAE,kBAAkB,EAC3B,SAAS,EAAE,gBAAgB,EAC3B,KAAK,EAAE,kBAAkB,GACxB,OAAO,CAAC,mBAAmB,CAAC,CAuH9B;AAoBD,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,kBAAkB,EAC3B,SAAS,EAAE,gBAAgB,EAC3B,KAAK,EAAE,yBAAyB,GAC/B,OAAO,CAAC,eAAe,CAAC,CAc1B;AAED,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,kBAAkB,EAC3B,KAAK,EAAE,qBAAqB,GAC3B,OAAO,CAAC,eAAe,CAAC,CAuJ1B"}
+{"version":3,"file":"request.d.ts","sourceRoot":"","sources":["../../src/actions/request.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAA;AAG1D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAA;AAE1D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AAUjD,OAAO,KAAK,EAAoB,aAAa,EAAE,MAAM,SAAS,CAAA;AAQ9D,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;IACvB;;;OAGG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAA;CAC9B;AAED,MAAM,WAAW,kBAAmB,SAAQ,oBAAoB;IAC9D,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,OAAO,CAAC,EAAE,aAAa,CAAA;IAChC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACzC,+FAA+F;IAC/F,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CAC/D;AAUD;;;;;GAKG;AACH,wBAAsB,aAAa,CACjC,OAAO,EAAE,kBAAkB,EAC3B,SAAS,EAAE,gBAAgB,EAC3B,KAAK,EAAE,kBAAkB,GACxB,OAAO,CAAC,eAAe,CAAC,CAuH1B"}

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

@@ -0,0 +1,40 @@
+import type { Logger } from "../../logging";
+import type { ObjectTypeWithPropertyTokens } from "../../ontology/tokens";
+import type { ActionReadRecorder } from "../read-facade";
+import type { ActionDefinition, ActionObjectSubject, ActionReadFacade, ActionRuntimeFacade, ActionSubject } from "../types";
+import type { LoadedObjectTarget } from "./phase-types";
+import type { ActionRunState } from "./state";
+import type { ActionRunContext, PendingActionRun } from "./types";
+export declare function toActionRuntimeFacade(runtime: ActionRunContext): ActionRuntimeFacade;
+export declare function toActionReadFacade(runtime: ActionRunContext, recorder: ActionReadRecorder): ActionReadFacade;
+/** The handler context every phase shares. Each phase adds the `signal` it runs under. */
+export declare function createBasePhaseContext(input: {
+    readonly runtime: ActionRunContext;
+    readonly action: ActionDefinition;
+    readonly state: ActionRunState;
+    readonly logger: Logger;
+}): {
+    run: {
+        id: string;
+        startedAt: Date;
+        idempotencyKey: string;
+    };
+    logger: Logger;
+    params: Record<string, unknown>;
+    subject: ActionSubject;
+};
+export type BasePhaseContext = ReturnType<typeof createBasePhaseContext>;
+export declare function loadObjectTarget(input: {
+    readonly runtime: ActionRunContext;
+    readonly action: ActionDefinition;
+    readonly run: PendingActionRun;
+}): Promise<LoadedObjectTarget | null>;
+export declare function requireObjectSubject<TObjectType extends ObjectTypeWithPropertyTokens = ObjectTypeWithPropertyTokens>(subject: ActionSubject, input: {
+    readonly actionId: string;
+    readonly runId: string;
+}): ActionObjectSubject<TObjectType>;
+export declare function requireObjectTarget(target: LoadedObjectTarget | null, input: {
+    readonly actionId: string;
+    readonly runId: string;
+}): LoadedObjectTarget;
+//# sourceMappingURL=context.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../../src/actions/run/context.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,eAAe,CAAA;AAC3C,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,uBAAuB,CAAA;AAEzE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAA;AAExD,OAAO,KAAK,EACV,gBAAgB,EAChB,mBAAmB,EACnB,gBAAgB,EAChB,mBAAmB,EACnB,aAAa,EAEd,MAAM,UAAU,CAAA;AAEjB,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAA;AACvD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAA;AAC7C,OAAO,KAAK,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAA;AAEjE,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,gBAAgB,GAAG,mBAAmB,CA6BpF;AAED,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,gBAAgB,EACzB,QAAQ,EAAE,kBAAkB,GAC3B,gBAAgB,CAUlB;AAqBD,0FAA0F;AAC1F,wBAAgB,sBAAsB,CAAC,KAAK,EAAE;IAC5C,QAAQ,CAAC,OAAO,EAAE,gBAAgB,CAAA;IAClC,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAA;IACjC,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAA;IAC9B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CACxB;;;;;;;;;EAkBA;AAED,MAAM,MAAM,gBAAgB,GAAG,UAAU,CAAC,OAAO,sBAAsB,CAAC,CAAA;AAExE,wBAAsB,gBAAgB,CAAC,KAAK,EAAE;IAC5C,QAAQ,CAAC,OAAO,EAAE,gBAAgB,CAAA;IAClC,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAA;IACjC,QAAQ,CAAC,GAAG,EAAE,gBAAgB,CAAA;CAC/B,GAAG,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC,CA8CrC;AAED,wBAAgB,oBAAoB,CAClC,WAAW,SAAS,4BAA4B,GAAG,4BAA4B,EAE/E,OAAO,EAAE,aAAa,EACtB,KAAK,EAAE;IAAE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAC3D,mBAAmB,CAAC,WAAW,CAAC,CASlC;AAED,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,kBAAkB,GAAG,IAAI,EACjC,KAAK,EAAE;IAAE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAC3D,kBAAkB,CASpB"}

package/dist/actions/run/edits-commit.d.ts

@@ -0,0 +1,31 @@
+import type { RecordActionRunInput } from "../../storage";
+import type { ActionEditCommitResult } from "../commit-edits";
+import type { ActionReadRecorder } from "../read-facade";
+import { type BasePhaseContext } from "./context";
+import type { LoadedObjectTarget, PhaseExecutionBase } from "./phase-types";
+import type { ActionRunState } from "./state";
+/** The commit of a run's edits, which recorded the run with them. */
+export interface CommittedActionRun {
+    readonly record: RecordActionRunInput;
+    readonly commit: ActionEditCommitResult;
+}
+/**
+ * Records the run's edits and commits them through the ontology Materializer, together with the
+ * run's terminal record. Resolves with `null` for an Action without edits, which commits nothing.
+ *
+ * Object and link-scope reads performed by the writeback and edits handlers, including every object
+ * a query or listing returned, are captured as expected revisions so a commit fails when that state
+ * changes. Query membership and telemetry history stay call-level snapshots. Domain events are
+ * durable outbox facts written inside the commit, so this phase never appends events itself.
+ *
+ * `signal` stops the edits handler and the step before the commit; the commit itself is never
+ * interrupted.
+ */
+export declare function runEditsAndCommitPhase(input: PhaseExecutionBase & {
+    readonly state: ActionRunState;
+    readonly baseContext: BasePhaseContext;
+    readonly objectTarget: LoadedObjectTarget | null;
+    /** Shared with the writeback phase so both phases' reads fence the same commit. */
+    readonly reads: ActionReadRecorder;
+}): Promise<CommittedActionRun | null>;
+//# sourceMappingURL=edits-commit.d.ts.map

package/dist/actions/run/edits-commit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"edits-commit.d.ts","sourceRoot":"","sources":["../../../src/actions/run/edits-commit.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAA;AACzD,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAA;AAE7D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAA;AAExD,OAAO,EAAE,KAAK,gBAAgB,EAA4C,MAAM,WAAW,CAAA;AAE3F,OAAO,KAAK,EAAE,kBAAkB,EAAE,kBAAkB,EAAuB,MAAM,eAAe,CAAA;AAChG,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAA;AAE7C,qEAAqE;AACrE,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,MAAM,EAAE,oBAAoB,CAAA;IACrC,QAAQ,CAAC,MAAM,EAAE,sBAAsB,CAAA;CACxC;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,sBAAsB,CAC1C,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,mFAAmF;IACnF,QAAQ,CAAC,KAAK,EAAE,kBAAkB,CAAA;CACnC,GACA,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC,CAgEpC"}

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

@@ -0,0 +1,23 @@
+import type { ActionEditCommitResult } from "../commit-edits";
+import type { ActionDefinition } from "../types";
+import type { ActionDeadline } from "./signals";
+import type { ActionRunState } from "./state";
+import type { ActionRunContext } from "./types";
+export interface RunActionEffectsInput {
+    readonly runtime: ActionRunContext;
+    readonly action: ActionDefinition;
+    /** The run, recorded as succeeded with the commit its effects receive. */
+    readonly state: ActionRunState;
+    readonly commit: ActionEditCommitResult;
+    /** Starts the effects' deadline. */
+    readonly startDeadline: () => ActionDeadline;
+}
+/**
+ * Run a recorded run's effects and record their outcome on it.
+ *
+ * Effects run after the run's record is returned, and nothing waits for them but a stopping
+ * process. They are best-effort: their failure does not reject this, it is recorded on the run and
+ * reported to `onError`, and the run stays succeeded.
+ */
+export declare function runActionEffects(input: RunActionEffectsInput): Promise<void>;
+//# sourceMappingURL=effects.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"effects.d.ts","sourceRoot":"","sources":["../../../src/actions/run/effects.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAA;AAC7D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAA;AAIhD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,WAAW,CAAA;AAC/C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAA;AAC7C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAA;AAE/C,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,OAAO,EAAE,gBAAgB,CAAA;IAClC,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAA;IACjC,0EAA0E;IAC1E,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAA;IAC9B,QAAQ,CAAC,MAAM,EAAE,sBAAsB,CAAA;IACvC,oCAAoC;IACpC,QAAQ,CAAC,aAAa,EAAE,MAAM,cAAc,CAAA;CAC7C;AAED;;;;;;GAMG;AACH,wBAAsB,gBAAgB,CAAC,KAAK,EAAE,qBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC,CA2BlF"}

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

@@ -0,0 +1,30 @@
+import { type PrimitiveExecutionHost } from "../../execution/primitive";
+import type { LoggingService } from "../../logging/service";
+import type { SixbDefinitions } from "../../runtime/definitions";
+import type { Storage } from "../../storage";
+import type { ExecutionRecord } from "../../storage/executions";
+import type { ActionRunOutcome, PendingActionRun } from "./types";
+/** What executing a stored Action run needs from its host. */
+export interface ActionRunHost extends PrimitiveExecutionHost {
+    readonly storage: Storage;
+    readonly logging?: LoggingService;
+    readonly definitions: Pick<SixbDefinitions, "actions">;
+}
+export interface ExecuteActionRunInput {
+    readonly run: PendingActionRun;
+    /** The durable execution the run was requested under. */
+    readonly execution: ExecutionRecord;
+    /** Cancels the run before its irreversible boundary. */
+    readonly signal?: AbortSignal;
+    /** Test-only override of the 30-second deadlines of the run and of its effects. */
+    readonly timeoutMs?: number;
+}
+/**
+ * Execute a requested Action run inside the durable execution it was requested under, and record it.
+ *
+ * Binds the Action's primitive scope to that execution, then runs the phases under the run's
+ * deadline and the caller's signal. Its effects, when it has any, are left to start: see
+ * {@link ActionRunOutcome.effects}.
+ */
+export declare function executeActionRun(host: ActionRunHost, input: ExecuteActionRunInput): Promise<ActionRunOutcome>;
+//# sourceMappingURL=execute.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"execute.d.ts","sourceRoot":"","sources":["../../../src/actions/run/execute.ts"],"names":[],"mappings":"AACA,OAAO,EAGL,KAAK,sBAAsB,EAC5B,MAAM,2BAA2B,CAAA;AAClC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAA;AAC3D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAA;AAChE,OAAO,KAAK,EAAoB,OAAO,EAAE,MAAM,eAAe,CAAA;AAC9D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAA;AAG/D,OAAO,KAAK,EAAoB,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAA;AAEnF,8DAA8D;AAC9D,MAAM,WAAW,aAAc,SAAQ,sBAAsB;IAC3D,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;IACzB,QAAQ,CAAC,OAAO,CAAC,EAAE,cAAc,CAAA;IACjC,QAAQ,CAAC,WAAW,EAAE,IAAI,CAAC,eAAe,EAAE,SAAS,CAAC,CAAA;CACvD;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,GAAG,EAAE,gBAAgB,CAAA;IAC9B,yDAAyD;IACzD,QAAQ,CAAC,SAAS,EAAE,eAAe,CAAA;IACnC,wDAAwD;IACxD,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAA;IAC7B,mFAAmF;IACnF,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAC5B;AAUD;;;;;;GAMG;AACH,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,aAAa,EACnB,KAAK,EAAE,qBAAqB,GAC3B,OAAO,CAAC,gBAAgB,CAAC,CA2B3B"}