@logixjs/core 0.0.1 → 0.0.2

package/dist/index.d.cts

@@ -1,46 +1,164 @@
-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 { n as ActionSchemaOf, l as ActionTokenMap, m as ActionUnionOf, A as AnyModule, D as DevSource, H as HandleExtendFn, L as LogicUnitOptions, k as MakeExtendDef, p as Manage, M as Module, f as ModuleDef, c as ModuleDescriptor, a as ModuleDev, e as ModuleLogicApi, d as ModuleSelfHandleEffect, b as MountedLogicUnitSummary, R as Reducer, S as Shape, j as descriptor, h as hasImpl, i as is, o as make, g as unwrapImpl, u as unwrapTag } from './Module-DpXPW9EQ.cjs';
+export { M as ModuleTag } from './ModuleTag-DuZXo_NS.cjs';
+import { S as StateCommitPriority, a as StateCommitMeta, C as ConcurrencyLimit, b as StateTransactionInstrumentation, c as StatePatchPath, P as PatchReason, D as DirtyAllReason, d as DirtySet, F as FieldPath, e as FieldPathId, n as normalizeFieldPath } from './module-doenaCsZ.cjs';
+export { w as ActionForTag, s as ActionOf, t as ActionsFromMap, j as AnyModuleShape, A as AnySchema, B as BoundApi, E as BoundApiDispatchApi, z as BoundApiDispatchersApi, G as BoundApiLifecycleApi, J as BoundApiReducerApi, x as BoundApiRootApi, y as BoundApiStateApi, I as BoundApiTraitsApi, H as BoundApiUseApi, g as ConcurrencyPolicy, h as ConcurrencyPolicyOverrides, i as ConcurrencyPolicyPatch, v as DispatchEffect, L as LogicEffect, q as ModuleHandle, m as ModuleImpl, l as ModuleLogic, o as ModuleRuntime, p as ModuleRuntimeOfShape, f as ModuleRuntimeTag, k as ModuleShape, M as ModuleTagType, u as MutatorsFromMap, R as ReducersFromMap, N as StateChangeWithMeta, K as StateCommitMode, r as StateOf } from './module-doenaCsZ.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 { L as Logic } from './Logic-BcQA0AvE.cjs';
+export { B as Bound } from './Bound-CNLNkC7c.cjs';
+export { L as Link } from './Link-DF8i8iWR.cjs';
+export { P as Process } from './Process-B55aJMFk.cjs';
+export { H as Handle } from './Handle-ByovhL-c.cjs';
+import { R as RuntimeInternalsResolvedConcurrencyPolicy, I as ImportsScope } from './Flow-BlSoMmhV.cjs';
+export { F as Flow } from './Flow-BlSoMmhV.cjs';
+export { W as Workflow } from './Workflow-BlFG_20_.cjs';
+export { M as MatchBuilder } from './MatchBuilder-CvZ5WY1B.cjs';
+export { R as ReadQuery } from './ReadQuery-mc0NgrFV.cjs';
+export { E as ExternalStore } from './ExternalStore-BAz83PVq.cjs';
+export { S as StateTrait } from './StateTrait-CQsDlXJm.cjs';
+export { T as TraitLifecycle } from './TraitLifecycle-NmqGiXPC.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 { R as Runtime } from './Runtime-PShIC4DW.cjs';
+export { K as Kernel } from './Kernel-DZAk-Mrn.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 { 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-BhMYr-1i.cjs';
+export { M as Middleware } from './Middleware-D8tUDLv_.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 { T as TriggerRef, B as BuildEnv, C as ConstructionGuard, R as ReplayLog, a as RuntimeHost } from './Observability-V7sRMYTh.cjs';
+export { O as Observability } from './Observability-V7sRMYTh.cjs';
+export { R as Reflection } from './Reflection-DP7Vsv3f.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 { Context, Effect, Stream, Scope, ManagedRuntime, Layer } from 'effect';
 import './action-DiMDD_0v.cjs';
 import 'mutative';
 import './Platform-C49Pv956.cjs';
-import './ReadQuery-SinbStGF.cjs';
-import './ir-BMP7yxJJ.cjs';
+import './ReadQuery-CafjlJQo.cjs';
+import './ir-C-Zm_GlZ.cjs';
 import 'effect/Layer';
 import './EffectOp.cjs';
 import 'effect/Effect';
-import './Middleware.cjs';
 import 'effect/Context';
 import 'effect/FiberRef';
 
+type Cancel = () => void;
+type HostScheduler = {
+    readonly nowMs: () => number;
+    readonly scheduleMicrotask: (cb: () => void) => void;
+    readonly scheduleMacrotask: (cb: () => void) => Cancel;
+    readonly scheduleAnimationFrame: (cb: () => void) => Cancel;
+    readonly scheduleTimeout: (ms: number, cb: () => void) => Cancel;
+};
+type DeterministicHostScheduler = HostScheduler & {
+    readonly flushMicrotasks: (options?: {
+        readonly max?: number;
+    }) => number;
+    readonly flushOneMacrotask: () => boolean;
+    readonly flushAll: (options?: {
+        readonly maxTurns?: number;
+    }) => {
+        readonly turns: number;
+        readonly ran: number;
+    };
+    readonly getQueueSize: () => {
+        readonly microtasks: number;
+        readonly macrotasks: number;
+    };
+};
+
+type ModuleInstanceKey = `${string}::${string}`;
+type TopicKey = string;
+interface RuntimeStoreModuleCommit {
+    readonly moduleId: string;
+    readonly instanceId: string;
+    readonly moduleInstanceKey: ModuleInstanceKey;
+    readonly state: unknown;
+    readonly meta: StateCommitMeta;
+    readonly opSeq?: number;
+}
+interface RuntimeStorePendingDrain {
+    readonly modules: ReadonlyMap<ModuleInstanceKey, RuntimeStoreModuleCommit>;
+    readonly dirtyTopics: ReadonlyMap<TopicKey, StateCommitPriority>;
+}
+interface RuntimeStoreCommitResult {
+    readonly changedTopics: ReadonlyMap<TopicKey, {
+        readonly priority: StateCommitPriority;
+        readonly listeners: ReadonlyArray<() => void>;
+    }>;
+}
+interface RuntimeStore {
+    readonly getTickSeq: () => number;
+    readonly getModuleState: (moduleInstanceKey: ModuleInstanceKey) => unknown;
+    readonly getTopicVersion: (topicKey: TopicKey) => number;
+    readonly getTopicPriority: (topicKey: TopicKey) => StateCommitPriority;
+    readonly subscribeTopic: (topicKey: TopicKey, listener: () => void) => () => void;
+    readonly getTopicSubscriberCount: (topicKey: TopicKey) => number;
+    readonly getModuleSubscriberCount: (moduleInstanceKey: ModuleInstanceKey) => number;
+    readonly registerModuleInstance: (args: {
+        readonly moduleId: string;
+        readonly instanceId: string;
+        readonly moduleInstanceKey: ModuleInstanceKey;
+        readonly initialState: unknown;
+    }) => void;
+    readonly unregisterModuleInstance: (moduleInstanceKey: ModuleInstanceKey) => void;
+    readonly commitTick: (args: {
+        readonly tickSeq: number;
+        readonly accepted: RuntimeStorePendingDrain;
+    }) => RuntimeStoreCommitResult;
+    readonly dispose: () => void;
+}
+
+type TickDegradeReason = 'budget_steps' | 'cycle_detected' | 'unknown';
+interface TickSchedulerConfig {
+    /**
+     * Fixpoint step cap:
+     * - Steps count "work acceptance units" within a single tick, not time.
+     * - Exceeding the budget triggers a soft degrade (stable=false), deferring nonUrgent backlog to the next tick.
+     */
+    readonly maxSteps?: number;
+    /**
+     * Urgent safety cap:
+     * - Even urgent work may be cut when the system appears to be in a cycle (avoid freezing).
+     */
+    readonly urgentStepCap?: number;
+    /**
+     * Drain-round cap:
+     * - Bounds the number of drain rounds while capturing concurrent commits before committing the tick snapshot.
+     * - Exceeding the cap is treated as a cycle (stable=false, degradeReason=cycle_detected).
+     */
+    readonly maxDrainRounds?: number;
+    /**
+     * Microtask starvation protection threshold:
+     * - Counts consecutive ticks scheduled on microtask boundaries without yielding to host (best-effort).
+     * - Exceeding the limit forces the next tick to start on a macrotask boundary.
+     */
+    readonly microtaskChainDepthLimit?: number;
+    /**
+     * Optional degraded-tick telemetry (opt-in, sampled):
+     * - Runs even when diagnostics=off (Devtools disabled).
+     * - Intended for production health signals (frequency of stable=false / forced yield).
+     */
+    readonly telemetry?: TickSchedulerTelemetryConfig;
+}
+interface TickSchedulerTelemetryEvent {
+    readonly tickSeq: number;
+    readonly stable: boolean;
+    readonly degradeReason?: TickDegradeReason;
+    readonly forcedMacrotask?: boolean;
+    readonly scheduleReason?: TickScheduleReason;
+    readonly microtaskChainDepth?: number;
+    readonly deferredWorkCount?: number;
+}
+interface TickSchedulerTelemetryConfig {
+    /** Sample rate in [0, 1]. Default: 0 (disabled). */
+    readonly sampleRate?: number;
+    /** Called for ticks that are degraded (stable=false) and/or started on a forced macrotask boundary. */
+    readonly onTickDegraded?: (event: TickSchedulerTelemetryEvent) => void;
+}
+type TickScheduleReason = 'budget' | 'cycle_detected' | 'microtask_starvation' | 'unknown';
+
 type ProcessInstallMode = 'switch' | 'exhaust';
 interface ProcessRuntime {
     readonly install: <E, R>(process: Effect.Effect<void, E, R>, options: {
@@ -128,6 +246,14 @@ declare const makeEnqueueTransaction: (args: {
  * - Exposes only minimal capabilities (ISP) to avoid leaking RuntimeInternals as a public dependency.
  */
 declare const getImportsScope: (runtime: object) => ImportsScope;
+declare const getRuntimeStore: (runtime: ManagedRuntime.ManagedRuntime<any, any>) => RuntimeStore;
+declare const getHostScheduler: (runtime: ManagedRuntime.ManagedRuntime<any, any>) => HostScheduler;
+
+declare const makeDeterministicHostScheduler: () => DeterministicHostScheduler;
+declare const hostSchedulerTestLayer: (scheduler: HostScheduler) => Layer.Layer<any, never, never>;
+declare const tickSchedulerTestLayer: (config?: TickSchedulerConfig) => Layer.Layer<any, never, never>;
+declare const __unsafeSetGlobalHostScheduler: (next: HostScheduler | undefined) => void;
+declare const tickServicesLayer: Layer.Layer<any, never, never>;
 declare const getStateTransactionInstrumentation: (runtime: object) => StateTransactionInstrumentation;
 declare const getRowIdStore: (runtime: object) => unknown;
 declare const getStateTraitListConfigs: (runtime: object) => ReadonlyArray<unknown>;
@@ -163,33 +289,43 @@ declare const installProcess: <E, R>(process: Effect.Effect<void, E, R>, options
 
 declare const InternalContracts_BuildEnv: typeof BuildEnv;
 declare const InternalContracts_ConstructionGuard: typeof ConstructionGuard;
+type InternalContracts_DeterministicHostScheduler = DeterministicHostScheduler;
 declare const InternalContracts_DirtyAllReason: typeof DirtyAllReason;
 declare const InternalContracts_DirtySet: typeof DirtySet;
 declare const InternalContracts_FieldPath: typeof FieldPath;
 declare const InternalContracts_FieldPathId: typeof FieldPathId;
+type InternalContracts_HostScheduler = HostScheduler;
 declare const InternalContracts_ReplayLog: typeof ReplayLog;
 declare const InternalContracts_RuntimeHost: typeof RuntimeHost;
+type InternalContracts_TickSchedulerConfig = TickSchedulerConfig;
+declare const InternalContracts___unsafeSetGlobalHostScheduler: typeof __unsafeSetGlobalHostScheduler;
 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_getHostScheduler: typeof getHostScheduler;
 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_getRuntimeStore: typeof getRuntimeStore;
 declare const InternalContracts_getStateTraitListConfigs: typeof getStateTraitListConfigs;
 declare const InternalContracts_getStateTransactionInstrumentation: typeof getStateTransactionInstrumentation;
+declare const InternalContracts_hostSchedulerTestLayer: typeof hostSchedulerTestLayer;
 declare const InternalContracts_installProcess: typeof installProcess;
+declare const InternalContracts_makeDeterministicHostScheduler: typeof makeDeterministicHostScheduler;
 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_tickSchedulerTestLayer: typeof tickSchedulerTestLayer;
+declare const InternalContracts_tickServicesLayer: typeof tickServicesLayer;
 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 { InternalContracts_BuildEnv as BuildEnv, InternalContracts_ConstructionGuard as ConstructionGuard, type InternalContracts_DeterministicHostScheduler as DeterministicHostScheduler, InternalContracts_DirtyAllReason as DirtyAllReason, InternalContracts_DirtySet as DirtySet, InternalContracts_FieldPath as FieldPath, InternalContracts_FieldPathId as FieldPathId, type InternalContracts_HostScheduler as HostScheduler, InternalContracts_ReplayLog as ReplayLog, InternalContracts_RuntimeHost as RuntimeHost, type InternalContracts_TickSchedulerConfig as TickSchedulerConfig, InternalContracts___unsafeSetGlobalHostScheduler as __unsafeSetGlobalHostScheduler, InternalContracts_applyTransactionSnapshot as applyTransactionSnapshot, InternalContracts_controlProcessInstance as controlProcessInstance, InternalContracts_deliverProcessPlatformEvent as deliverProcessPlatformEvent, InternalContracts_execVmModeLayer as execVmModeLayer, InternalContracts_getHostScheduler as getHostScheduler, InternalContracts_getImportsScope as getImportsScope, InternalContracts_getProcessEvents as getProcessEvents, InternalContracts_getProcessInstallations as getProcessInstallations, InternalContracts_getProcessInstanceStatus as getProcessInstanceStatus, InternalContracts_getRowIdStore as getRowIdStore, InternalContracts_getRuntimeStore as getRuntimeStore, InternalContracts_getStateTraitListConfigs as getStateTraitListConfigs, InternalContracts_getStateTransactionInstrumentation as getStateTransactionInstrumentation, InternalContracts_hostSchedulerTestLayer as hostSchedulerTestLayer, InternalContracts_installProcess as installProcess, InternalContracts_makeDeterministicHostScheduler as makeDeterministicHostScheduler, InternalContracts_makeEnqueueTransaction as makeEnqueueTransaction, InternalContracts_normalizeFieldPath as normalizeFieldPath, InternalContracts_recordStatePatch as recordStatePatch, InternalContracts_registerStateTraitProgram as registerStateTraitProgram, InternalContracts_runWithStateTransaction as runWithStateTransaction, InternalContracts_tickSchedulerTestLayer as tickSchedulerTestLayer, InternalContracts_tickServicesLayer as tickServicesLayer, InternalContracts_withCurrentLinkId as withCurrentLinkId, InternalContracts_withExecVmMode as withExecVmMode };
 }
 
-export { ConcurrencyLimit, InternalContracts };
+export { ConcurrencyLimit, InternalContracts, StateCommitMeta, StateCommitPriority };

package/dist/index.d.ts

@@ -1,46 +1,164 @@
-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 { n as ActionSchemaOf, l as ActionTokenMap, m as ActionUnionOf, A as AnyModule, D as DevSource, H as HandleExtendFn, L as LogicUnitOptions, k as MakeExtendDef, p as Manage, M as Module, f as ModuleDef, c as ModuleDescriptor, a as ModuleDev, e as ModuleLogicApi, d as ModuleSelfHandleEffect, b as MountedLogicUnitSummary, R as Reducer, S as Shape, j as descriptor, h as hasImpl, i as is, o as make, g as unwrapImpl, u as unwrapTag } from './Module-CFj0I2yE.js';
+export { M as ModuleTag } from './ModuleTag-BcVF6z7B.js';
+import { S as StateCommitPriority, a as StateCommitMeta, C as ConcurrencyLimit, b as StateTransactionInstrumentation, c as StatePatchPath, P as PatchReason, D as DirtyAllReason, d as DirtySet, F as FieldPath, e as FieldPathId, n as normalizeFieldPath } from './module-DqQ1U-Me.js';
+export { w as ActionForTag, s as ActionOf, t as ActionsFromMap, j as AnyModuleShape, A as AnySchema, B as BoundApi, E as BoundApiDispatchApi, z as BoundApiDispatchersApi, G as BoundApiLifecycleApi, J as BoundApiReducerApi, x as BoundApiRootApi, y as BoundApiStateApi, I as BoundApiTraitsApi, H as BoundApiUseApi, g as ConcurrencyPolicy, h as ConcurrencyPolicyOverrides, i as ConcurrencyPolicyPatch, v as DispatchEffect, L as LogicEffect, q as ModuleHandle, m as ModuleImpl, l as ModuleLogic, o as ModuleRuntime, p as ModuleRuntimeOfShape, f as ModuleRuntimeTag, k as ModuleShape, M as ModuleTagType, u as MutatorsFromMap, R as ReducersFromMap, N as StateChangeWithMeta, K as StateCommitMode, r as StateOf } from './module-DqQ1U-Me.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 { L as Logic } from './Logic-OotSE1xw.js';
+export { B as Bound } from './Bound-CEa1ihvH.js';
+export { L as Link } from './Link-Cm4eR9n0.js';
+export { P as Process } from './Process-DvhFEwUS.js';
+export { H as Handle } from './Handle-B7PSmsrY.js';
+import { R as RuntimeInternalsResolvedConcurrencyPolicy, I as ImportsScope } from './Flow-CQSGve5c.js';
+export { F as Flow } from './Flow-CQSGve5c.js';
+export { W as Workflow } from './Workflow-CW9S_aAP.js';
+export { M as MatchBuilder } from './MatchBuilder-BNDJ8waF.js';
+export { R as ReadQuery } from './ReadQuery-C4vZ8Prc.js';
+export { E as ExternalStore } from './ExternalStore-BYWPbYs8.js';
+export { S as StateTrait } from './StateTrait-YvJzVDKl.js';
+export { T as TraitLifecycle } from './TraitLifecycle-CjIBICAA.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 { R as Runtime } from './Runtime-BWc9YfUB.js';
+export { K as Kernel } from './Kernel-DGSpS4GM.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 { 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-ByM7m4Ft.js';
+export { M as Middleware } from './Middleware-DS7CbTTN.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 { T as TriggerRef, B as BuildEnv, C as ConstructionGuard, R as ReplayLog, a as RuntimeHost } from './Observability-D-ZWeEVb.js';
+export { O as Observability } from './Observability-D-ZWeEVb.js';
+export { R as Reflection } from './Reflection-C8xZ267q.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 { Context, Effect, Stream, Scope, ManagedRuntime, Layer } from 'effect';
 import './action-DiMDD_0v.js';
 import 'mutative';
 import './Platform-C49Pv956.js';
-import './ReadQuery-SinbStGF.js';
-import './ir-DUOz6H-5.js';
+import './ReadQuery-CafjlJQo.js';
+import './ir-DGyGiwVe.js';
 import 'effect/Layer';
 import './EffectOp.js';
 import 'effect/Effect';
-import './Middleware.js';
 import 'effect/Context';
 import 'effect/FiberRef';
 
+type Cancel = () => void;
+type HostScheduler = {
+    readonly nowMs: () => number;
+    readonly scheduleMicrotask: (cb: () => void) => void;
+    readonly scheduleMacrotask: (cb: () => void) => Cancel;
+    readonly scheduleAnimationFrame: (cb: () => void) => Cancel;
+    readonly scheduleTimeout: (ms: number, cb: () => void) => Cancel;
+};
+type DeterministicHostScheduler = HostScheduler & {
+    readonly flushMicrotasks: (options?: {
+        readonly max?: number;
+    }) => number;
+    readonly flushOneMacrotask: () => boolean;
+    readonly flushAll: (options?: {
+        readonly maxTurns?: number;
+    }) => {
+        readonly turns: number;
+        readonly ran: number;
+    };
+    readonly getQueueSize: () => {
+        readonly microtasks: number;
+        readonly macrotasks: number;
+    };
+};
+
+type ModuleInstanceKey = `${string}::${string}`;
+type TopicKey = string;
+interface RuntimeStoreModuleCommit {
+    readonly moduleId: string;
+    readonly instanceId: string;
+    readonly moduleInstanceKey: ModuleInstanceKey;
+    readonly state: unknown;
+    readonly meta: StateCommitMeta;
+    readonly opSeq?: number;
+}
+interface RuntimeStorePendingDrain {
+    readonly modules: ReadonlyMap<ModuleInstanceKey, RuntimeStoreModuleCommit>;
+    readonly dirtyTopics: ReadonlyMap<TopicKey, StateCommitPriority>;
+}
+interface RuntimeStoreCommitResult {
+    readonly changedTopics: ReadonlyMap<TopicKey, {
+        readonly priority: StateCommitPriority;
+        readonly listeners: ReadonlyArray<() => void>;
+    }>;
+}
+interface RuntimeStore {
+    readonly getTickSeq: () => number;
+    readonly getModuleState: (moduleInstanceKey: ModuleInstanceKey) => unknown;
+    readonly getTopicVersion: (topicKey: TopicKey) => number;
+    readonly getTopicPriority: (topicKey: TopicKey) => StateCommitPriority;
+    readonly subscribeTopic: (topicKey: TopicKey, listener: () => void) => () => void;
+    readonly getTopicSubscriberCount: (topicKey: TopicKey) => number;
+    readonly getModuleSubscriberCount: (moduleInstanceKey: ModuleInstanceKey) => number;
+    readonly registerModuleInstance: (args: {
+        readonly moduleId: string;
+        readonly instanceId: string;
+        readonly moduleInstanceKey: ModuleInstanceKey;
+        readonly initialState: unknown;
+    }) => void;
+    readonly unregisterModuleInstance: (moduleInstanceKey: ModuleInstanceKey) => void;
+    readonly commitTick: (args: {
+        readonly tickSeq: number;
+        readonly accepted: RuntimeStorePendingDrain;
+    }) => RuntimeStoreCommitResult;
+    readonly dispose: () => void;
+}
+
+type TickDegradeReason = 'budget_steps' | 'cycle_detected' | 'unknown';
+interface TickSchedulerConfig {
+    /**
+     * Fixpoint step cap:
+     * - Steps count "work acceptance units" within a single tick, not time.
+     * - Exceeding the budget triggers a soft degrade (stable=false), deferring nonUrgent backlog to the next tick.
+     */
+    readonly maxSteps?: number;
+    /**
+     * Urgent safety cap:
+     * - Even urgent work may be cut when the system appears to be in a cycle (avoid freezing).
+     */
+    readonly urgentStepCap?: number;
+    /**
+     * Drain-round cap:
+     * - Bounds the number of drain rounds while capturing concurrent commits before committing the tick snapshot.
+     * - Exceeding the cap is treated as a cycle (stable=false, degradeReason=cycle_detected).
+     */
+    readonly maxDrainRounds?: number;
+    /**
+     * Microtask starvation protection threshold:
+     * - Counts consecutive ticks scheduled on microtask boundaries without yielding to host (best-effort).
+     * - Exceeding the limit forces the next tick to start on a macrotask boundary.
+     */
+    readonly microtaskChainDepthLimit?: number;
+    /**
+     * Optional degraded-tick telemetry (opt-in, sampled):
+     * - Runs even when diagnostics=off (Devtools disabled).
+     * - Intended for production health signals (frequency of stable=false / forced yield).
+     */
+    readonly telemetry?: TickSchedulerTelemetryConfig;
+}
+interface TickSchedulerTelemetryEvent {
+    readonly tickSeq: number;
+    readonly stable: boolean;
+    readonly degradeReason?: TickDegradeReason;
+    readonly forcedMacrotask?: boolean;
+    readonly scheduleReason?: TickScheduleReason;
+    readonly microtaskChainDepth?: number;
+    readonly deferredWorkCount?: number;
+}
+interface TickSchedulerTelemetryConfig {
+    /** Sample rate in [0, 1]. Default: 0 (disabled). */
+    readonly sampleRate?: number;
+    /** Called for ticks that are degraded (stable=false) and/or started on a forced macrotask boundary. */
+    readonly onTickDegraded?: (event: TickSchedulerTelemetryEvent) => void;
+}
+type TickScheduleReason = 'budget' | 'cycle_detected' | 'microtask_starvation' | 'unknown';
+
 type ProcessInstallMode = 'switch' | 'exhaust';
 interface ProcessRuntime {
     readonly install: <E, R>(process: Effect.Effect<void, E, R>, options: {
@@ -128,6 +246,14 @@ declare const makeEnqueueTransaction: (args: {
  * - Exposes only minimal capabilities (ISP) to avoid leaking RuntimeInternals as a public dependency.
  */
 declare const getImportsScope: (runtime: object) => ImportsScope;
+declare const getRuntimeStore: (runtime: ManagedRuntime.ManagedRuntime<any, any>) => RuntimeStore;
+declare const getHostScheduler: (runtime: ManagedRuntime.ManagedRuntime<any, any>) => HostScheduler;
+
+declare const makeDeterministicHostScheduler: () => DeterministicHostScheduler;
+declare const hostSchedulerTestLayer: (scheduler: HostScheduler) => Layer.Layer<any, never, never>;
+declare const tickSchedulerTestLayer: (config?: TickSchedulerConfig) => Layer.Layer<any, never, never>;
+declare const __unsafeSetGlobalHostScheduler: (next: HostScheduler | undefined) => void;
+declare const tickServicesLayer: Layer.Layer<any, never, never>;
 declare const getStateTransactionInstrumentation: (runtime: object) => StateTransactionInstrumentation;
 declare const getRowIdStore: (runtime: object) => unknown;
 declare const getStateTraitListConfigs: (runtime: object) => ReadonlyArray<unknown>;
@@ -163,33 +289,43 @@ declare const installProcess: <E, R>(process: Effect.Effect<void, E, R>, options
 
 declare const InternalContracts_BuildEnv: typeof BuildEnv;
 declare const InternalContracts_ConstructionGuard: typeof ConstructionGuard;
+type InternalContracts_DeterministicHostScheduler = DeterministicHostScheduler;
 declare const InternalContracts_DirtyAllReason: typeof DirtyAllReason;
 declare const InternalContracts_DirtySet: typeof DirtySet;
 declare const InternalContracts_FieldPath: typeof FieldPath;
 declare const InternalContracts_FieldPathId: typeof FieldPathId;
+type InternalContracts_HostScheduler = HostScheduler;
 declare const InternalContracts_ReplayLog: typeof ReplayLog;
 declare const InternalContracts_RuntimeHost: typeof RuntimeHost;
+type InternalContracts_TickSchedulerConfig = TickSchedulerConfig;
+declare const InternalContracts___unsafeSetGlobalHostScheduler: typeof __unsafeSetGlobalHostScheduler;
 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_getHostScheduler: typeof getHostScheduler;
 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_getRuntimeStore: typeof getRuntimeStore;
 declare const InternalContracts_getStateTraitListConfigs: typeof getStateTraitListConfigs;
 declare const InternalContracts_getStateTransactionInstrumentation: typeof getStateTransactionInstrumentation;
+declare const InternalContracts_hostSchedulerTestLayer: typeof hostSchedulerTestLayer;
 declare const InternalContracts_installProcess: typeof installProcess;
+declare const InternalContracts_makeDeterministicHostScheduler: typeof makeDeterministicHostScheduler;
 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_tickSchedulerTestLayer: typeof tickSchedulerTestLayer;
+declare const InternalContracts_tickServicesLayer: typeof tickServicesLayer;
 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 { InternalContracts_BuildEnv as BuildEnv, InternalContracts_ConstructionGuard as ConstructionGuard, type InternalContracts_DeterministicHostScheduler as DeterministicHostScheduler, InternalContracts_DirtyAllReason as DirtyAllReason, InternalContracts_DirtySet as DirtySet, InternalContracts_FieldPath as FieldPath, InternalContracts_FieldPathId as FieldPathId, type InternalContracts_HostScheduler as HostScheduler, InternalContracts_ReplayLog as ReplayLog, InternalContracts_RuntimeHost as RuntimeHost, type InternalContracts_TickSchedulerConfig as TickSchedulerConfig, InternalContracts___unsafeSetGlobalHostScheduler as __unsafeSetGlobalHostScheduler, InternalContracts_applyTransactionSnapshot as applyTransactionSnapshot, InternalContracts_controlProcessInstance as controlProcessInstance, InternalContracts_deliverProcessPlatformEvent as deliverProcessPlatformEvent, InternalContracts_execVmModeLayer as execVmModeLayer, InternalContracts_getHostScheduler as getHostScheduler, InternalContracts_getImportsScope as getImportsScope, InternalContracts_getProcessEvents as getProcessEvents, InternalContracts_getProcessInstallations as getProcessInstallations, InternalContracts_getProcessInstanceStatus as getProcessInstanceStatus, InternalContracts_getRowIdStore as getRowIdStore, InternalContracts_getRuntimeStore as getRuntimeStore, InternalContracts_getStateTraitListConfigs as getStateTraitListConfigs, InternalContracts_getStateTransactionInstrumentation as getStateTransactionInstrumentation, InternalContracts_hostSchedulerTestLayer as hostSchedulerTestLayer, InternalContracts_installProcess as installProcess, InternalContracts_makeDeterministicHostScheduler as makeDeterministicHostScheduler, InternalContracts_makeEnqueueTransaction as makeEnqueueTransaction, InternalContracts_normalizeFieldPath as normalizeFieldPath, InternalContracts_recordStatePatch as recordStatePatch, InternalContracts_registerStateTraitProgram as registerStateTraitProgram, InternalContracts_runWithStateTransaction as runWithStateTransaction, InternalContracts_tickSchedulerTestLayer as tickSchedulerTestLayer, InternalContracts_tickServicesLayer as tickServicesLayer, InternalContracts_withCurrentLinkId as withCurrentLinkId, InternalContracts_withExecVmMode as withExecVmMode };
 }
 
-export { ConcurrencyLimit, InternalContracts };
+export { ConcurrencyLimit, InternalContracts, StateCommitMeta, StateCommitPriority };