@logixjs/core 0.0.1 → 1.0.0

package/dist/Root.js

@@ -1,9 +1,13 @@
 import {
   layerFromContext,
   resolve
-} from "./chunk-G5ZBFPNU.js";
-import "./chunk-AUIR5O6W.js";
-import "./chunk-3QMIVH35.js";
+} from "./chunk-A2RQOJC7.js";
+import "./chunk-AFSB6NKM.js";
+import "./chunk-YZDJMAKL.js";
+import "./chunk-S4S5N4BJ.js";
+import "./chunk-MYKNINNN.js";
+import "./chunk-V2SBGVDO.js";
+import "./chunk-LPPZDFTD.js";
 import "./chunk-PZ5AY32C.js";
 export {
   layerFromContext,

package/dist/{Runtime-CtyzZG4i.d.ts → Runtime-CRmvwK4I.d.ts}

@@ -1,14 +1,14 @@
 import * as effect from 'effect';
 import { Scope, ManagedRuntime, Layer, Effect } from 'effect';
-import { h as AnyModuleShape, l as ModuleRuntime, o as StateOf, p as ActionOf, B as BoundApi, S as StateTransactionInstrumentation, H as TraitConvergeTimeSlicingPatch, I as TxnLanesPatch, J as StateTransactionTraitConvergeOverrides, e as ConcurrencyPolicy, k as ModuleImpl, K as StateTransactionOverrides, f as ConcurrencyPolicyOverrides, g as ConcurrencyPolicyPatch } from './module-k7m3txak.js';
-import { A as AnyModule } from './Module-DnzluX2J.js';
-import { z as DebugLayerOptions, b as DiagnosticsLevel, T as TraitConvergeDiagnosticsSamplingConfig } from './Debug-B5q5Bkzx.js';
+import { o as AnyModuleShape, s as ModuleRuntime, v as StateOf, w as ActionOf, B as BoundApi, c as StateTransactionInstrumentation, a1 as TraitConvergeTimeSlicingPatch, a2 as TxnLanesPatch, a3 as StateTransactionTraitConvergeOverrides, h as SchedulingPolicySurface, k as ConcurrencyPolicy, r as ModuleImpl, a4 as StateTransactionOverrides, i as SchedulingPolicySurfaceOverrides, l as ConcurrencyPolicyOverrides, j as SchedulingPolicySurfacePatch, m as ConcurrencyPolicyPatch } from './module-Zd1Gn-Nj.js';
+import { A as AnyModule } from './Module-B_Cntyms.js';
+import { G as DebugLayerOptions, b as DiagnosticsLevel, d as TraitConvergeDiagnosticsSamplingConfig, T as TraceMode } from './Debug-DKrWP5H1.js';
 import { MiddlewareStack } from './EffectOp.js';
-import { g as ReadQueryFallbackReason$1 } from './ReadQuery-SinbStGF.js';
-import { DebugObserverConfig } from './Middleware.js';
+import { n as ReadQueryFallbackReason$1 } from './ReadQuery-DXLzCE0E.js';
+import { D as DebugObserverConfig } from './Middleware-DS7CbTTN.js';
 
 interface ProgramRunContext<Sh extends AnyModuleShape> {
-    readonly scope: Scope.CloseableScope;
+    readonly scope: Scope.Closeable;
     readonly runtime: ManagedRuntime.ManagedRuntime<any, never>;
     readonly module: ModuleRuntime<StateOf<Sh>, ActionOf<Sh>>;
     readonly $: BoundApi<Sh, never>;
@@ -81,6 +81,14 @@ interface RunProgramOptions<Args = unknown> extends OpenProgramOptions {
     readonly exitCode?: boolean;
     readonly reportError?: boolean;
 }
+type HostSchedulerCancel = () => void;
+type HostScheduler = {
+    readonly nowMs: () => number;
+    readonly scheduleMicrotask: (cb: () => void) => void;
+    readonly scheduleMacrotask: (cb: () => void) => HostSchedulerCancel;
+    readonly scheduleAnimationFrame: (cb: () => void) => HostSchedulerCancel;
+    readonly scheduleTimeout: (ms: number, cb: () => void) => HostSchedulerCancel;
+};
 /**
  * Runtime-level StateTransaction defaults.
  *
@@ -106,6 +114,9 @@ interface RuntimeReadQueryStrictGateOptions {
      * - `off`: disabled (default).
      * - `warn`: allow but emit structured diagnostics.
      * - `error`: fail on forbidden fallbacks (CI/perf gate).
+     *
+     * O-009: runtime only consumes build-graded selectors.
+     * This gate applies to explicit runtime fallback paths (e.g. missing build grade), not to re-evaluate graded selectors.
      */
     readonly mode?: 'off' | 'warn' | 'error';
     /**
@@ -132,6 +143,17 @@ interface RuntimeOptions {
      * Optional runtime label (e.g. `AppDemoRuntime`) for Debug / DevTools grouping.
      */
     readonly label?: string;
+    /**
+     * Optional HostScheduler override for this Runtime.
+     *
+     * Use it when you need deterministic host scheduling (tests) or a custom host integration.
+     *
+     * NOTE:
+     * - TickScheduler captures HostScheduler at Layer build-time (073); overriding HostScheduler via `options.layer`
+     *   is not sufficient unless the dependent layer is built under that override.
+     * - This option avoids the pitfall by injecting HostScheduler into the runtime tick services build pipeline.
+     */
+    readonly hostScheduler?: HostScheduler;
     /**
      * Optional Debug console output configuration.
      *
@@ -157,9 +179,15 @@ interface RuntimeOptions {
      */
     readonly stateTransaction?: RuntimeStateTransactionOptions;
     /**
-     * Runtime-level concurrency control plane.
+     * Runtime-level unified scheduling policy surface.
      *
-     * Converges unbounded concurrency into bounded (default 16), with module/provider overrides.
+     * Converges queue/tick/concurrency knobs into one policy contract (default limit=16 with bounded fallback).
+     */
+    readonly schedulingPolicy?: SchedulingPolicySurface;
+    /**
+     * Legacy alias of `schedulingPolicy` (phase-1 migration path).
+     *
+     * If both are provided, `schedulingPolicy` wins.
      */
     readonly concurrencyPolicy?: ConcurrencyPolicy;
     /**
@@ -174,6 +202,8 @@ interface DevtoolsRuntimeOptions {
      * Diagnostics level for exportable Devtools events.
      *
      * Forwarded to `Debug.devtoolsHubLayer({ diagnosticsLevel })`.
+     * When explicitly set to `"off"`, `Runtime.make` enters a vacuum path:
+     * it skips both DevtoolsHub sink mounting and DebugObserver middleware wiring.
      * Default: `"light"`.
      */
     readonly diagnosticsLevel?: DiagnosticsLevel;
@@ -185,6 +215,7 @@ interface DevtoolsRuntimeOptions {
     readonly traitConvergeDiagnosticsSampling?: TraitConvergeDiagnosticsSamplingConfig;
     /** DebugObserver config for `trace:effectop`; undefined means full observation. */
     readonly observer?: DebugObserverConfig | false;
+    readonly traceMode?: TraceMode;
     /** Reserved: React render sampling / throttling config (consumed by `@logixjs/react`). */
     readonly sampling?: {
         readonly reactRenderSampleRate?: number;
@@ -198,6 +229,16 @@ interface DevtoolsRuntimeOptions {
  * - Exposes a ManagedRuntime; the full Env is provided by `root.layer + options.layer`.
  */
 declare const make: (root: ModuleImpl<any, AnyModuleShape, any> | AnyModule, options?: RuntimeOptions) => ManagedRuntime.ManagedRuntime<any, never>;
+/**
+ * Runtime.batch：
+ * - Provides a stronger "tick boundary" for RuntimeStore/TickScheduler than the default microtask boundary.
+ * - Sync-only: nested batches flatten; only the outermost batch triggers the flush boundary.
+ * - NOT a transaction: no rollback; errors may result in partial commits, but the flush boundary is still released in finally.
+ *
+ * WARNING:
+ * - Do not `await` inside the batch callback expecting mid-flush; batch only establishes a synchronous boundary.
+ */
+declare const batch: <A>(fn: () => A) => A;
 /**
  * Resourceful entry: returns a scope-bound ProgramRunContext (booted and ready).
  */
@@ -213,23 +254,35 @@ declare const runProgram: <Sh extends AnyModuleShape, Args, A, E, R>(root: Modul
  */
 declare const stateTransactionOverridesLayer: (overrides: StateTransactionOverrides) => Layer.Layer<any, never, never>;
 /**
- * Provider-scoped ConcurrencyPolicyOverrides layer.
+ * Provider-scoped SchedulingPolicySurfaceOverrides layer.
  *
  * Use it to apply local overrides on top of the `runtime_default` baseline.
  */
+declare const schedulingPolicyOverridesLayer: (overrides: SchedulingPolicySurfaceOverrides) => Layer.Layer<any, never, never>;
+/**
+ * Legacy alias: provider-scoped ConcurrencyPolicyOverrides layer.
+ *
+ * Kept for phase-1 migration. Internally it is the same scheduling policy surface override layer.
+ */
 declare const concurrencyPolicyOverridesLayer: (overrides: ConcurrencyPolicyOverrides) => Layer.Layer<any, never, never>;
 /**
  * Hot-switch Trait converge overrides for a moduleId.
  *
  * This mutates the `runtime_module` patch map only; provider overrides still take precedence.
  */
-declare const setTraitConvergeOverride: (runtime: ManagedRuntime.ManagedRuntime<any, never>, moduleId: string, overrides: StateTransactionTraitConvergeOverrides | undefined) => void;
+declare const setTraitConvergeOverride: (runtime: ManagedRuntime.ManagedRuntime<any, never>, moduleId: string, overrides: StateTransactionTraitConvergeOverrides | undefined) => Effect.Effect<void, never, never>;
 /**
- * Hot-switch ConcurrencyPolicy patch for a moduleId.
+ * Hot-switch SchedulingPolicySurface patch for a moduleId.
  *
  * This mutates the `runtime_module` patch map only; provider overrides still take precedence.
  */
-declare const setConcurrencyPolicyOverride: (runtime: ManagedRuntime.ManagedRuntime<any, never>, moduleId: string, patch: ConcurrencyPolicyPatch | undefined) => void;
+declare const setSchedulingPolicyOverride: (runtime: ManagedRuntime.ManagedRuntime<any, never>, moduleId: string, patch: SchedulingPolicySurfacePatch | undefined) => Effect.Effect<void, never, never>;
+/**
+ * Legacy alias: hot-switch ConcurrencyPolicy patch for a moduleId.
+ *
+ * Kept for phase-1 migration. Internally routes to scheduling policy surface override.
+ */
+declare const setConcurrencyPolicyOverride: (runtime: ManagedRuntime.ManagedRuntime<any, never>, moduleId: string, patch: ConcurrencyPolicyPatch | undefined) => Effect.Effect<void, never, never>;
 /**
  * Apply a transaction snapshot for time-travel replay (dev/test).
  *
@@ -260,15 +313,18 @@ type Runtime_RuntimeReadQueryOptions = RuntimeReadQueryOptions;
 type Runtime_RuntimeReadQueryStrictGateOptions = RuntimeReadQueryStrictGateOptions;
 type Runtime_RuntimeStateTransactionOptions = RuntimeStateTransactionOptions;
 declare const Runtime_applyTransactionSnapshot: typeof applyTransactionSnapshot;
+declare const Runtime_batch: typeof batch;
 declare const Runtime_concurrencyPolicyOverridesLayer: typeof concurrencyPolicyOverridesLayer;
 declare const Runtime_make: typeof make;
 declare const Runtime_openProgram: typeof openProgram;
 declare const Runtime_runProgram: typeof runProgram;
+declare const Runtime_schedulingPolicyOverridesLayer: typeof schedulingPolicyOverridesLayer;
 declare const Runtime_setConcurrencyPolicyOverride: typeof setConcurrencyPolicyOverride;
+declare const Runtime_setSchedulingPolicyOverride: typeof setSchedulingPolicyOverride;
 declare const Runtime_setTraitConvergeOverride: typeof setTraitConvergeOverride;
 declare const Runtime_stateTransactionOverridesLayer: typeof stateTransactionOverridesLayer;
 declare namespace Runtime {
-  export { Runtime_BootError as BootError, type Runtime_DevtoolsRuntimeOptions as DevtoolsRuntimeOptions, Runtime_DisposeError as DisposeError, Runtime_DisposeTimeoutError as DisposeTimeoutError, Runtime_MainError as MainError, type Runtime_OpenProgramOptions as OpenProgramOptions, type Runtime_ProgramIdentity as ProgramIdentity, type Runtime_ProgramRunContext as ProgramRunContext, type Runtime_ProgramRunnerErrorTag as ProgramRunnerErrorTag, type Runtime_ReadQueryFallbackReason as ReadQueryFallbackReason, type Runtime_RunProgramOptions as RunProgramOptions, type Runtime_RuntimeOptions as RuntimeOptions, type Runtime_RuntimeReadQueryOptions as RuntimeReadQueryOptions, type Runtime_RuntimeReadQueryStrictGateOptions as RuntimeReadQueryStrictGateOptions, type Runtime_RuntimeStateTransactionOptions as RuntimeStateTransactionOptions, Runtime_applyTransactionSnapshot as applyTransactionSnapshot, Runtime_concurrencyPolicyOverridesLayer as concurrencyPolicyOverridesLayer, Runtime_make as make, Runtime_openProgram as openProgram, Runtime_runProgram as runProgram, Runtime_setConcurrencyPolicyOverride as setConcurrencyPolicyOverride, Runtime_setTraitConvergeOverride as setTraitConvergeOverride, Runtime_stateTransactionOverridesLayer as stateTransactionOverridesLayer };
+  export { Runtime_BootError as BootError, type Runtime_DevtoolsRuntimeOptions as DevtoolsRuntimeOptions, Runtime_DisposeError as DisposeError, Runtime_DisposeTimeoutError as DisposeTimeoutError, Runtime_MainError as MainError, type Runtime_OpenProgramOptions as OpenProgramOptions, type Runtime_ProgramIdentity as ProgramIdentity, type Runtime_ProgramRunContext as ProgramRunContext, type Runtime_ProgramRunnerErrorTag as ProgramRunnerErrorTag, type Runtime_ReadQueryFallbackReason as ReadQueryFallbackReason, type Runtime_RunProgramOptions as RunProgramOptions, type Runtime_RuntimeOptions as RuntimeOptions, type Runtime_RuntimeReadQueryOptions as RuntimeReadQueryOptions, type Runtime_RuntimeReadQueryStrictGateOptions as RuntimeReadQueryStrictGateOptions, type Runtime_RuntimeStateTransactionOptions as RuntimeStateTransactionOptions, Runtime_applyTransactionSnapshot as applyTransactionSnapshot, Runtime_batch as batch, Runtime_concurrencyPolicyOverridesLayer as concurrencyPolicyOverridesLayer, Runtime_make as make, Runtime_openProgram as openProgram, Runtime_runProgram as runProgram, Runtime_schedulingPolicyOverridesLayer as schedulingPolicyOverridesLayer, Runtime_setConcurrencyPolicyOverride as setConcurrencyPolicyOverride, Runtime_setSchedulingPolicyOverride as setSchedulingPolicyOverride, Runtime_setTraitConvergeOverride as setTraitConvergeOverride, Runtime_stateTransactionOverridesLayer as stateTransactionOverridesLayer };
 }
 
-export { BootError as B, type DevtoolsRuntimeOptions as D, MainError as M, type OpenProgramOptions as O, type ProgramRunContext as P, Runtime as R, type RunProgramOptions as a, type RuntimeStateTransactionOptions as b, type ReadQueryFallbackReason as c, type RuntimeReadQueryStrictGateOptions as d, type RuntimeReadQueryOptions as e, type RuntimeOptions as f, concurrencyPolicyOverridesLayer as g, setTraitConvergeOverride as h, setConcurrencyPolicyOverride as i, applyTransactionSnapshot as j, DisposeError as k, DisposeTimeoutError as l, make as m, type ProgramIdentity as n, openProgram as o, type ProgramRunnerErrorTag as p, runProgram as r, stateTransactionOverridesLayer as s };
+export { BootError as B, type DevtoolsRuntimeOptions as D, MainError as M, type OpenProgramOptions as O, type ProgramRunContext as P, Runtime as R, type RunProgramOptions as a, type RuntimeStateTransactionOptions as b, type ReadQueryFallbackReason as c, type RuntimeReadQueryStrictGateOptions as d, type RuntimeReadQueryOptions as e, type RuntimeOptions as f, batch as g, schedulingPolicyOverridesLayer as h, concurrencyPolicyOverridesLayer as i, setTraitConvergeOverride as j, setSchedulingPolicyOverride as k, setConcurrencyPolicyOverride as l, make as m, applyTransactionSnapshot as n, openProgram as o, DisposeError as p, DisposeTimeoutError as q, runProgram as r, stateTransactionOverridesLayer as s, type ProgramIdentity as t, type ProgramRunnerErrorTag as u };

package/dist/{Runtime-B-aL-f29.d.cts → Runtime-C_wJM9mN.d.cts}

@@ -1,14 +1,14 @@
 import * as effect from 'effect';
 import { Scope, ManagedRuntime, Layer, Effect } from 'effect';
-import { h as AnyModuleShape, l as ModuleRuntime, o as StateOf, p as ActionOf, B as BoundApi, S as StateTransactionInstrumentation, H as TraitConvergeTimeSlicingPatch, I as TxnLanesPatch, J as StateTransactionTraitConvergeOverrides, e as ConcurrencyPolicy, k as ModuleImpl, K as StateTransactionOverrides, f as ConcurrencyPolicyOverrides, g as ConcurrencyPolicyPatch } from './module-B8CBqIZ_.cjs';
-import { A as AnyModule } from './Module-B_0xRDMR.cjs';
-import { z as DebugLayerOptions, b as DiagnosticsLevel, T as TraitConvergeDiagnosticsSamplingConfig } from './Debug-Bq8Sqjcr.cjs';
+import { o as AnyModuleShape, s as ModuleRuntime, v as StateOf, w as ActionOf, B as BoundApi, c as StateTransactionInstrumentation, a1 as TraitConvergeTimeSlicingPatch, a2 as TxnLanesPatch, a3 as StateTransactionTraitConvergeOverrides, h as SchedulingPolicySurface, k as ConcurrencyPolicy, r as ModuleImpl, a4 as StateTransactionOverrides, i as SchedulingPolicySurfaceOverrides, l as ConcurrencyPolicyOverrides, j as SchedulingPolicySurfacePatch, m as ConcurrencyPolicyPatch } from './module-Ds4tarcI.cjs';
+import { A as AnyModule } from './Module-CmNOVXzf.cjs';
+import { G as DebugLayerOptions, b as DiagnosticsLevel, d as TraitConvergeDiagnosticsSamplingConfig, T as TraceMode } from './Debug-hIT44XsY.cjs';
 import { MiddlewareStack } from './EffectOp.cjs';
-import { g as ReadQueryFallbackReason$1 } from './ReadQuery-SinbStGF.cjs';
-import { DebugObserverConfig } from './Middleware.cjs';
+import { n as ReadQueryFallbackReason$1 } from './ReadQuery-DXLzCE0E.cjs';
+import { D as DebugObserverConfig } from './Middleware-D8tUDLv_.cjs';
 
 interface ProgramRunContext<Sh extends AnyModuleShape> {
-    readonly scope: Scope.CloseableScope;
+    readonly scope: Scope.Closeable;
     readonly runtime: ManagedRuntime.ManagedRuntime<any, never>;
     readonly module: ModuleRuntime<StateOf<Sh>, ActionOf<Sh>>;
     readonly $: BoundApi<Sh, never>;
@@ -81,6 +81,14 @@ interface RunProgramOptions<Args = unknown> extends OpenProgramOptions {
     readonly exitCode?: boolean;
     readonly reportError?: boolean;
 }
+type HostSchedulerCancel = () => void;
+type HostScheduler = {
+    readonly nowMs: () => number;
+    readonly scheduleMicrotask: (cb: () => void) => void;
+    readonly scheduleMacrotask: (cb: () => void) => HostSchedulerCancel;
+    readonly scheduleAnimationFrame: (cb: () => void) => HostSchedulerCancel;
+    readonly scheduleTimeout: (ms: number, cb: () => void) => HostSchedulerCancel;
+};
 /**
  * Runtime-level StateTransaction defaults.
  *
@@ -106,6 +114,9 @@ interface RuntimeReadQueryStrictGateOptions {
      * - `off`: disabled (default).
      * - `warn`: allow but emit structured diagnostics.
      * - `error`: fail on forbidden fallbacks (CI/perf gate).
+     *
+     * O-009: runtime only consumes build-graded selectors.
+     * This gate applies to explicit runtime fallback paths (e.g. missing build grade), not to re-evaluate graded selectors.
      */
     readonly mode?: 'off' | 'warn' | 'error';
     /**
@@ -132,6 +143,17 @@ interface RuntimeOptions {
      * Optional runtime label (e.g. `AppDemoRuntime`) for Debug / DevTools grouping.
      */
     readonly label?: string;
+    /**
+     * Optional HostScheduler override for this Runtime.
+     *
+     * Use it when you need deterministic host scheduling (tests) or a custom host integration.
+     *
+     * NOTE:
+     * - TickScheduler captures HostScheduler at Layer build-time (073); overriding HostScheduler via `options.layer`
+     *   is not sufficient unless the dependent layer is built under that override.
+     * - This option avoids the pitfall by injecting HostScheduler into the runtime tick services build pipeline.
+     */
+    readonly hostScheduler?: HostScheduler;
     /**
      * Optional Debug console output configuration.
      *
@@ -157,9 +179,15 @@ interface RuntimeOptions {
      */
     readonly stateTransaction?: RuntimeStateTransactionOptions;
     /**
-     * Runtime-level concurrency control plane.
+     * Runtime-level unified scheduling policy surface.
      *
-     * Converges unbounded concurrency into bounded (default 16), with module/provider overrides.
+     * Converges queue/tick/concurrency knobs into one policy contract (default limit=16 with bounded fallback).
+     */
+    readonly schedulingPolicy?: SchedulingPolicySurface;
+    /**
+     * Legacy alias of `schedulingPolicy` (phase-1 migration path).
+     *
+     * If both are provided, `schedulingPolicy` wins.
      */
     readonly concurrencyPolicy?: ConcurrencyPolicy;
     /**
@@ -174,6 +202,8 @@ interface DevtoolsRuntimeOptions {
      * Diagnostics level for exportable Devtools events.
      *
      * Forwarded to `Debug.devtoolsHubLayer({ diagnosticsLevel })`.
+     * When explicitly set to `"off"`, `Runtime.make` enters a vacuum path:
+     * it skips both DevtoolsHub sink mounting and DebugObserver middleware wiring.
      * Default: `"light"`.
      */
     readonly diagnosticsLevel?: DiagnosticsLevel;
@@ -185,6 +215,7 @@ interface DevtoolsRuntimeOptions {
     readonly traitConvergeDiagnosticsSampling?: TraitConvergeDiagnosticsSamplingConfig;
     /** DebugObserver config for `trace:effectop`; undefined means full observation. */
     readonly observer?: DebugObserverConfig | false;
+    readonly traceMode?: TraceMode;
     /** Reserved: React render sampling / throttling config (consumed by `@logixjs/react`). */
     readonly sampling?: {
         readonly reactRenderSampleRate?: number;
@@ -198,6 +229,16 @@ interface DevtoolsRuntimeOptions {
  * - Exposes a ManagedRuntime; the full Env is provided by `root.layer + options.layer`.
  */
 declare const make: (root: ModuleImpl<any, AnyModuleShape, any> | AnyModule, options?: RuntimeOptions) => ManagedRuntime.ManagedRuntime<any, never>;
+/**
+ * Runtime.batch：
+ * - Provides a stronger "tick boundary" for RuntimeStore/TickScheduler than the default microtask boundary.
+ * - Sync-only: nested batches flatten; only the outermost batch triggers the flush boundary.
+ * - NOT a transaction: no rollback; errors may result in partial commits, but the flush boundary is still released in finally.
+ *
+ * WARNING:
+ * - Do not `await` inside the batch callback expecting mid-flush; batch only establishes a synchronous boundary.
+ */
+declare const batch: <A>(fn: () => A) => A;
 /**
  * Resourceful entry: returns a scope-bound ProgramRunContext (booted and ready).
  */
@@ -213,23 +254,35 @@ declare const runProgram: <Sh extends AnyModuleShape, Args, A, E, R>(root: Modul
  */
 declare const stateTransactionOverridesLayer: (overrides: StateTransactionOverrides) => Layer.Layer<any, never, never>;
 /**
- * Provider-scoped ConcurrencyPolicyOverrides layer.
+ * Provider-scoped SchedulingPolicySurfaceOverrides layer.
  *
  * Use it to apply local overrides on top of the `runtime_default` baseline.
  */
+declare const schedulingPolicyOverridesLayer: (overrides: SchedulingPolicySurfaceOverrides) => Layer.Layer<any, never, never>;
+/**
+ * Legacy alias: provider-scoped ConcurrencyPolicyOverrides layer.
+ *
+ * Kept for phase-1 migration. Internally it is the same scheduling policy surface override layer.
+ */
 declare const concurrencyPolicyOverridesLayer: (overrides: ConcurrencyPolicyOverrides) => Layer.Layer<any, never, never>;
 /**
  * Hot-switch Trait converge overrides for a moduleId.
  *
  * This mutates the `runtime_module` patch map only; provider overrides still take precedence.
  */
-declare const setTraitConvergeOverride: (runtime: ManagedRuntime.ManagedRuntime<any, never>, moduleId: string, overrides: StateTransactionTraitConvergeOverrides | undefined) => void;
+declare const setTraitConvergeOverride: (runtime: ManagedRuntime.ManagedRuntime<any, never>, moduleId: string, overrides: StateTransactionTraitConvergeOverrides | undefined) => Effect.Effect<void, never, never>;
 /**
- * Hot-switch ConcurrencyPolicy patch for a moduleId.
+ * Hot-switch SchedulingPolicySurface patch for a moduleId.
  *
  * This mutates the `runtime_module` patch map only; provider overrides still take precedence.
  */
-declare const setConcurrencyPolicyOverride: (runtime: ManagedRuntime.ManagedRuntime<any, never>, moduleId: string, patch: ConcurrencyPolicyPatch | undefined) => void;
+declare const setSchedulingPolicyOverride: (runtime: ManagedRuntime.ManagedRuntime<any, never>, moduleId: string, patch: SchedulingPolicySurfacePatch | undefined) => Effect.Effect<void, never, never>;
+/**
+ * Legacy alias: hot-switch ConcurrencyPolicy patch for a moduleId.
+ *
+ * Kept for phase-1 migration. Internally routes to scheduling policy surface override.
+ */
+declare const setConcurrencyPolicyOverride: (runtime: ManagedRuntime.ManagedRuntime<any, never>, moduleId: string, patch: ConcurrencyPolicyPatch | undefined) => Effect.Effect<void, never, never>;
 /**
  * Apply a transaction snapshot for time-travel replay (dev/test).
  *
@@ -260,15 +313,18 @@ type Runtime_RuntimeReadQueryOptions = RuntimeReadQueryOptions;
 type Runtime_RuntimeReadQueryStrictGateOptions = RuntimeReadQueryStrictGateOptions;
 type Runtime_RuntimeStateTransactionOptions = RuntimeStateTransactionOptions;
 declare const Runtime_applyTransactionSnapshot: typeof applyTransactionSnapshot;
+declare const Runtime_batch: typeof batch;
 declare const Runtime_concurrencyPolicyOverridesLayer: typeof concurrencyPolicyOverridesLayer;
 declare const Runtime_make: typeof make;
 declare const Runtime_openProgram: typeof openProgram;
 declare const Runtime_runProgram: typeof runProgram;
+declare const Runtime_schedulingPolicyOverridesLayer: typeof schedulingPolicyOverridesLayer;
 declare const Runtime_setConcurrencyPolicyOverride: typeof setConcurrencyPolicyOverride;
+declare const Runtime_setSchedulingPolicyOverride: typeof setSchedulingPolicyOverride;
 declare const Runtime_setTraitConvergeOverride: typeof setTraitConvergeOverride;
 declare const Runtime_stateTransactionOverridesLayer: typeof stateTransactionOverridesLayer;
 declare namespace Runtime {
-  export { Runtime_BootError as BootError, type Runtime_DevtoolsRuntimeOptions as DevtoolsRuntimeOptions, Runtime_DisposeError as DisposeError, Runtime_DisposeTimeoutError as DisposeTimeoutError, Runtime_MainError as MainError, type Runtime_OpenProgramOptions as OpenProgramOptions, type Runtime_ProgramIdentity as ProgramIdentity, type Runtime_ProgramRunContext as ProgramRunContext, type Runtime_ProgramRunnerErrorTag as ProgramRunnerErrorTag, type Runtime_ReadQueryFallbackReason as ReadQueryFallbackReason, type Runtime_RunProgramOptions as RunProgramOptions, type Runtime_RuntimeOptions as RuntimeOptions, type Runtime_RuntimeReadQueryOptions as RuntimeReadQueryOptions, type Runtime_RuntimeReadQueryStrictGateOptions as RuntimeReadQueryStrictGateOptions, type Runtime_RuntimeStateTransactionOptions as RuntimeStateTransactionOptions, Runtime_applyTransactionSnapshot as applyTransactionSnapshot, Runtime_concurrencyPolicyOverridesLayer as concurrencyPolicyOverridesLayer, Runtime_make as make, Runtime_openProgram as openProgram, Runtime_runProgram as runProgram, Runtime_setConcurrencyPolicyOverride as setConcurrencyPolicyOverride, Runtime_setTraitConvergeOverride as setTraitConvergeOverride, Runtime_stateTransactionOverridesLayer as stateTransactionOverridesLayer };
+  export { Runtime_BootError as BootError, type Runtime_DevtoolsRuntimeOptions as DevtoolsRuntimeOptions, Runtime_DisposeError as DisposeError, Runtime_DisposeTimeoutError as DisposeTimeoutError, Runtime_MainError as MainError, type Runtime_OpenProgramOptions as OpenProgramOptions, type Runtime_ProgramIdentity as ProgramIdentity, type Runtime_ProgramRunContext as ProgramRunContext, type Runtime_ProgramRunnerErrorTag as ProgramRunnerErrorTag, type Runtime_ReadQueryFallbackReason as ReadQueryFallbackReason, type Runtime_RunProgramOptions as RunProgramOptions, type Runtime_RuntimeOptions as RuntimeOptions, type Runtime_RuntimeReadQueryOptions as RuntimeReadQueryOptions, type Runtime_RuntimeReadQueryStrictGateOptions as RuntimeReadQueryStrictGateOptions, type Runtime_RuntimeStateTransactionOptions as RuntimeStateTransactionOptions, Runtime_applyTransactionSnapshot as applyTransactionSnapshot, Runtime_batch as batch, Runtime_concurrencyPolicyOverridesLayer as concurrencyPolicyOverridesLayer, Runtime_make as make, Runtime_openProgram as openProgram, Runtime_runProgram as runProgram, Runtime_schedulingPolicyOverridesLayer as schedulingPolicyOverridesLayer, Runtime_setConcurrencyPolicyOverride as setConcurrencyPolicyOverride, Runtime_setSchedulingPolicyOverride as setSchedulingPolicyOverride, Runtime_setTraitConvergeOverride as setTraitConvergeOverride, Runtime_stateTransactionOverridesLayer as stateTransactionOverridesLayer };
 }
 
-export { BootError as B, type DevtoolsRuntimeOptions as D, MainError as M, type OpenProgramOptions as O, type ProgramRunContext as P, Runtime as R, type RunProgramOptions as a, type RuntimeStateTransactionOptions as b, type ReadQueryFallbackReason as c, type RuntimeReadQueryStrictGateOptions as d, type RuntimeReadQueryOptions as e, type RuntimeOptions as f, concurrencyPolicyOverridesLayer as g, setTraitConvergeOverride as h, setConcurrencyPolicyOverride as i, applyTransactionSnapshot as j, DisposeError as k, DisposeTimeoutError as l, make as m, type ProgramIdentity as n, openProgram as o, type ProgramRunnerErrorTag as p, runProgram as r, stateTransactionOverridesLayer as s };
+export { BootError as B, type DevtoolsRuntimeOptions as D, MainError as M, type OpenProgramOptions as O, type ProgramRunContext as P, Runtime as R, type RunProgramOptions as a, type RuntimeStateTransactionOptions as b, type ReadQueryFallbackReason as c, type RuntimeReadQueryStrictGateOptions as d, type RuntimeReadQueryOptions as e, type RuntimeOptions as f, batch as g, schedulingPolicyOverridesLayer as h, concurrencyPolicyOverridesLayer as i, setTraitConvergeOverride as j, setSchedulingPolicyOverride as k, setConcurrencyPolicyOverride as l, make as m, applyTransactionSnapshot as n, openProgram as o, DisposeError as p, DisposeTimeoutError as q, runProgram as r, stateTransactionOverridesLayer as s, type ProgramIdentity as t, type ProgramRunnerErrorTag as u };