@typeonce/effect-machine 0.2.0 → 0.3.0

package/dist/Machine.d.ts

@@ -32,6 +32,7 @@ export type TypeId = "~effect/Machine";
  */
 export declare const TypeId: TypeId;
 declare const MachineOutputStatesTypeId: unique symbol;
+declare const MachineTypeId: unique symbol;
 /**
  * Type identifier used for the synthetic event passed to startup lifecycle
  * actions.
@@ -78,16 +79,17 @@ type IsAny<A> = 0 extends (1 & A) ? true : false;
  *
  * **Gotchas**
  *
- * History states and declarative first-class guards are not part of the
- * current API. Conditional behavior can be expressed in typed handlers with
- * ordinary TypeScript control flow. Use `after` for cancellable state-scoped
- * delayed events.
+ * Declarative first-class guards are not part of the current API. Conditional
+ * behavior can be expressed in typed handlers with ordinary TypeScript control
+ * flow. Use `after` for cancellable state-scoped delayed events.
  *
  * @category models
  * @since 4.0.0
  */
 export interface Machine<States extends Machine.StateSchemas, Events extends ReadonlyArray<Machine.TaggedSchema>, Input extends Schema.Top = typeof Schema.Void, UnhandledStates extends Machine.StateIdentifier<States> = Machine.StateIdentifier<States>, E = never, R = never, InitialE = never, InitialR = never, FinalStates extends Machine.StateIdentifier<States> = never, Output = never, Emits extends ReadonlyArray<Machine.TaggedSchema> = readonly [], OutputStates extends Machine.StateIdentifier<States> = never, InputEvents extends ReadonlyArray<Machine.TaggedSchema> = Events> extends Pipeable {
     readonly [TypeId]: TypeId;
+    /** @internal Stable type-level carrier for machine protocol extraction. */
+    readonly [MachineTypeId]: Machine.TypeCarrier<States, Events, Input, UnhandledStates, E, R, InitialE, InitialR, FinalStates, Output, Emits, OutputStates, InputEvents>;
     /** @internal Prevents output implementation evidence from being widened. */
     readonly [MachineOutputStatesTypeId]: Readonly<Record<OutputStates, true>>;
     /**
@@ -313,22 +315,21 @@ export declare namespace Runtime {
 }
 type ExcludeCompatibleRuntime<Requirements, Events, Emits> = Requirements extends Runtime.Requirement<infer RequiredEvents, infer RequiredEmits> ? IsAny<Requirements> extends true ? Requirements : [RequiredEvents] extends [Events] ? [RequiredEmits] extends [Emits] ? never : Requirements : Requirements : Requirements;
 type IncompatibleRuntime<Requirements, Events, Emits> = Requirements extends Runtime.Requirement<infer RequiredEvents, infer RequiredEmits> ? IsAny<Requirements> extends true ? never : [RequiredEvents] extends [Events] ? [RequiredEmits] extends [Emits] ? never : Requirements : Requirements : never;
-declare const RuntimeCompatibilityErrorTypeId = "~effect/Machine/RuntimeCompatibilityError";
 declare const InvokeTypeId: unique symbol;
-type EnsureCompatibleRuntime<Requirements, Events, Emits> = [IncompatibleRuntime<Requirements, Events, Emits>] extends [
-    never
-] ? unknown : {
-    readonly [RuntimeCompatibilityErrorTypeId]: IncompatibleRuntime<Requirements, Events, Emits>;
-};
 type StateDefinitionError<Message extends string> = {
     readonly "~effect/Machine/DefinitionError": Message;
 };
-type ValidateStateTree<States extends Machine.StateSchemas> = {
-    readonly [Key in keyof States]: ValidateStateNode<States[Key]>;
+type ActiveStateKey<States extends Machine.StateSchemas> = Machine.ActiveStateKey<States>;
+type HistoryStateKey<States extends Machine.StateSchemas> = Machine.HistoryStateKey<States>;
+type ValidateStateTree<States extends Machine.StateSchemas, AllowHistory extends boolean = false> = {
+    readonly [Key in keyof States]: ValidateStateNode<States[Key], AllowHistory>;
 };
-type ValidateStateNode<Node> = Node extends Machine.TaggedSchema ? unknown : Node extends {
+type ValidateStateNode<Node, AllowHistory extends boolean> = Node extends Machine.HistoryStateNodeConfig ? AllowHistory extends true ? ValidateHistoryStateNode<Node> : StateDefinitionError<"History states must be declared below an active parent state"> : Node extends Machine.TaggedSchema ? unknown : Node extends {
     readonly schema: Machine.TaggedSchema;
 } ? ValidateStateNodeConfig<Node> : StateDefinitionError<"State nodes must be tagged schemas or state node configs">;
+type ValidateHistoryStateNode<Node extends Machine.HistoryStateNodeConfig> = [
+    Extract<keyof Node, "schema" | "states" | "initial" | "output">
+] extends [never] ? unknown : StateDefinitionError<"History states cannot declare schemas, children, initial states, or output">;
 type ValidateStateNodeConfig<Node extends {
     readonly schema: Machine.TaggedSchema;
 }> = Node extends {
@@ -344,14 +345,14 @@ type ValidateStateNodeWithChildren<Node extends {
 } ? StateDefinitionError<"Final states cannot declare child states"> : Node extends {
     readonly type: "parallel";
 } ? "initial" extends keyof Node ? StateDefinitionError<"Parallel states cannot declare an initial child"> : {
-    readonly states: ValidateStateTree<Children>;
+    readonly states: ValidateStateTree<Children, true>;
 } & ValidateOutputSchema<Node> : "output" extends keyof Node ? StateDefinitionError<"Only final and parallel states can declare output"> : ValidateCompoundStateNode<Node, Children> : StateDefinitionError<"Child states must be a state tree">;
 type ValidateCompoundStateNode<Node extends {
     readonly schema: Machine.TaggedSchema;
 }, Children extends Machine.StateSchemas> = Node extends {
     readonly initial: infer Initial;
-} ? Initial extends Extract<keyof Children, string> ? {
-    readonly states: ValidateStateTree<Children>;
+} ? Initial extends ActiveStateKey<Children> ? {
+    readonly states: ValidateStateTree<Children, true>;
 } : StateDefinitionError<"Compound initial must be one of its direct child keys"> : StateDefinitionError<"Compound states must declare an initial child">;
 type ValidateStateNodeWithoutChildren<Node extends {
     readonly schema: Machine.TaggedSchema;
@@ -361,7 +362,7 @@ type ValidateStateNodeWithoutChildren<Node extends {
 type DefineStateTreeInput<States extends Machine.StateSchemas> = {
     readonly [Key in keyof States]: DefineStateNodeInput<States[Key]>;
 };
-type DefineStateNodeInput<Node> = Node extends Machine.TaggedSchema ? Node : Node extends {
+type DefineStateNodeInput<Node> = Node extends Machine.TaggedSchema ? Node : Node extends Machine.HistoryStateNodeConfig ? Machine.HistoryStateNodeConfig : Node extends {
     readonly type: "parallel";
     readonly states: infer Children extends Machine.StateSchemas;
 } ? Omit<Node, "states"> & {
@@ -369,12 +370,19 @@ type DefineStateNodeInput<Node> = Node extends Machine.TaggedSchema ? Node : Nod
 } : Node extends {
     readonly states: infer Children extends Machine.StateSchemas;
 } ? Omit<Node, "initial" | "states"> & {
-    readonly initial: Extract<keyof Children, string>;
+    readonly initial: ActiveStateKey<Children>;
     readonly states: DefineStateTreeInput<Children>;
 } : Node;
 type ValidateDefinedStates<States extends Machine.StateSchemas> = [States] extends [
     Machine.ValidateStateSchemas<States>
 ] ? [] : [validation: Machine.ValidateStateSchemas<States>];
+type InvalidDefinedStateTreeInput<States extends Machine.StateSchemas> = [States] extends [
+    Machine.ValidateStateSchemas<States>
+] ? never : States & Machine.ValidateStateSchemas<States>;
+interface DefineStates {
+    <const States extends Machine.StateSchemas>(states: States & DefineStateTreeInput<NoInfer<States>>, ..._validation: ValidateDefinedStates<NoInfer<States>>): Machine.DefinedStates<States>;
+    <const States extends Machine.StateSchemas>(states: InvalidDefinedStateTreeInput<States>): never;
+}
 type EventProtocolError<Message extends string, Tag extends PropertyKey = never> = {
     readonly "~effect/Machine/EventProtocolError": Message;
     readonly tag: Tag;
@@ -383,16 +391,39 @@ type DuplicateEventTag<Events extends ReadonlyArray<Machine.TaggedSchema>, Seen
     infer Head extends Machine.TaggedSchema,
     ...infer Tail extends ReadonlyArray<Machine.TaggedSchema>
 ] ? Machine.TagOf<Head> extends infer Tag extends PropertyKey ? Tag extends Seen ? Tag | DuplicateEventTag<Tail, Seen> : DuplicateEventTag<Tail, Seen | Tag> : never : never;
-type ValidateEventProtocol<InputEvents extends ReadonlyArray<Machine.TaggedSchema>, InternalEvents extends ReadonlyArray<Machine.TaggedSchema>, DuplicateInput extends PropertyKey = DuplicateEventTag<InputEvents>, DuplicateInternal extends PropertyKey = DuplicateEventTag<InternalEvents>, Overlap extends PropertyKey = Extract<Machine.TagOf<InputEvents[number]>, Machine.TagOf<InternalEvents[number]>>> = [DuplicateInput] extends [never] ? [DuplicateInternal] extends [never] ? [Overlap] extends [never] ? [] : [validation: EventProtocolError<"Public and internal event tags must be disjoint", Overlap>] : [validation: EventProtocolError<"Internal event tags must be unique", DuplicateInternal>] : [validation: EventProtocolError<"Public event tags must be unique", DuplicateInput>];
+type ValidateInputEventProtocol<InputEvents extends ReadonlyArray<Machine.TaggedSchema>, DuplicateInput extends PropertyKey = DuplicateEventTag<InputEvents>> = [DuplicateInput] extends [never] ? unknown : EventProtocolError<"Public event tags must be unique", DuplicateInput>;
+type ValidateInternalEventProtocol<InputEvents extends ReadonlyArray<Machine.TaggedSchema>, InternalEvents extends ReadonlyArray<Machine.TaggedSchema>, DuplicateInternal extends PropertyKey = DuplicateEventTag<InternalEvents>, Overlap extends PropertyKey = Extract<Machine.TagOf<InputEvents[number]>, Machine.TagOf<InternalEvents[number]>>> = [DuplicateInternal] extends [never] ? [Overlap] extends [never] ? unknown : EventProtocolError<"Public and internal event tags must be disjoint", Overlap> : EventProtocolError<"Internal event tags must be unique", DuplicateInternal>;
 declare const SnapshotBuilderStateTypeId: unique symbol;
-type SnapshotBuilderComplete<Regions> = {
+declare const SnapshotBuilderConstructionTypeId: unique symbol;
+type SnapshotBuilderComplete<Regions, Constructed extends boolean = false> = {
     readonly [SnapshotBuilderStateTypeId]: Regions;
+    readonly [SnapshotBuilderConstructionTypeId]: Constructed;
 };
+type FromCallable<Arguments extends ReadonlyArray<unknown>, Result> = Arguments extends readonly [infer Input, ...infer Rest extends ReadonlyArray<unknown>] ? {} extends Input ? {
+    (...args: Rest): Result;
+    (...args: Arguments): Result;
+} : (...args: Arguments) => Result : (...args: Arguments) => Result;
+type FromMethod<Arguments extends ReadonlyArray<unknown>, Result> = {
+    /**
+     * Constructs the selected state from its schema make input while the
+     * machine plans the resulting configuration. The input may be omitted when
+     * the schema accepts an empty constructor object.
+     *
+     * @since 4.0.0
+     */
+    readonly from: FromCallable<Arguments, Machine.StateConstruction<Result>>;
+};
+type ConstructionResult<Result> = Result | Machine.StateConstruction<Result>;
+type UnwrapConstruction<Result> = Result extends Machine.StateConstruction<infer Value> ? Value : Result;
+type ConstructionSelectorFromCallable<Input, Builder, Result> = {} extends Input ? {
+    <Selected extends ConstructionResult<Result>>(state: (builder: Builder) => Selected): Machine.StateConstruction<UnwrapConstruction<Selected>>;
+    <Selected extends ConstructionResult<Result>>(input: Input, state: (builder: Builder) => Selected): Machine.StateConstruction<UnwrapConstruction<Selected>>;
+} : <Selected extends ConstructionResult<Result>>(input: Input, state: (builder: Builder) => Selected) => Machine.StateConstruction<UnwrapConstruction<Selected>>;
 type InitialSnapshotBuilderWithPrefix<States extends Machine.StateSchemas, Prefix extends string = ""> = {
-    readonly [Key in Extract<keyof States, string>]: InitialSnapshotMethod<States, Key, Prefix>;
+    readonly [Key in ActiveStateKey<States>]: InitialSnapshotMethod<States, Key, Prefix>;
 };
-type InitialSnapshotMethod<States extends Machine.StateSchemas, StateId extends Extract<keyof States, string>, Prefix extends string> = (...args: InitialSnapshotArguments<States, StateId, Prefix>) => InitialSnapshotResult<States, StateId, Prefix>;
-type InitialSnapshotArguments<States extends Machine.StateSchemas, StateId extends Extract<keyof States, string>, Prefix extends string, Path extends string = Machine.JoinPath<Prefix, StateId>> = States[StateId] extends infer Node ? Node extends {
+type InitialSnapshotMethod<States extends Machine.StateSchemas, StateId extends ActiveStateKey<States>, Prefix extends string> = ((...args: InitialSnapshotArguments<States, StateId, Prefix>) => InitialSnapshotResult<States, StateId, Prefix>) & FromMethod<InitialSnapshotFromArguments<States, StateId, Prefix>, InitialSnapshotResult<States, StateId, Prefix>>;
+type InitialSnapshotArguments<States extends Machine.StateSchemas, StateId extends ActiveStateKey<States>, Prefix extends string, Path extends string = Machine.JoinPath<Prefix, StateId>> = States[StateId] extends infer Node ? Node extends {
     readonly type: "parallel";
     readonly states: infer Children extends Machine.StateSchemas;
 } ? [
@@ -401,32 +432,50 @@ type InitialSnapshotArguments<States extends Machine.StateSchemas, StateId exten
 ] : Node extends {
     readonly states: infer Children extends Machine.StateSchemas;
 } ? Node extends {
-    readonly initial: infer Initial extends Extract<keyof Children, string>;
+    readonly initial: infer Initial extends ActiveStateKey<Children>;
 } ? [
     value: Machine.NodeSchema<Node>["Type"],
     state: (builder: Pick<InitialSnapshotBuilderWithPrefix<Children, Path>, Initial>) => InitialSnapshotResult<Children, Initial, Path>
 ] : never : [value: Machine.NodeSchema<Node>["Type"]] : never;
-type InitialSnapshotResult<States extends Machine.StateSchemas, StateId extends Extract<keyof States, string>, Prefix extends string, Path extends string = Machine.JoinPath<Prefix, StateId>> = States[StateId] extends infer Node ? Node extends {
+type InitialSnapshotFromArguments<States extends Machine.StateSchemas, StateId extends ActiveStateKey<States>, Prefix extends string, Path extends string = Machine.JoinPath<Prefix, StateId>> = States[StateId] extends infer Node ? Node extends {
+    readonly type: "parallel";
+    readonly states: infer Children extends Machine.StateSchemas;
+} ? [
+    input: Machine.NodeSchema<Node>["~type.make.in"],
+    states: (builder: InitialParallelBuilder<Children, Path>) => SnapshotBuilderComplete<InitialSnapshotRegionsWithPrefix<Children, Path>, boolean>
+] : Node extends {
+    readonly states: infer Children extends Machine.StateSchemas;
+} ? Node extends {
+    readonly initial: infer Initial extends ActiveStateKey<Children>;
+} ? [
+    input: Machine.NodeSchema<Node>["~type.make.in"],
+    state: (builder: Pick<InitialSnapshotBuilderWithPrefix<Children, Path>, Initial>) => ConstructionResult<InitialSnapshotResult<Children, Initial, Path>>
+] : never : [input: Machine.NodeSchema<Node>["~type.make.in"]] : never;
+type InitialSnapshotResult<States extends Machine.StateSchemas, StateId extends ActiveStateKey<States>, Prefix extends string, Path extends string = Machine.JoinPath<Prefix, StateId>> = States[StateId] extends infer Node ? Node extends {
     readonly type: "parallel";
     readonly states: infer Children extends Machine.StateSchemas;
 } ? Machine.ParallelSnapshot<Path, Machine.NodeSchema<Node>["Type"], InitialSnapshotRegionsWithPrefix<Children, Path>> : Node extends {
     readonly states: infer Children extends Machine.StateSchemas;
 } ? Node extends {
-    readonly initial: infer Initial extends Extract<keyof Children, string>;
+    readonly initial: infer Initial extends ActiveStateKey<Children>;
 } ? Machine.CompoundSnapshot<Path, Machine.NodeSchema<Node>["Type"], InitialSnapshotResult<Children, Initial, Path>> : never : Machine.AtomicSnapshot<Path, Machine.NodeSchema<Node>["Type"]> : never;
 type InitialSnapshotRegionsWithPrefix<States extends Machine.StateSchemas, Prefix extends string> = {
-    readonly [Key in Extract<keyof States, string>]: InitialSnapshotResult<States, Key, Prefix>;
+    readonly [Key in ActiveStateKey<States>]: InitialSnapshotResult<States, Key, Prefix>;
 };
-type InitialParallelBuilder<States extends Machine.StateSchemas, Prefix extends string, Remaining extends Extract<keyof States, string> = Extract<keyof States, string>, Regions = {}> = SnapshotBuilderComplete<Regions> & {
-    readonly [Key in Remaining]: (...args: InitialSnapshotArguments<States, Key, Prefix>) => InitialParallelBuilder<States, Prefix, Exclude<Remaining, Key>, Regions & {
+type InitialParallelBuilder<States extends Machine.StateSchemas, Prefix extends string, Remaining extends ActiveStateKey<States> = ActiveStateKey<States>, Regions = {}, Constructed extends boolean = false> = SnapshotBuilderComplete<Regions, Constructed> & {
+    readonly [Key in Remaining]: ((...args: InitialSnapshotArguments<States, Key, Prefix>) => InitialParallelBuilder<States, Prefix, Exclude<Remaining, Key>, Regions & {
         readonly [Region in Key]: InitialSnapshotResult<States, Key, Prefix>;
-    }>;
+    }, Constructed>) & {
+        readonly from: FromCallable<InitialSnapshotFromArguments<States, Key, Prefix>, InitialParallelBuilder<States, Prefix, Exclude<Remaining, Key>, Regions & {
+            readonly [Region in Key]: InitialSnapshotResult<States, Key, Prefix>;
+        }, true>>;
+    };
 };
 type FullSnapshotBuilderWithPrefix<States extends Machine.StateSchemas, Prefix extends string = ""> = {
-    readonly [Key in Extract<keyof States, string>]: FullSnapshotMethod<States, Key, Prefix>;
+    readonly [Key in ActiveStateKey<States>]: FullSnapshotMethod<States, Key, Prefix>;
 };
-type FullSnapshotMethod<States extends Machine.StateSchemas, StateId extends Extract<keyof States, string>, Prefix extends string> = (...args: FullSnapshotArguments<States, StateId, Prefix>) => FullSnapshotResult<States, StateId, Prefix>;
-type FullSnapshotArguments<States extends Machine.StateSchemas, StateId extends Extract<keyof States, string>, Prefix extends string, Path extends string = Machine.JoinPath<Prefix, StateId>> = States[StateId] extends infer Node ? Node extends {
+type FullSnapshotMethod<States extends Machine.StateSchemas, StateId extends ActiveStateKey<States>, Prefix extends string> = ((...args: FullSnapshotArguments<States, StateId, Prefix>) => FullSnapshotResult<States, StateId, Prefix>) & FromMethod<FullSnapshotFromArguments<States, StateId, Prefix>, FullSnapshotResult<States, StateId, Prefix>>;
+type FullSnapshotArguments<States extends Machine.StateSchemas, StateId extends ActiveStateKey<States>, Prefix extends string, Path extends string = Machine.JoinPath<Prefix, StateId>> = States[StateId] extends infer Node ? Node extends {
     readonly type: "parallel";
     readonly states: infer Children extends Machine.StateSchemas;
 } ? [
@@ -438,11 +487,27 @@ type FullSnapshotArguments<States extends Machine.StateSchemas, StateId extends
     value: Machine.NodeSchema<Node>["Type"],
     state: (builder: FullSnapshotBuilderWithPrefix<Children, Path>) => Machine.SnapshotWithPrefix<Children, Path>
 ] : [value: Machine.NodeSchema<Node>["Type"]] : never;
-type FullSnapshotResult<States extends Machine.StateSchemas, StateId extends Extract<keyof States, string>, Prefix extends string, Path extends string = Machine.JoinPath<Prefix, StateId>> = Machine.SnapshotByIdentifierWithPath<States, StateId, Path>;
-type FullParallelBuilder<States extends Machine.StateSchemas, Prefix extends string, Remaining extends Extract<keyof States, string> = Extract<keyof States, string>, Regions = {}> = SnapshotBuilderComplete<Regions> & {
-    readonly [Key in Remaining]: (...args: FullSnapshotArguments<States, Key, Prefix>) => FullParallelBuilder<States, Prefix, Exclude<Remaining, Key>, Regions & {
+type FullSnapshotFromArguments<States extends Machine.StateSchemas, StateId extends ActiveStateKey<States>, Prefix extends string, Path extends string = Machine.JoinPath<Prefix, StateId>> = States[StateId] extends infer Node ? Node extends {
+    readonly type: "parallel";
+    readonly states: infer Children extends Machine.StateSchemas;
+} ? [
+    input: Machine.NodeSchema<Node>["~type.make.in"],
+    states: (builder: FullParallelBuilder<Children, Path>) => SnapshotBuilderComplete<Machine.SnapshotRegionsWithPrefix<Children, Path>, boolean>
+] : Node extends {
+    readonly states: infer Children extends Machine.StateSchemas;
+} ? [
+    input: Machine.NodeSchema<Node>["~type.make.in"],
+    state: (builder: FullSnapshotBuilderWithPrefix<Children, Path>) => ConstructionResult<Machine.SnapshotWithPrefix<Children, Path>>
+] : [input: Machine.NodeSchema<Node>["~type.make.in"]] : never;
+type FullSnapshotResult<States extends Machine.StateSchemas, StateId extends ActiveStateKey<States>, Prefix extends string, Path extends string = Machine.JoinPath<Prefix, StateId>> = Machine.SnapshotByIdentifierWithPath<States, StateId, Path>;
+type FullParallelBuilder<States extends Machine.StateSchemas, Prefix extends string, Remaining extends ActiveStateKey<States> = ActiveStateKey<States>, Regions = {}, Constructed extends boolean = false> = SnapshotBuilderComplete<Regions, Constructed> & {
+    readonly [Key in Remaining]: ((...args: FullSnapshotArguments<States, Key, Prefix>) => FullParallelBuilder<States, Prefix, Exclude<Remaining, Key>, Regions & {
         readonly [Region in Key]: FullSnapshotResult<States, Key, Prefix>;
-    }>;
+    }, Constructed>) & {
+        readonly from: FromCallable<FullSnapshotFromArguments<States, Key, Prefix>, FullParallelBuilder<States, Prefix, Exclude<Remaining, Key>, Regions & {
+            readonly [Region in Key]: FullSnapshotResult<States, Key, Prefix>;
+        }, true>>;
+    };
 };
 type ParentPath<Path extends string> = Path extends `${infer Parent}.${infer Child}` ? Child extends `${string}.${string}` ? `${Parent}.${ParentPath<Child>}` : Parent : never;
 type IsCompoundNode<Node> = Node extends {
@@ -455,42 +520,104 @@ type ChildrenOf<States extends Machine.StateSchemas, Path extends Machine.StateI
     readonly states: infer Children extends Machine.StateSchemas;
 } ? Children : never;
 type StateIdentifierFromPath<States extends Machine.StateSchemas, Path extends string> = Extract<Path, Machine.StateIdentifier<States>>;
-type LocalTargetResult<AllStates extends Machine.StateSchemas, States extends Machine.StateSchemas, StateId extends Extract<keyof States, string>, Prefix extends string, Path extends string = Machine.JoinPath<Prefix, StateId>> = States[StateId] extends {
+type LocalTargetResult<AllStates extends Machine.StateSchemas, States extends Machine.StateSchemas, StateId extends ActiveStateKey<States>, Prefix extends string, Path extends string = Machine.JoinPath<Prefix, StateId>> = States[StateId] extends {
     readonly states: infer Children extends Machine.StateSchemas;
-} ? LocalTargetResultWithPrefix<AllStates, Children, Path> : Machine.Target<AllStates, StateIdentifierFromPath<AllStates, Path>>;
+} ? States[StateId] extends {
+    readonly type: "parallel";
+} ? Machine.Target<AllStates, StateIdentifierFromPath<AllStates, Path>> : LocalTargetResultWithPrefix<AllStates, Children, Path> : Machine.Target<AllStates, StateIdentifierFromPath<AllStates, Path>>;
 type LocalTargetResultWithPrefix<AllStates extends Machine.StateSchemas, States extends Machine.StateSchemas, Prefix extends string> = {
-    readonly [Key in Extract<keyof States, string>]: LocalTargetResult<AllStates, States, Key, Prefix>;
-}[Extract<keyof States, string>];
-type LocalTargetBuilderWithPrefix<AllStates extends Machine.StateSchemas, States extends Machine.StateSchemas, Prefix extends string> = {
-    readonly [Key in Extract<keyof States, string>]: LocalTargetMethod<AllStates, States, Key, Prefix>;
+    readonly [Key in ActiveStateKey<States>]: LocalTargetResult<AllStates, States, Key, Prefix>;
+}[ActiveStateKey<States>];
+type LocalTargetBuilderWithPrefix<AllStates extends Machine.StateSchemas, States extends Machine.StateSchemas, Prefix extends string, Source extends Machine.StateIdentifier<AllStates>> = {
+    readonly [Key in ActiveStateKey<States>]: LocalTargetMethod<AllStates, States, Key, Prefix, Source>;
 };
-type LocalTargetMethod<AllStates extends Machine.StateSchemas, States extends Machine.StateSchemas, StateId extends Extract<keyof States, string>, Prefix extends string, Path extends string = Machine.JoinPath<Prefix, StateId>> = States[StateId] extends infer Node ? Node extends {
+type LocalTargetMethod<AllStates extends Machine.StateSchemas, States extends Machine.StateSchemas, StateId extends ActiveStateKey<States>, Prefix extends string, Source extends Machine.StateIdentifier<AllStates>, Path extends string = Machine.JoinPath<Prefix, StateId>> = States[StateId] extends infer Node ? Node extends {
+    readonly type: "parallel";
     readonly states: infer Children extends Machine.StateSchemas;
-} ? <Result extends LocalTargetResultWithPrefix<AllStates, Children, Path>>(value: Machine.NodeSchema<Node>["Type"], state: (builder: LocalTargetBuilderWithPrefix<AllStates, Children, Path>) => Result) => Result : (value: Machine.NodeSchema<Node>["Type"]) => Machine.Target<AllStates, StateIdentifierFromPath<AllStates, Path>> : never;
-type LocalTargetBuilderForScope<States extends Machine.StateSchemas, Scope extends Machine.StateIdentifier<States>> = ChildrenOf<States, Scope> extends infer Children extends Machine.StateSchemas ? LocalTargetBuilderWithPrefix<States, Children, Scope> & {
+} ? Source extends Path | `${Path}.${string}` ? (<Result extends ConstructionResult<LocalTargetResultWithPrefix<AllStates, Children, Path>>>(value: Machine.NodeSchema<Node>["Type"], state: (builder: LocalTargetBuilderWithPrefix<AllStates, Children, Path, Source>) => Result) => Result) & {
+    readonly from: ConstructionSelectorFromCallable<Machine.NodeSchema<Node>["~type.make.in"], LocalTargetBuilderWithPrefix<AllStates, Children, Path, Source>, LocalTargetResultWithPrefix<AllStates, Children, Path>>;
+} : ((value: Machine.NodeSchema<Node>["Type"], states: (builder: FullParallelBuilder<Children, Path>) => SnapshotBuilderComplete<Machine.SnapshotRegionsWithPrefix<Children, Path>>) => Machine.Target<AllStates, StateIdentifierFromPath<AllStates, Path>>) & FromMethod<[
+    input: Machine.NodeSchema<Node>["~type.make.in"],
+    states: (builder: FullParallelBuilder<Children, Path>) => SnapshotBuilderComplete<Machine.SnapshotRegionsWithPrefix<Children, Path>, boolean>
+], Machine.Target<AllStates, StateIdentifierFromPath<AllStates, Path>>> : Node extends {
+    readonly states: infer Children extends Machine.StateSchemas;
+} ? (<Result extends ConstructionResult<LocalTargetResultWithPrefix<AllStates, Children, Path>>>(value: Machine.NodeSchema<Node>["Type"], state: (builder: LocalTargetBuilderWithPrefix<AllStates, Children, Path, Source>) => Result) => Result) & {
+    readonly from: ConstructionSelectorFromCallable<Machine.NodeSchema<Node>["~type.make.in"], LocalTargetBuilderWithPrefix<AllStates, Children, Path, Source>, LocalTargetResultWithPrefix<AllStates, Children, Path>>;
+} : ((value: Machine.NodeSchema<Node>["Type"]) => Machine.Target<AllStates, StateIdentifierFromPath<AllStates, Path>>) & FromMethod<[
+    input: Machine.NodeSchema<Node>["~type.make.in"]
+], Machine.Target<AllStates, StateIdentifierFromPath<AllStates, Path>>> : never;
+type LocalTargetBuilderForScope<States extends Machine.StateSchemas, Scope extends Machine.StateIdentifier<States>, Source extends Machine.StateIdentifier<States>> = ChildrenOf<States, Scope> extends infer Children extends Machine.StateSchemas ? LocalTargetBuilderWithPrefix<States, Children, Scope, Source> & {
     /**
      * Updates the value of the state containing the local group and moves to
      * one of the states inside it. Values in other active branches are kept.
      *
      * @since 4.0.0
      */
-    readonly with: <Result extends LocalTargetResultWithPrefix<States, Children, Scope>>(value: Machine.StateByIdentifier<States, Scope>, state: (builder: LocalTargetBuilderWithPrefix<States, Children, Scope>) => Result) => Result;
+    readonly with: (<Result extends ConstructionResult<LocalTargetResultWithPrefix<States, Children, Scope>>>(value: Machine.StateByIdentifier<States, Scope>, state: (builder: LocalTargetBuilderWithPrefix<States, Children, Scope, Source>) => Result) => Result) & {
+        readonly from: ConstructionSelectorFromCallable<Machine.SchemaByIdentifier<States, Scope>["~type.make.in"], LocalTargetBuilderWithPrefix<States, Children, Scope, Source>, LocalTargetResultWithPrefix<States, Children, Scope>>;
+    };
 } : {};
-type BranchTargetResult<AllStates extends Machine.StateSchemas, States extends Machine.StateSchemas, StateId extends Extract<keyof States, string>, Prefix extends string, Path extends string = Machine.JoinPath<Prefix, StateId>> = States[StateId] extends {
+type BranchTargetResult<AllStates extends Machine.StateSchemas, States extends Machine.StateSchemas, StateId extends ActiveStateKey<States>, Prefix extends string, Path extends string = Machine.JoinPath<Prefix, StateId>> = States[StateId] extends {
     readonly states: infer Children extends Machine.StateSchemas;
-} ? BranchTargetResultWithPrefix<AllStates, Children, Path> : Machine.Target<AllStates, StateIdentifierFromPath<AllStates, Path>>;
+} ? States[StateId] extends {
+    readonly type: "parallel";
+} ? Machine.Target<AllStates, StateIdentifierFromPath<AllStates, Path>> : BranchTargetResultWithPrefix<AllStates, Children, Path> : Machine.Target<AllStates, StateIdentifierFromPath<AllStates, Path>>;
 type BranchTargetResultWithPrefix<AllStates extends Machine.StateSchemas, States extends Machine.StateSchemas, Prefix extends string> = {
-    readonly [Key in Extract<keyof States, string>]: BranchTargetResult<AllStates, States, Key, Prefix>;
-}[Extract<keyof States, string>];
-type BranchTargetBuilderWithPrefix<AllStates extends Machine.StateSchemas, States extends Machine.StateSchemas, Prefix extends string> = {
-    readonly [Key in Extract<keyof States, string>]: BranchTargetMethod<AllStates, States, Key, Prefix>;
+    readonly [Key in ActiveStateKey<States>]: BranchTargetResult<AllStates, States, Key, Prefix>;
+}[ActiveStateKey<States>];
+type BranchTargetBuilderWithPrefix<AllStates extends Machine.StateSchemas, States extends Machine.StateSchemas, Prefix extends string, Source extends Machine.StateIdentifier<AllStates>> = {
+    readonly [Key in ActiveStateKey<States>]: BranchTargetMethod<AllStates, States, Key, Prefix, Source>;
 };
-type BranchTargetMethod<AllStates extends Machine.StateSchemas, States extends Machine.StateSchemas, StateId extends Extract<keyof States, string>, Prefix extends string, Path extends string = Machine.JoinPath<Prefix, StateId>> = States[StateId] extends infer Node ? Node extends {
+type BranchTargetMethod<AllStates extends Machine.StateSchemas, States extends Machine.StateSchemas, StateId extends ActiveStateKey<States>, Prefix extends string, Source extends Machine.StateIdentifier<AllStates>, Path extends string = Machine.JoinPath<Prefix, StateId>> = States[StateId] extends infer Node ? Node extends {
+    readonly type: "parallel";
     readonly states: infer Children extends Machine.StateSchemas;
-} ? (<Result extends BranchTargetResultWithPrefix<AllStates, Children, Path>>(value: Machine.NodeSchema<Node>["Type"], state: (builder: BranchTargetBuilderWithPrefix<AllStates, Children, Path>) => Result) => Result) & BranchTargetBuilderWithPrefix<AllStates, Children, Path> : (value: Machine.NodeSchema<Node>["Type"]) => Machine.Target<AllStates, StateIdentifierFromPath<AllStates, Path>> : never;
-type BranchTargetBuilderForRoot<States extends Machine.StateSchemas, Root extends Extract<keyof States, string>> = {
-    readonly [Key in Root]: BranchTargetMethod<States, States, Key, "">;
+} ? Source extends Path | `${Path}.${string}` ? (<Result extends ConstructionResult<BranchTargetResultWithPrefix<AllStates, Children, Path>>>(value: Machine.NodeSchema<Node>["Type"], state: (builder: BranchTargetBuilderWithPrefix<AllStates, Children, Path, Source>) => Result) => Result) & {
+    readonly from: ConstructionSelectorFromCallable<Machine.NodeSchema<Node>["~type.make.in"], BranchTargetBuilderWithPrefix<AllStates, Children, Path, Source>, BranchTargetResultWithPrefix<AllStates, Children, Path>>;
+} & BranchTargetBuilderWithPrefix<AllStates, Children, Path, Source> : ((value: Machine.NodeSchema<Node>["Type"], states: (builder: FullParallelBuilder<Children, Path>) => SnapshotBuilderComplete<Machine.SnapshotRegionsWithPrefix<Children, Path>>) => Machine.Target<AllStates, StateIdentifierFromPath<AllStates, Path>>) & FromMethod<[
+    input: Machine.NodeSchema<Node>["~type.make.in"],
+    states: (builder: FullParallelBuilder<Children, Path>) => SnapshotBuilderComplete<Machine.SnapshotRegionsWithPrefix<Children, Path>, boolean>
+], Machine.Target<AllStates, StateIdentifierFromPath<AllStates, Path>>> : Node extends {
+    readonly states: infer Children extends Machine.StateSchemas;
+} ? (<Result extends ConstructionResult<BranchTargetResultWithPrefix<AllStates, Children, Path>>>(value: Machine.NodeSchema<Node>["Type"], state: (builder: BranchTargetBuilderWithPrefix<AllStates, Children, Path, Source>) => Result) => Result) & {
+    readonly from: ConstructionSelectorFromCallable<Machine.NodeSchema<Node>["~type.make.in"], BranchTargetBuilderWithPrefix<AllStates, Children, Path, Source>, BranchTargetResultWithPrefix<AllStates, Children, Path>>;
+} & BranchTargetBuilderWithPrefix<AllStates, Children, Path, Source> : ((value: Machine.NodeSchema<Node>["Type"]) => Machine.Target<AllStates, StateIdentifierFromPath<AllStates, Path>>) & FromMethod<[
+    input: Machine.NodeSchema<Node>["~type.make.in"]
+], Machine.Target<AllStates, StateIdentifierFromPath<AllStates, Path>>> : never;
+type BranchTargetBuilderForRoot<States extends Machine.StateSchemas, Root extends ActiveStateKey<States>, Source extends Machine.StateIdentifier<States>> = {
+    readonly [Key in Root]: BranchTargetMethod<States, States, Key, "", Source>;
+};
+type HistoryContainingKey<States extends Machine.StateSchemas> = {
+    readonly [Key in Extract<keyof States, string>]: States[Key] extends Machine.HistoryStateNodeConfig ? Key : States[Key] extends {
+        readonly states: infer Children extends Machine.StateSchemas;
+    } ? [
+        Machine.HistoryIdentifier<Children>
+    ] extends [never] ? never : Key : never;
+}[Extract<keyof States, string>];
+type HistoryTargetBuilderWithPrefix<AllStates extends Machine.StateSchemas, States extends Machine.StateSchemas, Prefix extends string> = {
+    readonly [Key in HistoryContainingKey<States>]: States[Key] extends Machine.HistoryStateNodeConfig ? () => Machine.HistoryTarget<AllStates, Extract<Machine.JoinPath<Prefix, Key>, Machine.HistoryIdentifier<AllStates>>> : States[Key] extends {
+        readonly states: infer Children extends Machine.StateSchemas;
+    } ? HistoryTargetBuilderWithPrefix<AllStates, Children, Machine.JoinPath<Prefix, Key>> : never;
 };
+type HasDirectShallowHistory<States extends Machine.StateSchemas> = {
+    readonly [Key in HistoryStateKey<States>]: States[Key] extends {
+        readonly history: "deep";
+    } ? never : Key;
+}[HistoryStateKey<States>] extends never ? false : true;
+type InitializerClosureForNode<AllStates extends Machine.StateSchemas, Node, Path extends string> = Node extends {
+    readonly type: "parallel";
+    readonly states: infer Children extends Machine.StateSchemas;
+} ? Extract<Path, Machine.StateIdentifier<AllStates>> | InitializerClosuresForChildren<AllStates, Children, Path> : Node extends {
+    readonly states: infer Children extends Machine.StateSchemas;
+    readonly initial: infer Initial;
+} ? Extract<Path, Machine.StateIdentifier<AllStates>> | (Initial extends ActiveStateKey<Children> ? InitializerClosureForNode<AllStates, Children[Initial], Machine.JoinPath<Path, Initial>> : never) : never;
+type InitializerClosuresForChildren<AllStates extends Machine.StateSchemas, States extends Machine.StateSchemas, Prefix extends string> = {
+    readonly [Key in ActiveStateKey<States>]: InitializerClosureForNode<AllStates, States[Key], Machine.JoinPath<Prefix, Key>>;
+}[ActiveStateKey<States>];
+type RequiredHistoryInitializersWithPrefix<AllStates extends Machine.StateSchemas, States extends Machine.StateSchemas, Prefix extends string> = {
+    readonly [Key in ActiveStateKey<States>]: States[Key] extends {
+        readonly states: infer Children extends Machine.StateSchemas;
+    } ? (HasDirectShallowHistory<Children> extends true ? InitializerClosuresForChildren<AllStates, Children, Machine.JoinPath<Prefix, Key>> : never) | RequiredHistoryInitializersWithPrefix<AllStates, Children, Machine.JoinPath<Prefix, Key>> : never;
+}[ActiveStateKey<States>];
 type SpawnRequirements<Requirements> = Exclude<Requirements, Scope.Scope>;
 type SpawnIdError<Options extends SpawnOptions> = "id" extends keyof Options ? Options extends {
     readonly id?: infer Id;
@@ -743,7 +870,7 @@ export declare namespace ChildMachine {
      * @category utility types
      * @since 4.0.0
      */
-    type Ref<Child> = Child extends ChildMachine<string, infer M> ? M extends Machine<infer States, infer Events, any, any, infer E, infer R, infer InitialE, infer InitialR, any, infer Output, any, any, infer InputEvents> ? MachineRef<Machine.Snapshot<States>, Machine.EventOf<InputEvents>, E | ActionError<R> | InfiniteTransitionError | MachineSchemaDecodeError | StoppedError, Output> : never : never;
+    type Ref<Child> = Child extends ChildMachine<string, infer M> ? MachineRef<Machine.Snapshot<Machine.States<M>>, Machine.InputEvent<M>, Machine.Error<M> | ActionError<Machine.Services<M>> | InfiniteTransitionError | MachineSchemaDecodeError | StoppedError, Machine.Output<M>> : never;
     /**
      * Event accepted by the child selected by a descriptor.
      *
@@ -833,6 +960,26 @@ export interface SpawnIdOptions extends SpawnOptions {
  * @since 4.0.0
  */
 export declare namespace Machine {
+    /**
+     * Stable type-level representation carried by every machine definition.
+     *
+     * @internal
+     */
+    interface TypeCarrier<States extends StateSchemas, Events extends ReadonlyArray<TaggedSchema>, Input extends Schema.Top, UnhandledStates extends StateIdentifier<States>, E, R, InitialE, InitialR, FinalStates extends StateIdentifier<States>, Output, Emits extends ReadonlyArray<TaggedSchema>, OutputStates extends StateIdentifier<States>, InputEvents extends ReadonlyArray<TaggedSchema>> {
+        readonly states: States;
+        readonly events: Events;
+        readonly input: Input;
+        readonly unhandledStates: UnhandledStates;
+        readonly error: E;
+        readonly services: R;
+        readonly initialError: InitialE;
+        readonly initialServices: InitialR;
+        readonly finalStates: FinalStates;
+        readonly output: Output;
+        readonly emits: Emits;
+        readonly outputStates: OutputStates;
+        readonly inputEvents: InputEvents;
+    }
     /**
      * Any schema-first machine.
      *
@@ -847,6 +994,8 @@ export declare namespace Machine {
      */
     interface Any extends Pipeable {
         readonly [TypeId]: TypeId;
+        /** @internal */
+        readonly [MachineTypeId]: TypeCarrier<any, any, any, any, any, any, any, any, any, any, any, any, any>;
         readonly states: StateSchemas;
         readonly events: ReadonlyArray<TaggedSchema>;
         readonly internalEvents: ReadonlyArray<TaggedSchema>;
@@ -863,20 +1012,118 @@ export declare namespace Machine {
         /** @internal */
         readonly initial: any;
     }
+    /**
+     * Extracts the state schema tree carried by a machine definition.
+     *
+     * @category utility types
+     * @since 4.0.0
+     */
+    type States<M extends Any> = M[typeof MachineTypeId]["states"];
+    /**
+     * Extracts the complete event schema tuple carried by a machine definition.
+     *
+     * @category utility types
+     * @since 4.0.0
+     */
+    type Events<M extends Any> = M[typeof MachineTypeId]["events"];
+    /**
+     * Extracts the input schema carried by a machine definition.
+     *
+     * @category utility types
+     * @since 4.0.0
+     */
+    type Input<M extends Any> = M[typeof MachineTypeId]["input"];
+    /**
+     * Extracts state paths that do not yet have handlers.
+     *
+     * @category utility types
+     * @since 4.0.0
+     */
+    type UnhandledStates<M extends Any> = M[typeof MachineTypeId]["unhandledStates"];
+    /**
+     * Extracts the runtime error channel carried by a machine definition.
+     *
+     * @category utility types
+     * @since 4.0.0
+     */
+    type Error<M extends Any> = M[typeof MachineTypeId]["error"];
+    /**
+     * Extracts runtime service requirements carried by a machine definition.
+     *
+     * @category utility types
+     * @since 4.0.0
+     */
+    type Services<M extends Any> = M[typeof MachineTypeId]["services"];
+    /**
+     * Extracts the startup error channel carried by a machine definition.
+     *
+     * @category utility types
+     * @since 4.0.0
+     */
+    type InitialError<M extends Any> = M[typeof MachineTypeId]["initialError"];
+    /**
+     * Extracts startup service requirements carried by a machine definition.
+     *
+     * @category utility types
+     * @since 4.0.0
+     */
+    type InitialServices<M extends Any> = M[typeof MachineTypeId]["initialServices"];
+    /**
+     * Extracts final state paths carried by a machine definition.
+     *
+     * @category utility types
+     * @since 4.0.0
+     */
+    type FinalStates<M extends Any> = M[typeof MachineTypeId]["finalStates"];
+    /**
+     * Extracts the terminal output channel carried by a machine definition.
+     *
+     * @category utility types
+     * @since 4.0.0
+     */
+    type Output<M extends Any> = M[typeof MachineTypeId]["output"];
+    /**
+     * Extracts the emitted event schema tuple carried by a machine definition.
+     *
+     * @category utility types
+     * @since 4.0.0
+     */
+    type Emits<M extends Any> = M[typeof MachineTypeId]["emits"];
+    /**
+     * Extracts state paths with implemented output handlers.
+     *
+     * @category utility types
+     * @since 4.0.0
+     */
+    type OutputStates<M extends Any> = M[typeof MachineTypeId]["outputStates"];
+    /**
+     * Extracts the public input event schema tuple carried by a machine definition.
+     *
+     * @category utility types
+     * @since 4.0.0
+     */
+    type InputEvents<M extends Any> = M[typeof MachineTypeId]["inputEvents"];
     /**
      * Extracts the complete event protocol handled inside a machine.
      *
      * @category utility types
      * @since 4.0.0
      */
-    type Event<M extends Any> = M extends Machine<any, infer Events, any, any, any, any, any, any, any, any, any, any, any> ? EventOf<Events> : never;
+    type Event<M extends Any> = EventOf<Events<M>>;
     /**
      * Extracts the event protocol accepted by public machine input boundaries.
      *
      * @category utility types
      * @since 4.0.0
      */
-    type InputEvent<M extends Any> = M extends Machine<any, any, any, any, any, any, any, any, any, any, any, any, infer InputEvents> ? EventOf<InputEvents> : never;
+    type InputEvent<M extends Any> = EventOf<InputEvents<M>>;
+    /**
+     * Extracts the event protocol emitted by a machine.
+     *
+     * @category utility types
+     * @since 4.0.0
+     */
+    type Emit<M extends Any> = EmitOf<Emits<M>>;
     /**
      * A schema whose decoded value contains a `_tag` discriminator.
      *
@@ -931,13 +1178,27 @@ export declare namespace Machine {
         readonly output?: Schema.Top;
         readonly states: StateTree;
     }
+    /**
+     * Pseudo-state that restores the last active configuration of its parent.
+     *
+     * History nodes are transition targets only. They never become active and
+     * therefore do not declare a state value schema or lifecycle handlers.
+     *
+     * @category models
+     * @since 4.0.0
+     */
+    interface HistoryStateNodeConfig {
+        readonly type: "history";
+        /** Defaults to shallow history. */
+        readonly history?: "shallow" | "deep";
+    }
     /**
      * Configuration accepted for an object state node.
      *
      * @category models
      * @since 4.0.0
      */
-    type StateNodeConfig = AtomicStateNodeConfig | CompoundStateNodeConfig | ParallelStateNodeConfig;
+    type StateNodeConfig = AtomicStateNodeConfig | CompoundStateNodeConfig | ParallelStateNodeConfig | HistoryStateNodeConfig;
     /**
      * Object state tree keyed by state path.
      *
@@ -1032,9 +1293,10 @@ export declare namespace Machine {
     interface StateNode {
         readonly path: string;
         readonly key: string;
-        readonly schema: TaggedSchema;
+        readonly schema: TaggedSchema | undefined;
         readonly output: Schema.Top | undefined;
-        readonly type: "atomic" | "compound" | "parallel" | "final";
+        readonly type: "atomic" | "compound" | "parallel" | "final" | "history";
+        readonly history: "shallow" | "deep" | undefined;
         readonly parent: string | undefined;
         readonly children: ReadonlyArray<string>;
         readonly initial: string | undefined;
@@ -1095,10 +1357,47 @@ export declare namespace Machine {
      * @since 4.0.0
      */
     type StateIdentifierWithPrefix<States extends StateSchemas, Prefix extends string = ""> = {
-        readonly [Key in Extract<keyof States, string>]: States[Key] extends {
+        readonly [Key in Extract<keyof States, string>]: States[Key] extends HistoryStateNodeConfig ? never : States[Key] extends {
             readonly states: infer Children;
         } ? Children extends StateSchemas ? JoinPath<Prefix, Key> | StateIdentifierWithPrefix<Children, JoinPath<Prefix, Key>> : JoinPath<Prefix, Key> : JoinPath<Prefix, Key>;
     }[Extract<keyof States, string>];
+    /**
+     * Extracts the transition-only history pseudo-state paths in a definition.
+     *
+     * @category utility types
+     * @since 4.0.0
+     */
+    type HistoryIdentifier<States extends StateSchemas> = HistoryIdentifierWithPrefix<States>;
+    /** @internal */
+    type HistoryIdentifierWithPrefix<States extends StateSchemas, Prefix extends string = ""> = {
+        readonly [Key in Extract<keyof States, string>]: States[Key] extends HistoryStateNodeConfig ? JoinPath<Prefix, Key> : States[Key] extends {
+            readonly states: infer Children extends StateSchemas;
+        } ? HistoryIdentifierWithPrefix<Children, JoinPath<Prefix, Key>> : never;
+    }[Extract<keyof States, string>];
+    /** Active keys directly declared in a state tree. */
+    type ActiveStateKey<States extends StateSchemas> = {
+        readonly [Key in Extract<keyof States, string>]: States[Key] extends HistoryStateNodeConfig ? never : Key;
+    }[Extract<keyof States, string>];
+    /** History pseudo-state keys directly declared in a state tree. */
+    type HistoryStateKey<States extends StateSchemas> = {
+        readonly [Key in Extract<keyof States, string>]: States[Key] extends HistoryStateNodeConfig ? Key : never;
+    }[Extract<keyof States, string>];
+    /**
+     * Active states that must implement implicit initial-value construction for
+     * shallow history restoration.
+     *
+     * @category utility types
+     * @since 4.0.0
+     */
+    type RequiredHistoryInitializers<States extends StateSchemas> = [HistoryIdentifier<States>] extends [never] ? never : Extract<RequiredHistoryInitializersWithPrefix<States, States, "">, StateIdentifier<States>>;
+    /** Active parent states that own one or more history pseudo-states. */
+    type HistoryParentIdentifier<States extends StateSchemas> = HistoryIdentifier<States> extends infer HistoryId ? HistoryId extends string ? Extract<ImmediateParentStateIdentifier<HistoryId>, StateIdentifier<States>> : never : never;
+    /** History defaults and implicit initializers that remain unimplemented. */
+    type MissingHistoryImplementations<States extends StateSchemas, UnhandledStates extends StateIdentifier<States>> = Extract<UnhandledStates, HistoryParentIdentifier<States> | RequiredHistoryInitializers<States>>;
+    /** @internal Readiness proof required by planning and managed execution. */
+    type EnsureHistoryImplementations<States extends StateSchemas, UnhandledStates extends StateIdentifier<States>> = [HistoryIdentifier<States>] extends [never] ? unknown : [MissingHistoryImplementations<States, UnhandledStates>] extends [never] ? unknown : {
+        readonly "~effect/Machine/MissingHistoryImplementation": MissingHistoryImplementations<States, UnhandledStates>;
+    };
     /**
      * Extracts a state-tree node by state path.
      *
@@ -1214,8 +1513,8 @@ export declare namespace Machine {
     } ? OutputByIdentifier<States, StateId> : never;
     type CompoundCompletionOutput<States extends StateSchemas, Children extends StateSchemas, Prefix extends StateIdentifier<States>> = UndefinedIfNever<CompoundCompletionOutputRaw<States, Children, Prefix>>;
     type CompoundCompletionOutputRaw<States extends StateSchemas, Children extends StateSchemas, Prefix extends StateIdentifier<States>> = {
-        readonly [Key in Extract<keyof Children, string>]: DirectFinalCompletionOutput<States, Extract<JoinPath<Prefix, Key>, StateIdentifier<States>>>;
-    }[Extract<keyof Children, string>];
+        readonly [Key in ActiveStateKey<Children>]: DirectFinalCompletionOutput<States, Extract<JoinPath<Prefix, Key>, StateIdentifier<States>>>;
+    }[ActiveStateKey<Children>];
     /**
      * Extracts the output passed when a state node completes.
      *
@@ -1317,6 +1616,12 @@ export declare namespace Machine {
         readonly path: string;
         readonly output?: unknown;
     }
+    /** Encoded values and paths retained by one history pseudo-state. */
+    interface EncodedSnapshotHistoryEntry {
+        readonly mode: "shallow" | "deep";
+        readonly active: ReadonlyArray<string>;
+        readonly values: Readonly<Record<string, unknown>>;
+    }
     /**
      * Normalized data representation of a machine snapshot.
      *
@@ -1333,6 +1638,7 @@ export declare namespace Machine {
         readonly _tag: "MachineSnapshot";
         readonly active: ReadonlyArray<EncodedSnapshotState>;
         readonly completed?: ReadonlyArray<EncodedSnapshotCompletion>;
+        readonly history?: Readonly<Record<string, EncodedSnapshotHistoryEntry>>;
     }
     /**
      * Completed state path and its resolved output value.
@@ -1344,6 +1650,12 @@ export declare namespace Machine {
         readonly path: string;
         readonly output: unknown;
     }
+    /** Decoded values and paths retained by one history pseudo-state. */
+    interface SnapshotHistoryEntry {
+        readonly mode: "shallow" | "deep";
+        readonly active: ReadonlyArray<string>;
+        readonly values: Readonly<Record<string, unknown>>;
+    }
     /**
      * Carries lifecycle metadata required to resume planning from a cloned
      * snapshot.
@@ -1362,6 +1674,7 @@ export declare namespace Machine {
      */
     interface SnapshotMetadata {
         readonly completed?: ReadonlyArray<SnapshotCompletion>;
+        readonly history?: Readonly<Record<string, SnapshotHistoryEntry>>;
     }
     /**
      * Atomic statechart snapshot carrying path identity separately from the
@@ -1418,8 +1731,8 @@ export declare namespace Machine {
      * @since 4.0.0
      */
     type SnapshotWithPrefix<States extends StateSchemas, Prefix extends string> = {
-        readonly [Key in Extract<keyof States, string>]: SnapshotByIdentifierWithPath<States, Key, JoinPath<Prefix, Key>>;
-    }[Extract<keyof States, string>];
+        readonly [Key in ActiveStateKey<States>]: SnapshotByIdentifierWithPath<States, Key, JoinPath<Prefix, Key>>;
+    }[ActiveStateKey<States>];
     /**
      * Extracts child snapshots under a parallel parent path prefix, keyed by
      * child region.
@@ -1428,7 +1741,7 @@ export declare namespace Machine {
      * @since 4.0.0
      */
     type SnapshotRegionsWithPrefix<States extends StateSchemas, Prefix extends string> = {
-        readonly [Key in Extract<keyof States, string>]: SnapshotByIdentifierWithPath<States, Key, JoinPath<Prefix, Key>>;
+        readonly [Key in ActiveStateKey<States>]: SnapshotByIdentifierWithPath<States, Key, JoinPath<Prefix, Key>>;
     };
     /**
      * Extracts a snapshot for a state node while preserving its full path.
@@ -1436,7 +1749,7 @@ export declare namespace Machine {
      * @category utility types
      * @since 4.0.0
      */
-    type SnapshotByIdentifierWithPath<States extends StateSchemas, StateId extends Extract<keyof States, string>, Path extends string> = States[StateId] extends {
+    type SnapshotByIdentifierWithPath<States extends StateSchemas, StateId extends ActiveStateKey<States>, Path extends string> = States[StateId] extends {
         readonly type: "parallel";
         readonly states: infer Children;
     } ? Children extends StateSchemas ? ParallelSnapshot<Path, NodeSchema<States[StateId]>["Type"], SnapshotRegionsWithPrefix<Children, Path>> : AtomicSnapshot<Path, NodeSchema<States[StateId]>["Type"]> : States[StateId] extends {
@@ -1450,8 +1763,8 @@ export declare namespace Machine {
      * @since 4.0.0
      */
     type Snapshot<States extends StateSchemas> = {
-        readonly [StateId in Extract<keyof States, string>]: SnapshotByIdentifier<States, StateId & StateIdentifier<States>>;
-    }[Extract<keyof States, string>];
+        readonly [StateId in ActiveStateKey<States>]: SnapshotByIdentifier<States, StateId & StateIdentifier<States>>;
+    }[ActiveStateKey<States>];
     /**
      * Extracts the root state identifier from a state path.
      *
@@ -1486,6 +1799,19 @@ export declare namespace Machine {
     type EventByTag<Events extends ReadonlyArray<TaggedSchema>, Tag extends TagOf<Events[number]>> = Extract<EventOf<Events>, {
         readonly _tag: Tag;
     }>;
+    /**
+     * Opaque state construction returned by a builder's `.from` method.
+     *
+     * The machine resolves the instruction through the selected state schema
+     * while planning. Its decoded value is intentionally unavailable until
+     * planning succeeds.
+     *
+     * @category models
+     * @since 4.0.0
+     */
+    interface StateConstruction<Result> {
+        readonly [Model.StateConstructionTypeId]: Result;
+    }
     /**
      * Machine-bound target instruction accepted from transition handlers.
      *
@@ -1494,12 +1820,30 @@ export declare namespace Machine {
      */
     interface Target<States extends StateSchemas, StateId extends StateIdentifier<States>> {
         readonly [Model.TargetTypeId]: typeof Model.TargetTypeId;
+        readonly [Model.TargetSnapshotTypeId]?: SnapshotByIdentifier<States, StateId>;
         readonly path: StateId;
         readonly value: StateByIdentifier<States, StateId>;
         readonly values?: Partial<{
             readonly [AncestorStateId in StateIdentifier<States>]: StateByIdentifier<States, AncestorStateId>;
         }>;
     }
+    /**
+     * Transition instruction that restores a history pseudo-state's parent.
+     *
+     * Unlike ordinary targets, history targets carry no state value. The
+     * planner resolves the remembered concrete configuration, or evaluates the
+     * history node's typed default when no record exists.
+     *
+     * @category models
+     * @since 4.0.0
+     */
+    interface HistoryTarget<States extends StateSchemas, HistoryId extends HistoryIdentifier<States>> {
+        readonly [Model.HistoryTargetTypeId]: typeof Model.HistoryTargetTypeId;
+        readonly path: HistoryId;
+        readonly parent: Extract<ParentPath<HistoryId>, StateIdentifier<States>>;
+    }
+    /** Builder containing only history pseudo-state paths. */
+    type HistoryTargetBuilder<States extends StateSchemas> = HistoryTargetBuilderWithPrefix<States, States, "">;
     /**
      * Builder for complete transition snapshots.
      *
@@ -1523,7 +1867,7 @@ export declare namespace Machine {
      * @category utility types
      * @since 4.0.0
      */
-    type LocalTargetBuilder<States extends StateSchemas, Source extends StateIdentifier<States>> = NearestCompoundScope<States, Source> extends infer Scope ? [Scope] extends [never] ? {} : Scope extends StateIdentifier<States> ? LocalTargetBuilderForScope<States, Scope> : {} : {};
+    type LocalTargetBuilder<States extends StateSchemas, Source extends StateIdentifier<States>> = NearestCompoundScope<States, Source> extends infer Scope ? [Scope] extends [never] ? {} : Scope extends StateIdentifier<States> ? LocalTargetBuilderForScope<States, Scope, Source> : {} : {};
     /**
      * Builder for partial transition targets within the active source root.
      *
@@ -1535,7 +1879,7 @@ export declare namespace Machine {
      * @category utility types
      * @since 4.0.0
      */
-    type BranchTargetBuilder<States extends StateSchemas, Source extends StateIdentifier<States>> = BranchTargetBuilderForRoot<States, Extract<RootStateIdentifier<Source>, Extract<keyof States, string>>>;
+    type BranchTargetBuilder<States extends StateSchemas, Source extends StateIdentifier<States>> = BranchTargetBuilderForRoot<States, Extract<RootStateIdentifier<Source>, ActiveStateKey<States>>, Source>;
     /**
      * Machine-bound target builders available in transition contexts.
      *
@@ -1584,6 +1928,8 @@ export declare namespace Machine {
          * @since 4.0.0
          */
         readonly full: FullTargetBuilder<States>;
+        /** Restores a declared shallow or deep history pseudo-state. */
+        readonly history: HistoryTargetBuilder<States>;
     }
     /**
      * Stages an Effect to run after the current machine step is planned.
@@ -1742,7 +2088,7 @@ export declare namespace Machine {
         readonly type: "parallel";
         readonly states: infer Children extends StateSchemas;
     } ? {
-        readonly [Key in Extract<keyof Children, string>]: CompletionOutputByIdentifier<States, Extract<JoinPath<StateId, Key>, StateIdentifier<States>>>;
+        readonly [Key in ActiveStateKey<Children>]: CompletionOutputByIdentifier<States, Extract<JoinPath<StateId, Key>, StateIdentifier<States>>>;
     } : never;
     /**
      * Context passed to a parallel state output function.
@@ -1770,7 +2116,7 @@ export declare namespace Machine {
      * @category utility types
      * @since 4.0.0
      */
-    type InitialResult<States extends StateSchemas, E, R> = Snapshot<States> | Effect.Effect<Snapshot<States>, E, R>;
+    type InitialResult<States extends StateSchemas, E, R> = Snapshot<States> | StateConstruction<Snapshot<States>> | Effect.Effect<Snapshot<States> | StateConstruction<Snapshot<States>>, E, R>;
     /**
      * Return value accepted from transition handlers.
      *
@@ -1783,7 +2129,7 @@ export declare namespace Machine {
      * @category utility types
      * @since 4.0.0
      */
-    type HandlerResult<States extends StateSchemas, E, R> = Snapshot<States> | Target<States, StateIdentifier<States>> | void | Effect.Effect<Snapshot<States> | Target<States, StateIdentifier<States>> | void, E, R>;
+    type HandlerResult<States extends StateSchemas, E, R> = Snapshot<States> | Target<States, StateIdentifier<States>> | HistoryTarget<States, HistoryIdentifier<States>> | StateConstruction<Snapshot<States> | Target<States, StateIdentifier<States>> | HistoryTarget<States, HistoryIdentifier<States>>> | void | Effect.Effect<Snapshot<States> | Target<States, StateIdentifier<States>> | HistoryTarget<States, HistoryIdentifier<States>> | StateConstruction<Snapshot<States> | Target<States, StateIdentifier<States>> | HistoryTarget<States, HistoryIdentifier<States>>> | void, E, R>;
     /**
      * Extracts the union of handler return values from a handler map.
      *
@@ -1819,6 +2165,18 @@ export declare namespace Machine {
      * @since 4.0.0
      */
     type StateActionReturn<Config, Key extends "entry" | "exit"> = Key extends keyof Config ? NonNullable<Config[Key]> extends (...args: any) => infer Ret ? Ret : never : never;
+    /** Extracts the return value from an implicit initial child implementation. */
+    type StateInitialReturn<Config> = Config extends {
+        readonly initial?: infer Initial;
+    } ? NonNullable<Initial> extends (...args: any) => infer Ret ? Ret : never : never;
+    /** Extracts the return values from a state's history defaults. */
+    type HistoryDefaultReturn<Config> = Config extends {
+        readonly history?: infer History;
+    } ? {
+        readonly [Key in keyof NonNullable<History>]: NonNullable<History>[Key] extends {
+            readonly default: (...args: any) => infer Ret;
+        } ? Ret : never;
+    }[keyof NonNullable<History>] : never;
     /**
      * Extracts the return value from an event transition config.
      *
@@ -1970,7 +2328,7 @@ export declare namespace Machine {
      * @category utility types
      * @since 4.0.0
      */
-    type ConfigServices<Config> = Effect.Services<EventHandlerReturn<Config>> | Effect.Services<AlwaysReturn<Config>> | Effect.Services<DoneReturn<Config>> | Effect.Services<StateActionReturn<Config, "entry">> | Effect.Services<StateActionReturn<Config, "exit">> | InvokeRequirements<Config>;
+    type ConfigServices<Config> = Effect.Services<EventHandlerReturn<Config>> | Effect.Services<AlwaysReturn<Config>> | Effect.Services<DoneReturn<Config>> | Effect.Services<StateActionReturn<Config, "entry">> | Effect.Services<StateActionReturn<Config, "exit">> | Effect.Services<StateInitialReturn<Config>> | Effect.Services<HistoryDefaultReturn<Config>> | InvokeRequirements<Config>;
     /**
      * Configuration for invoking a child process while a state is active.
      *
@@ -2011,6 +2369,9 @@ export declare namespace Machine {
             readonly initialError: Types.Covariant<InitialError>;
         };
     }
+    interface InvokeDefinitionValue {
+        readonly [InvokeTypeId]: unknown;
+    }
     /**
      * State-bound configuration for invoked child processes.
      *
@@ -2022,7 +2383,7 @@ export declare namespace Machine {
      * @category models
      * @since 4.0.0
      */
-    type InvokeDefinition<States extends StateSchemas, Events extends ReadonlyArray<TaggedSchema>, Emits extends ReadonlyArray<TaggedSchema>, StateId extends StateIdentifier<States>> = AnyInvokeConfig<any, any, any, any, any, any> | ReadonlyArray<AnyInvokeConfig<any, any, any, any, any, any>> | ((context: InvokeContext<States, Events, Emits, StateId>) => AnyInvokeConfig<any, any, any, any, any, any> | ReadonlyArray<AnyInvokeConfig<any, any, any, any, any, any>>);
+    type InvokeDefinition<States extends StateSchemas, Events extends ReadonlyArray<TaggedSchema>, Emits extends ReadonlyArray<TaggedSchema>, StateId extends StateIdentifier<States>> = InvokeDefinitionValue | ReadonlyArray<InvokeDefinitionValue> | ((context: InvokeContext<States, Events, Emits, StateId>) => InvokeDefinitionValue | ReadonlyArray<InvokeDefinitionValue>);
     type OutputHandlerConfig<States extends StateSchemas, Events extends ReadonlyArray<TaggedSchema>, StateId extends StateIdentifier<States>, Context> = NodeByIdentifier<States, StateId> extends {
         readonly output: Schema.Top;
     } ? {
@@ -2053,7 +2414,37 @@ export declare namespace Machine {
                 readonly transition: (context: HandlerContext<States, Events, Emits, StateId, EventTag, E, R>) => HandlerResult<States, any, any>;
             };
         };
+        readonly initial?: StateInitialHandler<States, Events, Emits, StateId>;
     } & ActiveOutputHandlerConfig<States, Events, StateId>;
+    /** Values supplied when a statechart implicitly enters a state's initial children. */
+    type StateInitialValue<States extends StateSchemas, StateId extends StateIdentifier<States>> = NodeByIdentifier<States, StateId> extends infer Node ? Node extends {
+        readonly type: "parallel";
+        readonly states: infer Children extends StateSchemas;
+    } ? {
+        readonly [Key in ActiveStateKey<Children>]: NodeSchema<Children[Key]>["Type"];
+    } : Node extends {
+        readonly states: infer Children extends StateSchemas;
+        readonly initial: infer Initial;
+    } ? Initial extends ActiveStateKey<Children> ? NodeSchema<Children[Initial]>["Type"] : never : never : never;
+    /** Context passed to an implicit child-state initializer. */
+    type StateInitialContext<States extends StateSchemas, Events extends ReadonlyArray<TaggedSchema>, Emits extends ReadonlyArray<TaggedSchema>, StateId extends StateIdentifier<States>> = StateActionContext<States, Events, Emits, StateId>;
+    /** Initial child value implementation for a compound or parallel state. */
+    type StateInitialHandler<States extends StateSchemas, Events extends ReadonlyArray<TaggedSchema>, Emits extends ReadonlyArray<TaggedSchema>, StateId extends StateIdentifier<States>> = (context: StateInitialContext<States, Events, Emits, StateId>) => StateInitialValue<States, StateId> | Effect.Effect<StateInitialValue<States, StateId>, any, any>;
+    /** Context used only when a history node has no previously captured record. */
+    interface HistoryDefaultContext<States extends StateSchemas, Events extends ReadonlyArray<TaggedSchema>, Emits extends ReadonlyArray<TaggedSchema>, ParentId extends StateIdentifier<States>> extends PlanningCapabilities<EventOf<Events>, EmitOf<Emits>> {
+        readonly event: LifecycleEvent<Events>;
+        readonly runtime: RuntimeEffect<Events, Emits>;
+        readonly target: FullTargetBuilder<States>;
+        readonly parent: ParentId;
+    }
+    /** Typed fallback evaluated when a history node has no record yet. */
+    type HistoryDefaultHandler<States extends StateSchemas, Events extends ReadonlyArray<TaggedSchema>, Emits extends ReadonlyArray<TaggedSchema>, ParentId extends StateIdentifier<States>> = (context: HistoryDefaultContext<States, Events, Emits, ParentId>) => SnapshotByIdentifier<States, ParentId> | StateConstruction<SnapshotByIdentifier<States, ParentId>> | Effect.Effect<SnapshotByIdentifier<States, ParentId> | StateConstruction<SnapshotByIdentifier<States, ParentId>>, any, any>;
+    /** Default implementations keyed by direct history child. */
+    type HistoryDefaultConfig<States extends StateSchemas, Events extends ReadonlyArray<TaggedSchema>, Emits extends ReadonlyArray<TaggedSchema>, ParentId extends StateIdentifier<States>, Children extends StateSchemas> = {
+        readonly [Key in HistoryStateKey<Children>]?: {
+            readonly default: HistoryDefaultHandler<States, Events, Emits, ParentId>;
+        };
+    };
     /**
      * Configuration accepted for a final state.
      *
@@ -2085,19 +2476,21 @@ export declare namespace Machine {
     };
     type HandlerNode<AllStates extends StateSchemas, Node, Events extends ReadonlyArray<TaggedSchema>, Emits extends ReadonlyArray<TaggedSchema>, E, R, StateId extends StateIdentifier<AllStates>> = HandlerConfig<AllStates, Events, Emits, StateId, E, R> & (HandlerChildren<Node> extends infer Children extends StateSchemas ? [Children] extends [never] ? {
         readonly states?: never;
+        readonly history?: never;
     } : {
         readonly states?: HandlerTree<AllStates, Children, Events, Emits, E, R, StateId>;
+        readonly history?: HistoryDefaultConfig<AllStates, Events, Emits, StateId, Children>;
     } : {
         readonly states?: never;
+        readonly history?: never;
     });
     type HandlerTree<AllStates extends StateSchemas, States extends StateSchemas, Events extends ReadonlyArray<TaggedSchema>, Emits extends ReadonlyArray<TaggedSchema>, E, R, Prefix extends string> = {
-        readonly [Key in Extract<keyof States, string>]?: HandlerNode<AllStates, States[Key], Events, Emits, E, R, HandlerStateId<AllStates, JoinPath<Prefix, Key>>>;
+        readonly [Key in ActiveStateKey<States>]?: HandlerNode<AllStates, States[Key], Events, Emits, E, R, HandlerStateId<AllStates, JoinPath<Prefix, Key>>>;
     };
-    type HandlerNodeConfigKey = "always" | "entry" | "exit" | "invoke" | "on" | "onDone" | "output" | "states";
-    type HandlerValidationError<Message extends string> = {
-        readonly "~effect/Machine/HandlerError": Message;
+    type HandlerNodeConfigKey = "always" | "entry" | "exit" | "history" | "initial" | "invoke" | "on" | "onDone" | "output" | "states";
+    type HandlerValidationError<Message extends string, Path extends string, Detail = unknown> = {
+        readonly "~effect/Machine/HandlerError": readonly [message: Message, path: Path, detail: Detail];
     };
-    type HandlerValidationErrors<Validation> = Validation extends HandlerValidationError<any> ? Validation : never;
     type NodeHasDeclaredOutput<States extends StateSchemas, StateId extends StateIdentifier<States>> = NodeByIdentifier<States, StateId> extends {
         readonly output: Schema.Top;
     } ? StateId : never;
@@ -2119,47 +2512,79 @@ export declare namespace Machine {
         readonly [Key in Extract<keyof Children, string>]: RequiredCompletionOutputStates<States, Extract<JoinPath<StateId, Key>, StateIdentifier<States>>>;
     }[Extract<keyof Children, string>] : never;
     type HandlerOutputStates<AllStates extends StateSchemas, StateId extends StateIdentifier<AllStates>, Config> = "output" extends keyof Config ? StateId : never;
-    type UnionToIntersection<Union> = (Union extends unknown ? (argument: Union) => void : never) extends (argument: infer Intersection) => void ? Intersection : never;
-    type HandlerUnknownStateKeyValidation<States extends StateSchemas, Config> = [Exclude<Extract<keyof Config, string>, Extract<keyof States, string>>] extends [never] ? unknown : HandlerValidationError<"Handler tree contains a state key that does not exist">;
-    type HandlerUnknownConfigKeyValidation<Config> = [
-        Exclude<Extract<keyof Config, string>, HandlerNodeConfigKey>
-    ] extends [never] ? unknown : HandlerValidationError<"Handler config contains an unknown key">;
-    type HandlerOnKeyValidation<Events extends ReadonlyArray<TaggedSchema>, Config> = Config extends {
-        readonly on?: infer On;
-    } ? [
-        Exclude<Extract<keyof NonNullable<On>, string>, TagOf<Events[number]>>
-    ] extends [never] ? unknown : HandlerValidationError<"Handler config contains an event key that does not exist"> : unknown;
+    type HandlerUnknownStateKeyValidation<States extends StateSchemas, Prefix extends string, Config, UnknownKeys extends string = Exclude<Extract<keyof Config, string>, Extract<keyof States, string>>> = [UnknownKeys] extends [never] ? unknown : {
+        readonly [Key in UnknownKeys]: HandlerValidationError<"Handler tree contains a state key that does not exist", JoinPath<Prefix, Key>, Key>;
+    };
+    type HandlerUnknownConfigKeyValidation<StateId extends string, Config, UnknownKeys extends string = Exclude<Extract<keyof Config, string>, HandlerNodeConfigKey>> = [UnknownKeys] extends [never] ? unknown : {
+        readonly [Key in UnknownKeys]: HandlerValidationError<"Handler config contains an unknown key", StateId, Key>;
+    };
+    type HandlerOnKeyValidation<Events extends ReadonlyArray<TaggedSchema>, StateId extends string, Config, On = Config extends {
+        readonly on?: infer Current;
+    } ? NonNullable<Current> : never, UnknownKeys extends string = Exclude<Extract<keyof On, string>, TagOf<Events[number]>>> = "on" extends keyof Config ? [UnknownKeys] extends [never] ? unknown : {
+        readonly on: {
+            readonly [Key in UnknownKeys]: HandlerValidationError<"Handler config contains an event key that does not exist", StateId, Key>;
+        };
+    } : unknown;
     type HandlerDepth = readonly [unknown, unknown, unknown, unknown, unknown, unknown, unknown, unknown];
     type HandlerNextDepth<Depth extends ReadonlyArray<unknown>> = Depth extends readonly [unknown, ...infer Rest extends ReadonlyArray<unknown>] ? Rest : readonly [];
-    type HandlerChildrenValidation<AllStates extends StateSchemas, Node, Events extends ReadonlyArray<TaggedSchema>, Prefix extends string, Config, AvailableOutputStates extends StateIdentifier<AllStates>, Depth extends ReadonlyArray<unknown>> = "states" extends keyof Config ? Depth extends readonly [] ? HandlerValidationError<"Handler nesting exceeds the supported depth"> : Config extends {
+    type HandlerChildrenValidation<AllStates extends StateSchemas, Node, Events extends ReadonlyArray<TaggedSchema>, Emits extends ReadonlyArray<TaggedSchema>, Prefix extends string, Config, AvailableOutputStates extends StateIdentifier<AllStates>, Depth extends ReadonlyArray<unknown>> = "states" extends keyof Config ? Depth extends readonly [] ? {
+        readonly states: HandlerValidationError<"Handler nesting exceeds the supported depth", Prefix>;
+    } : Config extends {
         readonly states?: infer ChildrenConfig;
-    } ? HandlerChildren<Node> extends infer Children extends StateSchemas ? [
-        Children
-    ] extends [never] ? HandlerValidationError<"Handler config contains child states for a state that has no children"> : HandlerTreeValidation<AllStates, Children, Events, Prefix, NonNullable<ChildrenConfig>, AvailableOutputStates, HandlerNextDepth<Depth>> : HandlerValidationError<"Handler config contains child states for a state that has no children"> : unknown : unknown;
+    } ? HandlerChildren<Node> extends infer Children extends StateSchemas ? [Children] extends [never] ? {
+        readonly states: HandlerValidationError<"Handler config contains child states for a state that has no children", Prefix>;
+    } : HandlerTreeValidation<AllStates, Children, Events, Emits, Prefix, NonNullable<ChildrenConfig>, AvailableOutputStates, HandlerNextDepth<Depth>> extends infer Validation ? unknown extends Validation ? unknown : {
+        readonly states: Validation;
+    } : never : {
+        readonly states: HandlerValidationError<"Handler config contains child states for a state that has no children", Prefix>;
+    } : unknown : unknown;
     type HandlerOutputRequirementValidation<AllStates extends StateSchemas, StateId extends StateIdentifier<AllStates>, AvailableOutputStates extends StateIdentifier<AllStates>, Config> = ("onDone" extends keyof Config ? [
         Exclude<RequiredCompletionOutputStates<AllStates, StateId>, AvailableOutputStates>
-    ] extends [never] ? unknown : HandlerValidationError<"Handler config is missing an output implementation required by onDone"> : unknown) & ("output" extends keyof Config ? NodeByIdentifier<AllStates, StateId> extends {
+    ] extends [never] ? unknown : {
+        readonly onDone: HandlerValidationError<"Handler config is missing an output implementation required by onDone", StateId, Exclude<RequiredCompletionOutputStates<AllStates, StateId>, AvailableOutputStates>>;
+    } : unknown) & ("output" extends keyof Config ? NodeByIdentifier<AllStates, StateId> extends {
         readonly type: "parallel";
     } ? [
         Exclude<RequiredParallelOutputStates<AllStates, StateId>, AvailableOutputStates>
-    ] extends [never] ? unknown : HandlerValidationError<"Handler config is missing a region output implementation required by parallel output"> : unknown : unknown);
-    type HandlerNodeValidation<AllStates extends StateSchemas, Node, Events extends ReadonlyArray<TaggedSchema>, StateId extends StateIdentifier<AllStates>, Config, AvailableOutputStates extends StateIdentifier<AllStates>, Depth extends ReadonlyArray<unknown>> = HandlerUnknownConfigKeyValidation<Config> & HandlerOnKeyValidation<Events, Config> & HandlerInvokeOutputValidation<Events, Config> & HandlerInvokeEmitsValidation<Events, Config> & HandlerInvokeSnapshotValidation<Events, Config> & HandlerChildrenValidation<AllStates, Node, Events, StateId, Config, AvailableOutputStates, Depth> & HandlerOutputRequirementValidation<AllStates, StateId, AvailableOutputStates, Config>;
-    type HandlerInvokeOutputValidation<Events extends ReadonlyArray<TaggedSchema>, Config> = [InvokeReturn<Config>] extends [never] ? unknown : [Exclude<InvokeOutput<InvokeReturn<Config>>, EventOf<Events> | void>] extends [never] ? unknown : HandlerValidationError<"Invoked child output must be a machine event or void">;
-    type HandlerInvokeEmitsValidation<Events extends ReadonlyArray<TaggedSchema>, Config> = [InvokeReturn<Config>] extends [never] ? unknown : [Exclude<InvokeEmits<InvokeReturn<Config>>, EventOf<Events>>] extends [never] ? unknown : HandlerValidationError<"Invoked child emits events not accepted by the parent machine">;
-    type HandlerInvokeSnapshotValidation<Events extends ReadonlyArray<TaggedSchema>, Config> = [InvokeReturn<Config>] extends [never] ? unknown : IsAny<InvokeSnapshotEvent<InvokeReturn<Config>>> extends true ? unknown : [Exclude<InvokeSnapshotEvent<InvokeReturn<Config>>, EventOf<Events> | undefined>] extends [never] ? unknown : HandlerValidationError<"Invoked child snapshot mapper must return a machine event or undefined">;
-    type HandlerTreeNodeValidationErrors<AllStates extends StateSchemas, States extends StateSchemas, Events extends ReadonlyArray<TaggedSchema>, Prefix extends string, Config, AvailableOutputStates extends StateIdentifier<AllStates>, Depth extends ReadonlyArray<unknown>> = {
-        readonly [Key in Extract<Extract<keyof Config, string>, Extract<keyof States, string>>]: HandlerValidationErrors<HandlerNodeValidation<AllStates, States[Key], Events, HandlerStateId<AllStates, JoinPath<Prefix, Key>>, Config[Key], AvailableOutputStates, Depth>>;
-    }[Extract<Extract<keyof Config, string>, Extract<keyof States, string>>];
-    type HandlerTreeNodeValidations<AllStates extends StateSchemas, States extends StateSchemas, Events extends ReadonlyArray<TaggedSchema>, Prefix extends string, Config, AvailableOutputStates extends StateIdentifier<AllStates>, Depth extends ReadonlyArray<unknown>> = HandlerTreeNodeValidationErrors<AllStates, States, Events, Prefix, Config, AvailableOutputStates, Depth> extends infer Errors ? [Errors] extends [never] ? unknown : UnionToIntersection<Errors> : never;
-    type HandlerTreeValidation<AllStates extends StateSchemas, States extends StateSchemas, Events extends ReadonlyArray<TaggedSchema>, Prefix extends string, Config, AvailableOutputStates extends StateIdentifier<AllStates>, Depth extends ReadonlyArray<unknown> = HandlerDepth> = HandlerUnknownStateKeyValidation<States, Config> & HandlerTreeNodeValidations<AllStates, States, Events, Prefix, Config, AvailableOutputStates, Depth>;
+    ] extends [never] ? unknown : {
+        readonly output: HandlerValidationError<"Handler config is missing a region output implementation required by parallel output", StateId, Exclude<RequiredParallelOutputStates<AllStates, StateId>, AvailableOutputStates>>;
+    } : unknown : unknown);
+    type HandlerNodeValidation<AllStates extends StateSchemas, Node, Events extends ReadonlyArray<TaggedSchema>, Emits extends ReadonlyArray<TaggedSchema>, StateId extends StateIdentifier<AllStates>, Config, AvailableOutputStates extends StateIdentifier<AllStates>, Depth extends ReadonlyArray<unknown>> = HandlerUnknownConfigKeyValidation<StateId, Config> & HandlerOnKeyValidation<Events, StateId, Config> & HandlerInvokeOutputValidation<Events, StateId, Config> & HandlerInvokeEmitsValidation<Events, StateId, Config> & HandlerInvokeSnapshotValidation<Events, StateId, Config> & HandlerChildrenValidation<AllStates, Node, Events, Emits, StateId, Config, AvailableOutputStates, Depth> & HandlerOutputRequirementValidation<AllStates, StateId, AvailableOutputStates, Config> & HandlerRuntimeValidation<Events, Emits, StateId, Config>;
+    type HandlerInvokeOutputValidation<Events extends ReadonlyArray<TaggedSchema>, StateId extends string, Config> = [InvokeReturn<Config>] extends [never] ? unknown : [Exclude<InvokeOutput<InvokeReturn<Config>>, EventOf<Events> | void>] extends [never] ? unknown : {
+        readonly invoke: HandlerValidationError<"Invoked child output must be a machine event or void", StateId, Exclude<InvokeOutput<InvokeReturn<Config>>, EventOf<Events> | void>>;
+    };
+    type HandlerInvokeEmitsValidation<Events extends ReadonlyArray<TaggedSchema>, StateId extends string, Config> = [InvokeReturn<Config>] extends [never] ? unknown : [Exclude<InvokeEmits<InvokeReturn<Config>>, EventOf<Events>>] extends [never] ? unknown : {
+        readonly invoke: HandlerValidationError<"Invoked child emits events not accepted by the parent machine", StateId, Exclude<InvokeEmits<InvokeReturn<Config>>, EventOf<Events>>>;
+    };
+    type HandlerInvokeSnapshotValidation<Events extends ReadonlyArray<TaggedSchema>, StateId extends string, Config> = [InvokeReturn<Config>] extends [never] ? unknown : IsAny<InvokeSnapshotEvent<InvokeReturn<Config>>> extends true ? unknown : [Exclude<InvokeSnapshotEvent<InvokeReturn<Config>>, EventOf<Events> | undefined>] extends [never] ? unknown : {
+        readonly invoke: HandlerValidationError<"Invoked child snapshot mapper must return a machine event or undefined", StateId, Exclude<InvokeSnapshotEvent<InvokeReturn<Config>>, EventOf<Events> | undefined>>;
+    };
+    type HandlerRuntimeValidation<Events extends ReadonlyArray<TaggedSchema>, Emits extends ReadonlyArray<TaggedSchema>, StateId extends string, Config, Incompatible = IncompatibleRuntime<ConfigServices<HandlerConfigPart<Config>>, EventOf<Events>, EmitOf<Emits>>> = [Incompatible] extends [never] ? unknown : HandlerValidationError<"Handler config requires an incompatible machine runtime", StateId, Incompatible>;
+    type HandlerTreeNodeValidationMap<AllStates extends StateSchemas, States extends StateSchemas, Events extends ReadonlyArray<TaggedSchema>, Emits extends ReadonlyArray<TaggedSchema>, Prefix extends string, Config, AvailableOutputStates extends StateIdentifier<AllStates>, Depth extends ReadonlyArray<unknown>> = {
+        readonly [Key in Extract<Extract<keyof Config, string>, Extract<keyof States, string>>]?: HandlerNodeValidation<AllStates, States[Key], Events, Emits, HandlerStateId<AllStates, JoinPath<Prefix, Key>>, Config[Key], AvailableOutputStates, Depth>;
+    };
+    type HandlerTreeNodeValidationErrors<Validations> = {
+        readonly [Key in keyof Validations as unknown extends Validations[Key] ? never : Key]?: Validations[Key];
+    };
+    type HandlerTreeNodeValidations<AllStates extends StateSchemas, States extends StateSchemas, Events extends ReadonlyArray<TaggedSchema>, Emits extends ReadonlyArray<TaggedSchema>, Prefix extends string, Config, AvailableOutputStates extends StateIdentifier<AllStates>, Depth extends ReadonlyArray<unknown>> = HandlerTreeNodeValidationMap<AllStates, States, Events, Emits, Prefix, Config, AvailableOutputStates, Depth> extends infer Validations ? HandlerTreeNodeValidationErrors<Validations> extends infer Errors ? keyof Errors extends never ? unknown : Errors : never : never;
+    type HandlerTreeValidation<AllStates extends StateSchemas, States extends StateSchemas, Events extends ReadonlyArray<TaggedSchema>, Emits extends ReadonlyArray<TaggedSchema>, Prefix extends string, Config, AvailableOutputStates extends StateIdentifier<AllStates>, Depth extends ReadonlyArray<unknown> = HandlerDepth> = HandlerUnknownStateKeyValidation<States, Prefix, Config> & HandlerTreeNodeValidations<AllStates, States, Events, Emits, Prefix, Config, AvailableOutputStates, Depth>;
     type HandlerNodeChildrenConfig<Config> = "states" extends keyof Config ? Config extends {
         readonly states?: infer Children;
     } ? NonNullable<Children> : never : never;
     type HandlerTreeStateIds<AllStates extends StateSchemas, States extends StateSchemas, Prefix extends string, Config, Depth extends ReadonlyArray<unknown> = HandlerDepth> = {
-        readonly [Key in Extract<Extract<keyof Config, string>, Extract<keyof States, string>>]: HandlerStateId<AllStates, JoinPath<Prefix, Key>> | HandlerNodeChildStateIds<AllStates, States[Key], HandlerStateId<AllStates, JoinPath<Prefix, Key>>, Config[Key], Depth>;
+        readonly [Key in Extract<Extract<keyof Config, string>, Extract<keyof States, string>>]: HandlerImplementedStateId<AllStates, States[Key], HandlerStateId<AllStates, JoinPath<Prefix, Key>>, Config[Key]> | HandlerNodeChildStateIds<AllStates, States[Key], HandlerStateId<AllStates, JoinPath<Prefix, Key>>, Config[Key], Depth>;
     }[Extract<Extract<keyof Config, string>, Extract<keyof States, string>>];
+    type HandlerHasRequiredInitial<AllStates extends StateSchemas, StateId extends StateIdentifier<AllStates>, Config> = StateId extends RequiredHistoryInitializers<AllStates> ? "initial" extends keyof Config ? true : false : true;
+    type HandlerHasRequiredHistoryDefaults<Node, Config> = Node extends {
+        readonly states: infer Children extends StateSchemas;
+    } ? [HistoryStateKey<Children>] extends [never] ? true : Config extends {
+        readonly history?: infer HistoryConfig;
+    } ? [
+        Exclude<HistoryStateKey<Children>, Extract<keyof NonNullable<HistoryConfig>, string>>
+    ] extends [never] ? true : false : false : true;
+    type HandlerImplementedStateId<AllStates extends StateSchemas, Node, StateId extends StateIdentifier<AllStates>, Config> = [HistoryIdentifier<AllStates>] extends [never] ? StateId : HandlerHasRequiredInitial<AllStates, StateId, Config> extends true ? HandlerHasRequiredHistoryDefaults<Node, Config> extends true ? StateId : never : never;
     type HandlerNodeChildStateIds<AllStates extends StateSchemas, Node, Prefix extends string, Config, Depth extends ReadonlyArray<unknown>> = Depth extends readonly [] ? never : HandlerChildren<Node> extends infer Children extends StateSchemas ? [Children] extends [never] ? never : HandlerTreeStateIds<AllStates, Children, Prefix, HandlerNodeChildrenConfig<Config>, HandlerNextDepth<Depth>> : never;
-    type HandlerConfigError<Config> = Effect.Error<EventHandlerReturn<Config>> | Effect.Error<AlwaysReturn<Config>> | Effect.Error<DoneReturn<Config>> | Effect.Error<StateActionReturn<Config, "entry">> | Effect.Error<StateActionReturn<Config, "exit">> | InvokeError<Config>;
+    type HandlerConfigError<Config> = Effect.Error<EventHandlerReturn<Config>> | Effect.Error<AlwaysReturn<Config>> | Effect.Error<DoneReturn<Config>> | Effect.Error<StateActionReturn<Config, "entry">> | Effect.Error<StateActionReturn<Config, "exit">> | Effect.Error<StateInitialReturn<Config>> | Effect.Error<HistoryDefaultReturn<Config>> | InvokeError<Config>;
     type HandlerTreeError<AllStates extends StateSchemas, Events extends ReadonlyArray<TaggedSchema>, Emits extends ReadonlyArray<TaggedSchema>, States extends StateSchemas, Prefix extends string, Config, Depth extends ReadonlyArray<unknown> = HandlerDepth> = {
         readonly [Key in Extract<Extract<keyof Config, string>, Extract<keyof States, string>>]: HandlerConfigError<HandlerConfigPart<Config[Key]>> | HandlerNodeChildError<AllStates, Events, Emits, States[Key], HandlerStateId<AllStates, JoinPath<Prefix, Key>>, Config[Key], Depth>;
     }[Extract<Extract<keyof Config, string>, Extract<keyof States, string>>];
@@ -2186,7 +2611,7 @@ export declare namespace Machine {
      * @since 4.0.0
      */
     interface Handler<States extends StateSchemas, Events extends ReadonlyArray<TaggedSchema>, Emits extends ReadonlyArray<TaggedSchema>, Input extends Schema.Top, UnhandledStates extends StateIdentifier<States>, E, R, InitialE, InitialR, FinalStates extends StateIdentifier<States>, Output, OutputStates extends StateIdentifier<States>, InputEvents extends ReadonlyArray<TaggedSchema>> {
-        <const Config extends HandlerTree<States, States, Events, Emits, E, R, "">>(config: Config & HandlerTreeValidation<States, States, Events, "", Config, OutputStates | Extract<HandlerTreeOutputStates<States, States, "", Config>, StateIdentifier<States>>> & EnsureCompatibleRuntime<HandlerTreeServices<States, Events, Emits, States, "", Config>, EventOf<Events>, EmitOf<Emits>>): HandleTreeResult<States, Events, Emits, Input, UnhandledStates, E, R, InitialE, InitialR, FinalStates, Output, OutputStates, InputEvents, Config>;
+        <const Config extends HandlerTree<States, States, Events, Emits, E, R, "">>(config: Config & HandlerTreeValidation<States, States, Events, Emits, "", NoInfer<Config>, OutputStates | Extract<HandlerTreeOutputStates<States, States, "", NoInfer<Config>>, StateIdentifier<States>>>): HandleTreeResult<States, Events, Emits, Input, UnhandledStates, E, R, InitialE, InitialR, FinalStates, Output, OutputStates, InputEvents, Config>;
     }
     /**
      * Any state config.
@@ -2269,14 +2694,30 @@ export declare const isFinal: <const States extends Machine.StateSchemas, const
  * Machine.make({
  *   states: States.states,
  *   events: [],
- *   initial: () => States.initial.idle(new Idle({}))
+ *   initial: () => States.initial.idle.from()
  * })
  * ```
  *
  * @category constructors
  * @since 4.0.0
  */
-export declare const defineStates: <const States extends Machine.StateSchemas>(states: States & DefineStateTreeInput<NoInfer<States>>, ..._validation: ValidateDefinedStates<NoInfer<States>>) => Machine.DefinedStates<States>;
+export declare const defineStates: DefineStates;
+type MakeConfig<States extends Machine.StateSchemas, InputEvents extends ReadonlyArray<Machine.TaggedSchema>, Emits extends ReadonlyArray<Machine.TaggedSchema>, Input extends Schema.Top, InitialE, InitialR, InternalEvents extends ReadonlyArray<Machine.TaggedSchema>> = {
+    readonly id?: string;
+    readonly states: States & DefineStateTreeInput<NoInfer<States>>;
+    readonly events: InputEvents & ValidateInputEventProtocol<NoInfer<InputEvents>>;
+    readonly internalEvents?: InternalEvents & ValidateInternalEventProtocol<NoInfer<InputEvents>, NoInfer<InternalEvents>>;
+    readonly emits?: Emits;
+    readonly input?: Input;
+    readonly initial: (...args: [...Machine.InputArgs<Input>]) => Machine.InitialResult<States, InitialE, InitialR>;
+};
+type MakeResult<States extends Machine.StateSchemas, InputEvents extends ReadonlyArray<Machine.TaggedSchema>, Emits extends ReadonlyArray<Machine.TaggedSchema>, Input extends Schema.Top, InitialE, InitialR, InternalEvents extends ReadonlyArray<Machine.TaggedSchema>> = Machine<States, readonly [...InputEvents, ...InternalEvents], Input, Machine.StateIdentifier<States>, never, never, InitialE, InitialR, Machine.FinalStateFromDefinition<States>, Machine.TerminalOutput<States>, Emits, never, InputEvents>;
+interface Make {
+    <const States extends Machine.StateSchemas, const InputEvents extends ReadonlyArray<Machine.TaggedSchema>, const Emits extends ReadonlyArray<Machine.TaggedSchema> = readonly [], const Input extends Schema.Top = typeof Schema.Void, InitialE = never, InitialR = never, const InternalEvents extends ReadonlyArray<Machine.TaggedSchema> = readonly []>(config: MakeConfig<States, InputEvents, Emits, Input, InitialE, InitialR, InternalEvents>, ..._validation: ValidateDefinedStates<NoInfer<States>>): MakeResult<States, InputEvents, Emits, Input, InitialE, InitialR, InternalEvents>;
+    <const States extends Machine.StateSchemas, const InputEvents extends ReadonlyArray<Machine.TaggedSchema>, const Emits extends ReadonlyArray<Machine.TaggedSchema> = readonly [], const Input extends Schema.Top = typeof Schema.Void, InitialE = never, InitialR = never, const InternalEvents extends ReadonlyArray<Machine.TaggedSchema> = readonly []>(config: Omit<MakeConfig<States, InputEvents, Emits, Input, InitialE, InitialR, InternalEvents>, "states"> & {
+        readonly states: InvalidDefinedStateTreeInput<States>;
+    }): never;
+}
 /**
  * Creates a schema-first machine definition.
  *
@@ -2327,17 +2768,7 @@ export declare const defineStates: <const States extends Machine.StateSchemas>(s
  * @category constructors
  * @since 4.0.0
  */
-export declare const make: <const States extends Machine.StateSchemas, const InputEvents extends ReadonlyArray<Machine.TaggedSchema>, const Emits extends ReadonlyArray<Machine.TaggedSchema> = readonly [], const Input extends Schema.Top = typeof Schema.Void, InitialE = never, InitialR = never, const InternalEvents extends ReadonlyArray<Machine.TaggedSchema> = readonly []>(config: {
-    readonly id?: string;
-    readonly states: States & DefineStateTreeInput<NoInfer<States>>;
-    /** Events accepted through public machine input boundaries. */
-    readonly events: InputEvents;
-    /** Events delivered only by machine-local logic. */
-    readonly internalEvents?: InternalEvents;
-    readonly emits?: Emits;
-    readonly input?: Input;
-    readonly initial: (...args: [...Machine.InputArgs<Input>]) => Machine.InitialResult<States, InitialE, InitialR>;
-}, ..._validation: [...ValidateDefinedStates<NoInfer<States>>, ...ValidateEventProtocol<NoInfer<InputEvents>, NoInfer<InternalEvents>>]) => Machine<States, readonly [...InputEvents, ...InternalEvents], Input, Machine.StateIdentifier<States>, never, never, InitialE, InitialR, Machine.FinalStateFromDefinition<States>, Machine.TerminalOutput<States>, Emits, never, InputEvents>;
+export declare const make: Make;
 /**
  * Encodes a decoded machine snapshot into a normalized data representation.
  *
@@ -2553,12 +2984,12 @@ type InvokeMachineInput<Input extends Schema.Top> = Input extends typeof Schema.
  */
 export declare const invokeMachine: {
     <const States extends Machine.StateSchemas, const Events extends ReadonlyArray<Machine.TaggedSchema>, const Emits extends ReadonlyArray<Machine.TaggedSchema> = readonly [], const Input extends Schema.Top = typeof Schema.Void, UnhandledStates extends Machine.StateIdentifier<States> = Machine.StateIdentifier<States>, E = never, R = never, InitialE = never, InitialR = never, FinalStates extends Machine.StateIdentifier<States> = never, Output = never, SnapshotEvent = never, DoneEvent = never, Id extends string = string, OutputStates extends Machine.StateIdentifier<States> = never, InputEvents extends ReadonlyArray<Machine.TaggedSchema> = Events>(config: {
-        readonly child: ChildMachine<Id, Machine<States, Events, Input, UnhandledStates, E, R, InitialE, InitialR, FinalStates, Output, Emits, OutputStates, InputEvents> & Machine.EnsureOutputImplementations<States, OutputStates>>;
+        readonly child: ChildMachine<Id, Machine<States, Events, Input, UnhandledStates, E, R, InitialE, InitialR, FinalStates, Output, Emits, OutputStates, InputEvents> & Machine.EnsureOutputImplementations<States, OutputStates> & Machine.EnsureHistoryImplementations<States, UnhandledStates>>;
         readonly snapshot?: (context: Machine.InvokeSnapshotContext<Machine.Snapshot<States>, E | ActionError<R> | InfiniteTransitionError | MachineSchemaDecodeError | StoppedError, Output>) => SnapshotEvent | undefined;
         readonly onDone: (context: Machine.InvokeDoneContext<Output>) => DoneEvent | undefined;
     } & InvokeMachineInput<Input>): Machine.InvokeConfig<any, any, any, any, SnapshotEvent, Machine.Snapshot<States>, Machine.EventOf<InputEvents>, E | ActionError<R> | InfiniteTransitionError | MachineSchemaDecodeError | StoppedError, ExcludeCompatibleRuntime<Exclude<ExecutionServices<InitialR | R>, internalRuntime.MachineRuntime>, Machine.EventOf<Events>, Machine.EmitOf<Emits>>, Output, InitialE | E | ActionError<InitialR | R> | InfiniteTransitionError | MachineSchemaDecodeError | StartupError | StoppedError, Machine.EmitOf<Emits>, DoneEvent>;
     <const States extends Machine.StateSchemas, const Events extends ReadonlyArray<Machine.TaggedSchema>, const Emits extends ReadonlyArray<Machine.TaggedSchema> = readonly [], const Input extends Schema.Top = typeof Schema.Void, UnhandledStates extends Machine.StateIdentifier<States> = Machine.StateIdentifier<States>, E = never, R = never, InitialE = never, InitialR = never, FinalStates extends Machine.StateIdentifier<States> = never, Output = never, SnapshotEvent = never, Id extends string = string, OutputStates extends Machine.StateIdentifier<States> = never, InputEvents extends ReadonlyArray<Machine.TaggedSchema> = Events>(config: {
-        readonly child: ChildMachine<Id, Machine<States, Events, Input, UnhandledStates, E, R, InitialE, InitialR, FinalStates, Output, Emits, OutputStates, InputEvents> & Machine.EnsureOutputImplementations<States, OutputStates>>;
+        readonly child: ChildMachine<Id, Machine<States, Events, Input, UnhandledStates, E, R, InitialE, InitialR, FinalStates, Output, Emits, OutputStates, InputEvents> & Machine.EnsureOutputImplementations<States, OutputStates> & Machine.EnsureHistoryImplementations<States, UnhandledStates>>;
         readonly snapshot?: (context: Machine.InvokeSnapshotContext<Machine.Snapshot<States>, E | ActionError<R> | InfiniteTransitionError | MachineSchemaDecodeError | StoppedError, Output>) => SnapshotEvent | undefined;
         readonly onDone?: never;
     } & InvokeMachineInput<Input>): Machine.InvokeConfig<any, any, any, any, SnapshotEvent, Machine.Snapshot<States>, Machine.EventOf<InputEvents>, E | ActionError<R> | InfiniteTransitionError | MachineSchemaDecodeError | StoppedError, ExcludeCompatibleRuntime<Exclude<ExecutionServices<InitialR | R>, internalRuntime.MachineRuntime>, Machine.EventOf<Events>, Machine.EmitOf<Emits>>, Output, InitialE | E | ActionError<InitialR | R> | InfiniteTransitionError | MachineSchemaDecodeError | StartupError | StoppedError, Machine.EmitOf<Emits>>;
@@ -2584,7 +3015,7 @@ export declare const invokeMachine: {
  * @category constructors
  * @since 4.0.0
  */
-export declare const planInitial: <const States extends Machine.StateSchemas, const Events extends ReadonlyArray<Machine.TaggedSchema>, const Emits extends ReadonlyArray<Machine.TaggedSchema> = readonly [], const Input extends Schema.Top = typeof Schema.Void, UnhandledStates extends Machine.StateIdentifier<States> = Machine.StateIdentifier<States>, E = never, R = never, InitialE = never, InitialR = never, FinalStates extends Machine.StateIdentifier<States> = never, Output = never, OutputStates extends Machine.StateIdentifier<States> = never, InputEvents extends ReadonlyArray<Machine.TaggedSchema> = Events>(machine: Machine<States, Events, Input, UnhandledStates, E, R, InitialE, InitialR, FinalStates, Output, Emits, OutputStates, InputEvents> & Machine.EnsureOutputImplementations<States, OutputStates>, ...args: [...Machine.InputArgs<Input>]) => Effect.Effect<{
+export declare const planInitial: <const States extends Machine.StateSchemas, const Events extends ReadonlyArray<Machine.TaggedSchema>, const Emits extends ReadonlyArray<Machine.TaggedSchema> = readonly [], const Input extends Schema.Top = typeof Schema.Void, UnhandledStates extends Machine.StateIdentifier<States> = Machine.StateIdentifier<States>, E = never, R = never, InitialE = never, InitialR = never, FinalStates extends Machine.StateIdentifier<States> = never, Output = never, OutputStates extends Machine.StateIdentifier<States> = never, InputEvents extends ReadonlyArray<Machine.TaggedSchema> = Events>(machine: Machine<States, Events, Input, UnhandledStates, E, R, InitialE, InitialR, FinalStates, Output, Emits, OutputStates, InputEvents> & Machine.EnsureOutputImplementations<States, OutputStates> & Machine.EnsureHistoryImplementations<States, UnhandledStates>, ...args: [...Machine.InputArgs<Input>]) => Effect.Effect<{
     readonly state: Machine.Snapshot<States>;
     readonly actions: ReadonlyArray<Effect.Effect<void, ActionError<InitialR | R>, ActionServices<InitialR | R>>>;
     readonly emittedEvents: ReadonlyArray<Machine.EmitOf<Emits>>;
@@ -2625,7 +3056,7 @@ export declare const enabled: <const States extends Machine.StateSchemas, const
  * @category combinators
  * @since 4.0.0
  */
-export declare const plan: <const States extends Machine.StateSchemas, const Events extends ReadonlyArray<Machine.TaggedSchema>, const Emits extends ReadonlyArray<Machine.TaggedSchema> = readonly [], const Input extends Schema.Top = typeof Schema.Void, UnhandledStates extends Machine.StateIdentifier<States> = Machine.StateIdentifier<States>, E = never, R = never, InitialE = never, InitialR = never, FinalStates extends Machine.StateIdentifier<States> = never, Output = never, OutputStates extends Machine.StateIdentifier<States> = never, InputEvents extends ReadonlyArray<Machine.TaggedSchema> = Events>(machine: Machine<States, Events, Input, UnhandledStates, E, R, InitialE, InitialR, FinalStates, Output, Emits, OutputStates, InputEvents> & Machine.EnsureOutputImplementations<States, OutputStates>, state: Machine.Snapshot<States>, event: Machine.EventOf<InputEvents>) => Effect.Effect<{
+export declare const plan: <const States extends Machine.StateSchemas, const Events extends ReadonlyArray<Machine.TaggedSchema>, const Emits extends ReadonlyArray<Machine.TaggedSchema> = readonly [], const Input extends Schema.Top = typeof Schema.Void, UnhandledStates extends Machine.StateIdentifier<States> = Machine.StateIdentifier<States>, E = never, R = never, InitialE = never, InitialR = never, FinalStates extends Machine.StateIdentifier<States> = never, Output = never, OutputStates extends Machine.StateIdentifier<States> = never, InputEvents extends ReadonlyArray<Machine.TaggedSchema> = Events>(machine: Machine<States, Events, Input, UnhandledStates, E, R, InitialE, InitialR, FinalStates, Output, Emits, OutputStates, InputEvents> & Machine.EnsureOutputImplementations<States, OutputStates> & Machine.EnsureHistoryImplementations<States, UnhandledStates>, state: Machine.Snapshot<States>, event: Machine.EventOf<InputEvents>) => Effect.Effect<{
     readonly next: Machine.Snapshot<States>;
     readonly actions: ReadonlyArray<Effect.Effect<void, ActionError<R>, ActionServices<R>>>;
     readonly emittedEvents: ReadonlyArray<Machine.EmitOf<Emits>>;
@@ -2899,5 +3330,5 @@ export declare const watch: <State, Event, Error = never, Output = never>(ref: M
  * @category constructors
  * @since 4.0.0
  */
-export declare const start: <const States extends Machine.StateSchemas, const Events extends ReadonlyArray<Machine.TaggedSchema>, const Emits extends ReadonlyArray<Machine.TaggedSchema> = readonly [], const Input extends Schema.Top = typeof Schema.Void, UnhandledStates extends Machine.StateIdentifier<States> = Machine.StateIdentifier<States>, E = never, R = never, InitialE = never, InitialR = never, FinalStates extends Machine.StateIdentifier<States> = never, Output = never, OutputStates extends Machine.StateIdentifier<States> = never, InputEvents extends ReadonlyArray<Machine.TaggedSchema> = Events>(machine: Machine<States, Events, Input, UnhandledStates, E, R, InitialE, InitialR, FinalStates, Output, Emits, OutputStates, InputEvents> & Machine.EnsureOutputImplementations<States, OutputStates>, ...args: [...Machine.InputArgs<Input>]) => Effect.Effect<MachineRef<Machine.Snapshot<States>, Machine.EventOf<InputEvents>, E | ActionError<R> | InfiniteTransitionError | MachineSchemaDecodeError | StoppedError, Output>, InitialE | E | ActionError<InitialR | R> | InfiniteTransitionError | MachineSchemaDecodeError | StartupError | StoppedError, ExcludeCompatibleRuntime<ExecutionServices<InitialR | R>, Machine.EventOf<Events>, Machine.EmitOf<Emits>>>;
+export declare const start: <const States extends Machine.StateSchemas, const Events extends ReadonlyArray<Machine.TaggedSchema>, const Emits extends ReadonlyArray<Machine.TaggedSchema> = readonly [], const Input extends Schema.Top = typeof Schema.Void, UnhandledStates extends Machine.StateIdentifier<States> = Machine.StateIdentifier<States>, E = never, R = never, InitialE = never, InitialR = never, FinalStates extends Machine.StateIdentifier<States> = never, Output = never, OutputStates extends Machine.StateIdentifier<States> = never, InputEvents extends ReadonlyArray<Machine.TaggedSchema> = Events>(machine: Machine<States, Events, Input, UnhandledStates, E, R, InitialE, InitialR, FinalStates, Output, Emits, OutputStates, InputEvents> & Machine.EnsureOutputImplementations<States, OutputStates> & Machine.EnsureHistoryImplementations<States, UnhandledStates>, ...args: [...Machine.InputArgs<Input>]) => Effect.Effect<MachineRef<Machine.Snapshot<States>, Machine.EventOf<InputEvents>, E | ActionError<R> | InfiniteTransitionError | MachineSchemaDecodeError | StoppedError, Output>, InitialE | E | ActionError<InitialR | R> | InfiniteTransitionError | MachineSchemaDecodeError | StartupError | StoppedError, ExcludeCompatibleRuntime<ExecutionServices<InitialR | R>, Machine.EventOf<Events>, Machine.EmitOf<Emits>>>;
 //# sourceMappingURL=Machine.d.ts.map