@logixjs/core 0.0.1

package/dist/index.d.cts

@@ -0,0 +1,195 @@
+export { A as AnyModule, D as DevSource, H as HandleExtendFn, L as LogicUnitOptions, g as MakeExtendDef, j as Manage, M as Module, d as ModuleDef, c as ModuleDescriptor, a as ModuleDev, b as MountedLogicUnitSummary, R as Reducer, S as Shape, f as descriptor, h as hasImpl, i as is, m as make, e as unwrapImpl, u as unwrapTag } from './Module-B_0xRDMR.cjs';
+export { M as ModuleTag } from './ModuleTag-EGbgBMpZ.cjs';
+import { C as ConcurrencyLimit, S as StateTransactionInstrumentation, a as StatePatchPath, P as PatchReason, D as DirtyAllReason, b as DirtySet, F as FieldPath, c as FieldPathId, n as normalizeFieldPath } from './module-B8CBqIZ_.cjs';
+export { p as ActionOf, q as ActionsFromMap, h as AnyModuleShape, A as AnySchema, B as BoundApi, e as ConcurrencyPolicy, f as ConcurrencyPolicyOverrides, g as ConcurrencyPolicyPatch, m as ModuleHandle, k as ModuleImpl, j as ModuleLogic, l as ModuleRuntime, d as ModuleRuntimeTag, i as ModuleShape, M as ModuleTagType, r as MutatorsFromMap, R as ReducersFromMap, v as StateChangeWithMeta, u as StateCommitMeta, s as StateCommitMode, t as StateCommitPriority, o as StateOf } from './module-B8CBqIZ_.cjs';
+export { S as State } from './State-CU50R26M.cjs';
+export { A as Actions } from './Actions-AsQ07yTP.cjs';
+export { A as Action } from './Action-BkRHy2vg.cjs';
+export { L as Logic } from './Logic-DRh4sDZj.cjs';
+export { B as Bound } from './Bound-BPIfH9SS.cjs';
+export { L as Link } from './Link-fX8x1eCK.cjs';
+export { P as Process } from './Process-mL8fHDSB.cjs';
+export { H as Handle } from './Handle-D8D1zPb_.cjs';
+import { R as RuntimeInternalsResolvedConcurrencyPolicy, I as ImportsScope } from './Flow-1fZT8MpX.cjs';
+export { F as Flow } from './Flow-1fZT8MpX.cjs';
+export { M as MatchBuilder } from './MatchBuilder-CJk5oCkR.cjs';
+export { R as ReadQuery } from './ReadQuery-CL5XlXts.cjs';
+export { S as StateTrait } from './StateTrait-OWhbj12c.cjs';
+export { T as TraitLifecycle } from './TraitLifecycle-CwV5WPFX.cjs';
+export { R as Resource } from './Resource-Dy1xD_DG.cjs';
+export { R as Runtime } from './Runtime-B-aL-f29.cjs';
+export { K as Kernel } from './Kernel-8kC-jOda.cjs';
+export { S as ScopeRegistry } from './ScopeRegistry-D1owDNSm.cjs';
+export { R as Root } from './Root-7ADUMk4t.cjs';
+export { E as Env } from './Env-DuJ6JrU2.cjs';
+export { D as Debug, z as DebugLayerOptions, y as DebugMode, d as DevtoolsHubOptions, c as DevtoolsSnapshot, b as DiagnosticsLevel, E as Event, M as ModuleRuntimeCounter, I as ModuleTraitsDebug, J as ModuleTraitsFinalItem, P as PrettyLoggerOptions, r as RingBufferSink, R as RuntimeDebugEventRef, a as Sink, S as SnapshotToken, T as TraitConvergeDiagnosticsSamplingConfig, F as appendSinks, f as clearDevtoolsEvents, G as devtoolsHubLayer, o as diagnosticsLevel, n as exportEvidencePackage, h as getDevtoolsRunId, e as getDevtoolsSnapshot, g as getDevtoolsSnapshotToken, m as getInstanceLabel, O as getModuleFinalTraits, K as getModuleTraits, L as getModuleTraitsById, N as getModuleTraitsSnapshot, i as internal, q as isDevtoolsEnabled, A as layer, u as makeModuleRuntimeCounterSink, v as makeRingBufferSink, x as noopLayer, w as record, C as replace, H as runtimeLabel, j as setDevtoolsRunId, l as setInstanceLabel, k as startDevtoolsRun, s as subscribeDevtoolsSnapshot, t as toRuntimeDebugEventRef, Q as traceLayer, p as traitConvergeDiagnosticsSampling, B as withPrettyLogger } from './Debug-Bq8Sqjcr.cjs';
+export { P as Platform } from './Platform-CVlv0xLQ.cjs';
+import { T as TriggerRef, B as BuildEnv, C as ConstructionGuard, R as ReplayLog, a as RuntimeHost } from './Observability-COqEvp2C.cjs';
+export { O as Observability } from './Observability-COqEvp2C.cjs';
+export { R as Reflection } from './Reflection-Kabo1mlU.cjs';
+import { P as ProcessScope, a as ProcessInstallation, b as ProcessInstanceStatus, c as ProcessControlRequest, d as ProcessPlatformEvent, e as ProcessEvent } from './protocol-g_1897M2.cjs';
+import { Context, Effect, Stream, Scope, Layer } from 'effect';
+import './action-DiMDD_0v.cjs';
+import 'mutative';
+import './Platform-C49Pv956.cjs';
+import './ReadQuery-SinbStGF.cjs';
+import './ir-BMP7yxJJ.cjs';
+import 'effect/Layer';
+import './EffectOp.cjs';
+import 'effect/Effect';
+import './Middleware.cjs';
+import 'effect/Context';
+import 'effect/FiberRef';
+
+type ProcessInstallMode = 'switch' | 'exhaust';
+interface ProcessRuntime {
+    readonly install: <E, R>(process: Effect.Effect<void, E, R>, options: {
+        readonly scope: ProcessScope;
+        readonly enabled?: boolean;
+        readonly installedAt?: string;
+        readonly mode?: ProcessInstallMode;
+    }) => Effect.Effect<ProcessInstallation | undefined, never, R>;
+    readonly listInstallations: (filter?: {
+        readonly scopeType?: ProcessScope['type'];
+        readonly scopeKey?: string;
+    }) => Effect.Effect<ReadonlyArray<ProcessInstallation>>;
+    readonly getInstanceStatus: (processInstanceId: string) => Effect.Effect<ProcessInstanceStatus | undefined>;
+    readonly controlInstance: (processInstanceId: string, request: ProcessControlRequest) => Effect.Effect<void>;
+    readonly deliverPlatformEvent: (event: ProcessPlatformEvent) => Effect.Effect<void>;
+    readonly events: Stream.Stream<ProcessEvent>;
+    readonly getEventsSnapshot: () => Effect.Effect<ReadonlyArray<ProcessEvent>>;
+}
+declare const ProcessRuntimeTag_base: Context.TagClass<ProcessRuntimeTag, "@logixjs/core/ProcessRuntime", ProcessRuntime>;
+declare class ProcessRuntimeTag extends ProcessRuntimeTag_base {
+}
+
+interface ConcurrencyDiagnostics {
+    readonly emitPressureIfNeeded: (args: {
+        readonly policy: RuntimeInternalsResolvedConcurrencyPolicy;
+        readonly trigger: TriggerRef;
+        readonly backlogCount?: number;
+        readonly inFlight?: number;
+        readonly saturatedDurationMs?: number;
+    }) => Effect.Effect<void>;
+    readonly emitUnboundedPolicyIfNeeded: (args: {
+        readonly policy: RuntimeInternalsResolvedConcurrencyPolicy;
+        readonly trigger: TriggerRef;
+    }) => Effect.Effect<void>;
+}
+
+type ConcurrencyPolicyConfigScope = 'builtin' | 'runtime_default' | 'runtime_module' | 'provider';
+type ResolvedConcurrencyPolicy = {
+    readonly concurrencyLimit: ConcurrencyLimit;
+    readonly losslessBackpressureCapacity: number;
+    readonly allowUnbounded: boolean;
+    readonly pressureWarningThreshold: {
+        readonly backlogCount: number;
+        readonly backlogDurationMs: number;
+    };
+    readonly warningCooldownMs: number;
+    readonly configScope: ConcurrencyPolicyConfigScope;
+    /** Field-level scope for the effective concurrency limit. */
+    readonly concurrencyLimitScope: ConcurrencyPolicyConfigScope;
+    /** The originally requested concurrency limit (for explaining the unbounded gate). */
+    readonly requestedConcurrencyLimit: ConcurrencyLimit;
+    /** Field-level scope for the originally requested concurrency limit. */
+    readonly requestedConcurrencyLimitScope: ConcurrencyPolicyConfigScope;
+    /** Field-level scope for allowUnbounded. */
+    readonly allowUnboundedScope: ConcurrencyPolicyConfigScope;
+};
+
+type TxnLane = 'urgent' | 'nonUrgent';
+interface EnqueueTransaction {
+    <A, E>(eff: Effect.Effect<A, E, never>): Effect.Effect<A, E, never>;
+    <A, E>(lane: TxnLane, eff: Effect.Effect<A, E, never>): Effect.Effect<A, E, never>;
+}
+/**
+ * Builds a "single-instance transaction queue":
+ * - All entry points (dispatch/source-refresh/...) execute serially through the same FIFO queue.
+ * - Callers still experience the entry as a single Effect (preserving the existing API shape).
+ * - Tasks must "never fail", otherwise the queue consumer fiber would deadlock (so we return results via Deferred/Exit).
+ *
+ * NOTE: transaction execution happens inside a background queue fiber. To support Provider-local overrides (Tag/Layer)
+ * and diagnostics tiers (FiberRef) at the call site, we capture minimal context at enqueue-time and re-provide it to the task.
+ */
+declare const makeEnqueueTransaction: (args: {
+    readonly moduleId: string | undefined;
+    readonly instanceId: string;
+    readonly resolveConcurrencyPolicy: () => Effect.Effect<ResolvedConcurrencyPolicy>;
+    readonly diagnostics: ConcurrencyDiagnostics;
+}) => Effect.Effect<EnqueueTransaction, never, Scope.Scope>;
+
+/**
+ * InternalContracts: the internal contract access entrypoint for in-repo integrators.
+ *
+ * Notes:
+ * - This module replaces direct reads of `runtime.__*` magic fields.
+ * - Public API/behavior remains unchanged, and business code is not required to use this by default.
+ * - Exposes only minimal capabilities (ISP) to avoid leaking RuntimeInternals as a public dependency.
+ */
+declare const getImportsScope: (runtime: object) => ImportsScope;
+declare const getStateTransactionInstrumentation: (runtime: object) => StateTransactionInstrumentation;
+declare const getRowIdStore: (runtime: object) => unknown;
+declare const getStateTraitListConfigs: (runtime: object) => ReadonlyArray<unknown>;
+declare const registerStateTraitProgram: (runtime: object, program: unknown, registerOptions?: {
+    readonly bumpReason?: unknown;
+}) => void;
+declare const recordStatePatch: (runtime: object, path: StatePatchPath, reason: PatchReason, from?: unknown, to?: unknown, traitNodeId?: string, stepId?: number) => void;
+declare const runWithStateTransaction: <E, R>(runtime: object, origin: {
+    readonly kind: string;
+    readonly name?: string;
+    readonly details?: unknown;
+}, body: () => Effect.Effect<void, E, R>) => Effect.Effect<void, E, R>;
+declare const applyTransactionSnapshot: (runtime: object, txnId: string, mode: "before" | "after") => Effect.Effect<void, never, any>;
+declare const withCurrentLinkId: (linkId: string) => <B, E, R>(use: Effect.Effect<B, E, R>) => Effect.Effect<B, E, R>;
+/** 049: Exec VM (core-ng) switch: enable the Exec VM hot path within the current Effect scope. */
+declare const withExecVmMode: <A, E, R>(effect: Effect.Effect<A, E, R>) => Effect.Effect<A, E, R>;
+/** 049: Exec VM (core-ng) switch: enable/disable the Exec VM hot path within the current runtime scope. */
+declare const execVmModeLayer: (enabled: boolean) => Layer.Layer<any, never, never>;
+declare const getProcessInstallations: (options?: {
+    readonly scopeType?: ProcessScope["type"];
+    readonly scopeKey?: string;
+}) => Effect.Effect<ReadonlyArray<ProcessInstallation>, never, ProcessRuntimeTag>;
+declare const getProcessInstanceStatus: (processInstanceId: string) => Effect.Effect<ProcessInstanceStatus | undefined, never, ProcessRuntimeTag>;
+declare const controlProcessInstance: (processInstanceId: string, request: ProcessControlRequest) => Effect.Effect<void, never, ProcessRuntimeTag>;
+declare const deliverProcessPlatformEvent: (event: ProcessPlatformEvent) => Effect.Effect<void, never, ProcessRuntimeTag>;
+declare const getProcessEvents: () => Effect.Effect<ReadonlyArray<ProcessEvent>, never, ProcessRuntimeTag>;
+declare const installProcess: <E, R>(process: Effect.Effect<void, E, R>, options: {
+    readonly scope: ProcessScope;
+    readonly enabled?: boolean;
+    readonly installedAt?: string;
+    readonly mode?: "switch" | "exhaust";
+}) => Effect.Effect<ProcessInstallation | undefined, never, ProcessRuntimeTag | R>;
+
+declare const InternalContracts_BuildEnv: typeof BuildEnv;
+declare const InternalContracts_ConstructionGuard: typeof ConstructionGuard;
+declare const InternalContracts_DirtyAllReason: typeof DirtyAllReason;
+declare const InternalContracts_DirtySet: typeof DirtySet;
+declare const InternalContracts_FieldPath: typeof FieldPath;
+declare const InternalContracts_FieldPathId: typeof FieldPathId;
+declare const InternalContracts_ReplayLog: typeof ReplayLog;
+declare const InternalContracts_RuntimeHost: typeof RuntimeHost;
+declare const InternalContracts_applyTransactionSnapshot: typeof applyTransactionSnapshot;
+declare const InternalContracts_controlProcessInstance: typeof controlProcessInstance;
+declare const InternalContracts_deliverProcessPlatformEvent: typeof deliverProcessPlatformEvent;
+declare const InternalContracts_execVmModeLayer: typeof execVmModeLayer;
+declare const InternalContracts_getImportsScope: typeof getImportsScope;
+declare const InternalContracts_getProcessEvents: typeof getProcessEvents;
+declare const InternalContracts_getProcessInstallations: typeof getProcessInstallations;
+declare const InternalContracts_getProcessInstanceStatus: typeof getProcessInstanceStatus;
+declare const InternalContracts_getRowIdStore: typeof getRowIdStore;
+declare const InternalContracts_getStateTraitListConfigs: typeof getStateTraitListConfigs;
+declare const InternalContracts_getStateTransactionInstrumentation: typeof getStateTransactionInstrumentation;
+declare const InternalContracts_installProcess: typeof installProcess;
+declare const InternalContracts_makeEnqueueTransaction: typeof makeEnqueueTransaction;
+declare const InternalContracts_normalizeFieldPath: typeof normalizeFieldPath;
+declare const InternalContracts_recordStatePatch: typeof recordStatePatch;
+declare const InternalContracts_registerStateTraitProgram: typeof registerStateTraitProgram;
+declare const InternalContracts_runWithStateTransaction: typeof runWithStateTransaction;
+declare const InternalContracts_withCurrentLinkId: typeof withCurrentLinkId;
+declare const InternalContracts_withExecVmMode: typeof withExecVmMode;
+declare namespace InternalContracts {
+  export { InternalContracts_BuildEnv as BuildEnv, InternalContracts_ConstructionGuard as ConstructionGuard, InternalContracts_DirtyAllReason as DirtyAllReason, InternalContracts_DirtySet as DirtySet, InternalContracts_FieldPath as FieldPath, InternalContracts_FieldPathId as FieldPathId, InternalContracts_ReplayLog as ReplayLog, InternalContracts_RuntimeHost as RuntimeHost, InternalContracts_applyTransactionSnapshot as applyTransactionSnapshot, InternalContracts_controlProcessInstance as controlProcessInstance, InternalContracts_deliverProcessPlatformEvent as deliverProcessPlatformEvent, InternalContracts_execVmModeLayer as execVmModeLayer, InternalContracts_getImportsScope as getImportsScope, InternalContracts_getProcessEvents as getProcessEvents, InternalContracts_getProcessInstallations as getProcessInstallations, InternalContracts_getProcessInstanceStatus as getProcessInstanceStatus, InternalContracts_getRowIdStore as getRowIdStore, InternalContracts_getStateTraitListConfigs as getStateTraitListConfigs, InternalContracts_getStateTransactionInstrumentation as getStateTransactionInstrumentation, InternalContracts_installProcess as installProcess, InternalContracts_makeEnqueueTransaction as makeEnqueueTransaction, InternalContracts_normalizeFieldPath as normalizeFieldPath, InternalContracts_recordStatePatch as recordStatePatch, InternalContracts_registerStateTraitProgram as registerStateTraitProgram, InternalContracts_runWithStateTransaction as runWithStateTransaction, InternalContracts_withCurrentLinkId as withCurrentLinkId, InternalContracts_withExecVmMode as withExecVmMode };
+}
+
+export { ConcurrencyLimit, InternalContracts };

package/dist/index.d.ts

@@ -0,0 +1,195 @@
+export { A as AnyModule, D as DevSource, H as HandleExtendFn, L as LogicUnitOptions, g as MakeExtendDef, j as Manage, M as Module, d as ModuleDef, c as ModuleDescriptor, a as ModuleDev, b as MountedLogicUnitSummary, R as Reducer, S as Shape, f as descriptor, h as hasImpl, i as is, m as make, e as unwrapImpl, u as unwrapTag } from './Module-DnzluX2J.js';
+export { M as ModuleTag } from './ModuleTag-C8FHY_sY.js';
+import { C as ConcurrencyLimit, S as StateTransactionInstrumentation, a as StatePatchPath, P as PatchReason, D as DirtyAllReason, b as DirtySet, F as FieldPath, c as FieldPathId, n as normalizeFieldPath } from './module-k7m3txak.js';
+export { p as ActionOf, q as ActionsFromMap, h as AnyModuleShape, A as AnySchema, B as BoundApi, e as ConcurrencyPolicy, f as ConcurrencyPolicyOverrides, g as ConcurrencyPolicyPatch, m as ModuleHandle, k as ModuleImpl, j as ModuleLogic, l as ModuleRuntime, d as ModuleRuntimeTag, i as ModuleShape, M as ModuleTagType, r as MutatorsFromMap, R as ReducersFromMap, v as StateChangeWithMeta, u as StateCommitMeta, s as StateCommitMode, t as StateCommitPriority, o as StateOf } from './module-k7m3txak.js';
+export { S as State } from './State-CU50R26M.js';
+export { A as Actions } from './Actions-AsQ07yTP.js';
+export { A as Action } from './Action-mqVvtEHt.js';
+export { L as Logic } from './Logic-BRjEMr-W.js';
+export { B as Bound } from './Bound-BN1DQ_lM.js';
+export { L as Link } from './Link-Db7975nU.js';
+export { P as Process } from './Process-CM9xbMdP.js';
+export { H as Handle } from './Handle-D_cLW1Z3.js';
+import { R as RuntimeInternalsResolvedConcurrencyPolicy, I as ImportsScope } from './Flow-BhpjE22E.js';
+export { F as Flow } from './Flow-BhpjE22E.js';
+export { M as MatchBuilder } from './MatchBuilder-0QOc-nlU.js';
+export { R as ReadQuery } from './ReadQuery-BlMwhe-F.js';
+export { S as StateTrait } from './StateTrait-BGsZghTz.js';
+export { T as TraitLifecycle } from './TraitLifecycle-LdIWmKlg.js';
+export { R as Resource } from './Resource-Dy1xD_DG.js';
+export { R as Runtime } from './Runtime-CtyzZG4i.js';
+export { K as Kernel } from './Kernel-CnGE1Fyk.js';
+export { S as ScopeRegistry } from './ScopeRegistry-D1owDNSm.js';
+export { R as Root } from './Root-7ADUMk4t.js';
+export { E as Env } from './Env-DuJ6JrU2.js';
+export { D as Debug, z as DebugLayerOptions, y as DebugMode, d as DevtoolsHubOptions, c as DevtoolsSnapshot, b as DiagnosticsLevel, E as Event, M as ModuleRuntimeCounter, I as ModuleTraitsDebug, J as ModuleTraitsFinalItem, P as PrettyLoggerOptions, r as RingBufferSink, R as RuntimeDebugEventRef, a as Sink, S as SnapshotToken, T as TraitConvergeDiagnosticsSamplingConfig, F as appendSinks, f as clearDevtoolsEvents, G as devtoolsHubLayer, o as diagnosticsLevel, n as exportEvidencePackage, h as getDevtoolsRunId, e as getDevtoolsSnapshot, g as getDevtoolsSnapshotToken, m as getInstanceLabel, O as getModuleFinalTraits, K as getModuleTraits, L as getModuleTraitsById, N as getModuleTraitsSnapshot, i as internal, q as isDevtoolsEnabled, A as layer, u as makeModuleRuntimeCounterSink, v as makeRingBufferSink, x as noopLayer, w as record, C as replace, H as runtimeLabel, j as setDevtoolsRunId, l as setInstanceLabel, k as startDevtoolsRun, s as subscribeDevtoolsSnapshot, t as toRuntimeDebugEventRef, Q as traceLayer, p as traitConvergeDiagnosticsSampling, B as withPrettyLogger } from './Debug-B5q5Bkzx.js';
+export { P as Platform } from './Platform-CHX8o-U4.js';
+import { T as TriggerRef, B as BuildEnv, C as ConstructionGuard, R as ReplayLog, a as RuntimeHost } from './Observability-cY4kLn0S.js';
+export { O as Observability } from './Observability-cY4kLn0S.js';
+export { R as Reflection } from './Reflection-CQnKwPXj.js';
+import { P as ProcessScope, a as ProcessInstallation, b as ProcessInstanceStatus, c as ProcessControlRequest, d as ProcessPlatformEvent, e as ProcessEvent } from './protocol-g_1897M2.js';
+import { Context, Effect, Stream, Scope, Layer } from 'effect';
+import './action-DiMDD_0v.js';
+import 'mutative';
+import './Platform-C49Pv956.js';
+import './ReadQuery-SinbStGF.js';
+import './ir-DUOz6H-5.js';
+import 'effect/Layer';
+import './EffectOp.js';
+import 'effect/Effect';
+import './Middleware.js';
+import 'effect/Context';
+import 'effect/FiberRef';
+
+type ProcessInstallMode = 'switch' | 'exhaust';
+interface ProcessRuntime {
+    readonly install: <E, R>(process: Effect.Effect<void, E, R>, options: {
+        readonly scope: ProcessScope;
+        readonly enabled?: boolean;
+        readonly installedAt?: string;
+        readonly mode?: ProcessInstallMode;
+    }) => Effect.Effect<ProcessInstallation | undefined, never, R>;
+    readonly listInstallations: (filter?: {
+        readonly scopeType?: ProcessScope['type'];
+        readonly scopeKey?: string;
+    }) => Effect.Effect<ReadonlyArray<ProcessInstallation>>;
+    readonly getInstanceStatus: (processInstanceId: string) => Effect.Effect<ProcessInstanceStatus | undefined>;
+    readonly controlInstance: (processInstanceId: string, request: ProcessControlRequest) => Effect.Effect<void>;
+    readonly deliverPlatformEvent: (event: ProcessPlatformEvent) => Effect.Effect<void>;
+    readonly events: Stream.Stream<ProcessEvent>;
+    readonly getEventsSnapshot: () => Effect.Effect<ReadonlyArray<ProcessEvent>>;
+}
+declare const ProcessRuntimeTag_base: Context.TagClass<ProcessRuntimeTag, "@logixjs/core/ProcessRuntime", ProcessRuntime>;
+declare class ProcessRuntimeTag extends ProcessRuntimeTag_base {
+}
+
+interface ConcurrencyDiagnostics {
+    readonly emitPressureIfNeeded: (args: {
+        readonly policy: RuntimeInternalsResolvedConcurrencyPolicy;
+        readonly trigger: TriggerRef;
+        readonly backlogCount?: number;
+        readonly inFlight?: number;
+        readonly saturatedDurationMs?: number;
+    }) => Effect.Effect<void>;
+    readonly emitUnboundedPolicyIfNeeded: (args: {
+        readonly policy: RuntimeInternalsResolvedConcurrencyPolicy;
+        readonly trigger: TriggerRef;
+    }) => Effect.Effect<void>;
+}
+
+type ConcurrencyPolicyConfigScope = 'builtin' | 'runtime_default' | 'runtime_module' | 'provider';
+type ResolvedConcurrencyPolicy = {
+    readonly concurrencyLimit: ConcurrencyLimit;
+    readonly losslessBackpressureCapacity: number;
+    readonly allowUnbounded: boolean;
+    readonly pressureWarningThreshold: {
+        readonly backlogCount: number;
+        readonly backlogDurationMs: number;
+    };
+    readonly warningCooldownMs: number;
+    readonly configScope: ConcurrencyPolicyConfigScope;
+    /** Field-level scope for the effective concurrency limit. */
+    readonly concurrencyLimitScope: ConcurrencyPolicyConfigScope;
+    /** The originally requested concurrency limit (for explaining the unbounded gate). */
+    readonly requestedConcurrencyLimit: ConcurrencyLimit;
+    /** Field-level scope for the originally requested concurrency limit. */
+    readonly requestedConcurrencyLimitScope: ConcurrencyPolicyConfigScope;
+    /** Field-level scope for allowUnbounded. */
+    readonly allowUnboundedScope: ConcurrencyPolicyConfigScope;
+};
+
+type TxnLane = 'urgent' | 'nonUrgent';
+interface EnqueueTransaction {
+    <A, E>(eff: Effect.Effect<A, E, never>): Effect.Effect<A, E, never>;
+    <A, E>(lane: TxnLane, eff: Effect.Effect<A, E, never>): Effect.Effect<A, E, never>;
+}
+/**
+ * Builds a "single-instance transaction queue":
+ * - All entry points (dispatch/source-refresh/...) execute serially through the same FIFO queue.
+ * - Callers still experience the entry as a single Effect (preserving the existing API shape).
+ * - Tasks must "never fail", otherwise the queue consumer fiber would deadlock (so we return results via Deferred/Exit).
+ *
+ * NOTE: transaction execution happens inside a background queue fiber. To support Provider-local overrides (Tag/Layer)
+ * and diagnostics tiers (FiberRef) at the call site, we capture minimal context at enqueue-time and re-provide it to the task.
+ */
+declare const makeEnqueueTransaction: (args: {
+    readonly moduleId: string | undefined;
+    readonly instanceId: string;
+    readonly resolveConcurrencyPolicy: () => Effect.Effect<ResolvedConcurrencyPolicy>;
+    readonly diagnostics: ConcurrencyDiagnostics;
+}) => Effect.Effect<EnqueueTransaction, never, Scope.Scope>;
+
+/**
+ * InternalContracts: the internal contract access entrypoint for in-repo integrators.
+ *
+ * Notes:
+ * - This module replaces direct reads of `runtime.__*` magic fields.
+ * - Public API/behavior remains unchanged, and business code is not required to use this by default.
+ * - Exposes only minimal capabilities (ISP) to avoid leaking RuntimeInternals as a public dependency.
+ */
+declare const getImportsScope: (runtime: object) => ImportsScope;
+declare const getStateTransactionInstrumentation: (runtime: object) => StateTransactionInstrumentation;
+declare const getRowIdStore: (runtime: object) => unknown;
+declare const getStateTraitListConfigs: (runtime: object) => ReadonlyArray<unknown>;
+declare const registerStateTraitProgram: (runtime: object, program: unknown, registerOptions?: {
+    readonly bumpReason?: unknown;
+}) => void;
+declare const recordStatePatch: (runtime: object, path: StatePatchPath, reason: PatchReason, from?: unknown, to?: unknown, traitNodeId?: string, stepId?: number) => void;
+declare const runWithStateTransaction: <E, R>(runtime: object, origin: {
+    readonly kind: string;
+    readonly name?: string;
+    readonly details?: unknown;
+}, body: () => Effect.Effect<void, E, R>) => Effect.Effect<void, E, R>;
+declare const applyTransactionSnapshot: (runtime: object, txnId: string, mode: "before" | "after") => Effect.Effect<void, never, any>;
+declare const withCurrentLinkId: (linkId: string) => <B, E, R>(use: Effect.Effect<B, E, R>) => Effect.Effect<B, E, R>;
+/** 049: Exec VM (core-ng) switch: enable the Exec VM hot path within the current Effect scope. */
+declare const withExecVmMode: <A, E, R>(effect: Effect.Effect<A, E, R>) => Effect.Effect<A, E, R>;
+/** 049: Exec VM (core-ng) switch: enable/disable the Exec VM hot path within the current runtime scope. */
+declare const execVmModeLayer: (enabled: boolean) => Layer.Layer<any, never, never>;
+declare const getProcessInstallations: (options?: {
+    readonly scopeType?: ProcessScope["type"];
+    readonly scopeKey?: string;
+}) => Effect.Effect<ReadonlyArray<ProcessInstallation>, never, ProcessRuntimeTag>;
+declare const getProcessInstanceStatus: (processInstanceId: string) => Effect.Effect<ProcessInstanceStatus | undefined, never, ProcessRuntimeTag>;
+declare const controlProcessInstance: (processInstanceId: string, request: ProcessControlRequest) => Effect.Effect<void, never, ProcessRuntimeTag>;
+declare const deliverProcessPlatformEvent: (event: ProcessPlatformEvent) => Effect.Effect<void, never, ProcessRuntimeTag>;
+declare const getProcessEvents: () => Effect.Effect<ReadonlyArray<ProcessEvent>, never, ProcessRuntimeTag>;
+declare const installProcess: <E, R>(process: Effect.Effect<void, E, R>, options: {
+    readonly scope: ProcessScope;
+    readonly enabled?: boolean;
+    readonly installedAt?: string;
+    readonly mode?: "switch" | "exhaust";
+}) => Effect.Effect<ProcessInstallation | undefined, never, ProcessRuntimeTag | R>;
+
+declare const InternalContracts_BuildEnv: typeof BuildEnv;
+declare const InternalContracts_ConstructionGuard: typeof ConstructionGuard;
+declare const InternalContracts_DirtyAllReason: typeof DirtyAllReason;
+declare const InternalContracts_DirtySet: typeof DirtySet;
+declare const InternalContracts_FieldPath: typeof FieldPath;
+declare const InternalContracts_FieldPathId: typeof FieldPathId;
+declare const InternalContracts_ReplayLog: typeof ReplayLog;
+declare const InternalContracts_RuntimeHost: typeof RuntimeHost;
+declare const InternalContracts_applyTransactionSnapshot: typeof applyTransactionSnapshot;
+declare const InternalContracts_controlProcessInstance: typeof controlProcessInstance;
+declare const InternalContracts_deliverProcessPlatformEvent: typeof deliverProcessPlatformEvent;
+declare const InternalContracts_execVmModeLayer: typeof execVmModeLayer;
+declare const InternalContracts_getImportsScope: typeof getImportsScope;
+declare const InternalContracts_getProcessEvents: typeof getProcessEvents;
+declare const InternalContracts_getProcessInstallations: typeof getProcessInstallations;
+declare const InternalContracts_getProcessInstanceStatus: typeof getProcessInstanceStatus;
+declare const InternalContracts_getRowIdStore: typeof getRowIdStore;
+declare const InternalContracts_getStateTraitListConfigs: typeof getStateTraitListConfigs;
+declare const InternalContracts_getStateTransactionInstrumentation: typeof getStateTransactionInstrumentation;
+declare const InternalContracts_installProcess: typeof installProcess;
+declare const InternalContracts_makeEnqueueTransaction: typeof makeEnqueueTransaction;
+declare const InternalContracts_normalizeFieldPath: typeof normalizeFieldPath;
+declare const InternalContracts_recordStatePatch: typeof recordStatePatch;
+declare const InternalContracts_registerStateTraitProgram: typeof registerStateTraitProgram;
+declare const InternalContracts_runWithStateTransaction: typeof runWithStateTransaction;
+declare const InternalContracts_withCurrentLinkId: typeof withCurrentLinkId;
+declare const InternalContracts_withExecVmMode: typeof withExecVmMode;
+declare namespace InternalContracts {
+  export { InternalContracts_BuildEnv as BuildEnv, InternalContracts_ConstructionGuard as ConstructionGuard, InternalContracts_DirtyAllReason as DirtyAllReason, InternalContracts_DirtySet as DirtySet, InternalContracts_FieldPath as FieldPath, InternalContracts_FieldPathId as FieldPathId, InternalContracts_ReplayLog as ReplayLog, InternalContracts_RuntimeHost as RuntimeHost, InternalContracts_applyTransactionSnapshot as applyTransactionSnapshot, InternalContracts_controlProcessInstance as controlProcessInstance, InternalContracts_deliverProcessPlatformEvent as deliverProcessPlatformEvent, InternalContracts_execVmModeLayer as execVmModeLayer, InternalContracts_getImportsScope as getImportsScope, InternalContracts_getProcessEvents as getProcessEvents, InternalContracts_getProcessInstallations as getProcessInstallations, InternalContracts_getProcessInstanceStatus as getProcessInstanceStatus, InternalContracts_getRowIdStore as getRowIdStore, InternalContracts_getStateTraitListConfigs as getStateTraitListConfigs, InternalContracts_getStateTransactionInstrumentation as getStateTransactionInstrumentation, InternalContracts_installProcess as installProcess, InternalContracts_makeEnqueueTransaction as makeEnqueueTransaction, InternalContracts_normalizeFieldPath as normalizeFieldPath, InternalContracts_recordStatePatch as recordStatePatch, InternalContracts_registerStateTraitProgram as registerStateTraitProgram, InternalContracts_runWithStateTransaction as runWithStateTransaction, InternalContracts_withCurrentLinkId as withCurrentLinkId, InternalContracts_withExecVmMode as withExecVmMode };
+}
+
+export { ConcurrencyLimit, InternalContracts };