@dreamboard-games/sdk 0.4.0-alpha.4 → 0.4.0-alpha.6

package/dist/{index.d-BL3bT5lt.d.ts → index.d-DMASeF6M.d.ts}

@@ -128,9 +128,10 @@ type ReduceResultReject = {
 type ReduceResultAccept = {
     "kind": "accept";
     "state": ReducerSessionState;
-    "terminal"?: TerminalOutcome;
+    "terminal"?: GameOutcome;
     "effects": Array<Effect>;
     "continuations": ContinuationMap;
+    "events": Array<GameEvent>;
 };
 type DispatchTrace = DispatchTraceAcceptedClientInput | DispatchTraceAppliedEffect | DispatchTraceRngConsumption;
 type DispatchTraceAcceptedClientInput = {
@@ -156,13 +157,48 @@ type DispatchResultReject = {
 type DispatchResultAccept = {
     "kind": "accept";
     "state": ReducerSessionState;
-    "terminal"?: TerminalOutcome;
+    "terminal"?: GameOutcome;
     "trace": Array<DispatchTrace>;
+    "events": Array<GameEvent>;
 };
-type TerminalOutcome = {
-    "winnerPlayerId"?: string;
-    "finalScores"?: Record<string, number>;
-    "reason": string;
+type GameEventDetail = {
+    "label": string;
+    "value": string | number | boolean;
+};
+type SystemActionEvent = {
+    "kind": "systemAction";
+    "procedureId": string;
+    "title": string;
+    "summary"?: string;
+    "details"?: Array<GameEventDetail>;
+};
+type GameEvent = SystemActionEvent;
+type OutcomeResult = "win" | "draw" | "loss" | "eliminated";
+type OutcomeScoreComponent = {
+    "id": string;
+    "label": string;
+    "value": number;
+};
+type OutcomeTieBreak = {
+    "id": string;
+    "label": string;
+    "value": number | string;
+};
+type OutcomeStanding = {
+    "playerId": string;
+    "rank": number;
+    "result": OutcomeResult;
+    "score"?: number;
+    "scoreBreakdown"?: Array<OutcomeScoreComponent>;
+    "tieBreaks"?: Array<OutcomeTieBreak>;
+};
+type GameOutcomeReason = {
+    "code": string;
+    "message"?: string;
+};
+type GameOutcome = {
+    "reason": GameOutcomeReason;
+    "standings": Array<OutcomeStanding>;
 };
 type ReducerRuntimeLogEntry = ReducerRuntimeLogEntryAcceptedClientInput | ReducerRuntimeLogEntryAppliedEffect | ReducerRuntimeLogEntryRngConsumption | ReducerRuntimeLogEntryStateCommit;
 type ReducerRuntimeLogEntryAcceptedClientInput = {
@@ -235,11 +271,19 @@ type wire_EffectRollDie = EffectRollDie;
 type wire_EffectShufflePlayerZone = EffectShufflePlayerZone;
 type wire_EffectShuffleSharedZone = EffectShuffleSharedZone;
 type wire_EffectTransition = EffectTransition;
+type wire_GameEvent = GameEvent;
+type wire_GameEventDetail = GameEventDetail;
 type wire_GameInput = GameInput;
 type wire_GameInputInteraction = GameInputInteraction;
+type wire_GameOutcome = GameOutcome;
+type wire_GameOutcomeReason = GameOutcomeReason;
 type wire_InitializePhaseRequest = InitializePhaseRequest;
 type wire_InitializeRequest = InitializeRequest;
 type wire_JsonValue = JsonValue;
+type wire_OutcomeResult = OutcomeResult;
+type wire_OutcomeScoreComponent = OutcomeScoreComponent;
+type wire_OutcomeStanding = OutcomeStanding;
+type wire_OutcomeTieBreak = OutcomeTieBreak;
 type wire_ProjectSeatsDynamicRequest = ProjectSeatsDynamicRequest;
 type wire_ReduceRequest = ReduceRequest;
 type wire_ReduceResult = ReduceResult;
@@ -265,11 +309,11 @@ type wire_RuntimeSimultaneousSubmission = RuntimeSimultaneousSubmission;
 type wire_SeatProjection = SeatProjection;
 type wire_SeatProjectionBundle = SeatProjectionBundle;
 type wire_SimultaneousPhaseProjection = SimultaneousPhaseProjection;
-type wire_TerminalOutcome = TerminalOutcome;
+type wire_SystemActionEvent = SystemActionEvent;
 type wire_TransitionRecord = TransitionRecord;
 type wire_ValidateInputRequest = ValidateInputRequest;
 declare namespace wire {
-  export type { wire_BoardStaticProjection as BoardStaticProjection, wire_ContinuationMap as ContinuationMap, wire_ContinuationToken as ContinuationToken, wire_DispatchRequest as DispatchRequest, wire_DispatchResult as DispatchResult, wire_DispatchResultAccept as DispatchResultAccept, wire_DispatchResultReject as DispatchResultReject, wire_DispatchTrace as DispatchTrace, wire_DispatchTraceAcceptedClientInput as DispatchTraceAcceptedClientInput, wire_DispatchTraceAppliedEffect as DispatchTraceAppliedEffect, wire_DispatchTraceRngConsumption as DispatchTraceRngConsumption, wire_Effect as Effect, wire_EffectId as EffectId, wire_EffectRollDie as EffectRollDie, wire_EffectShufflePlayerZone as EffectShufflePlayerZone, wire_EffectShuffleSharedZone as EffectShuffleSharedZone, wire_EffectTransition as EffectTransition, wire_GameInput as GameInput, wire_GameInputInteraction as GameInputInteraction, wire_InitializePhaseRequest as InitializePhaseRequest, wire_InitializeRequest as InitializeRequest, wire_JsonValue as JsonValue, wire_ProjectSeatsDynamicRequest as ProjectSeatsDynamicRequest, wire_ReduceRequest as ReduceRequest, wire_ReduceResult as ReduceResult, wire_ReduceResultAccept as ReduceResultAccept, wire_ReduceResultReject as ReduceResultReject, wire_ReducerContractVersion as ReducerContractVersion, wire_ReducerDomainState as ReducerDomainState, wire_ReducerFlowState as ReducerFlowState, wire_ReducerInputValidationResult as ReducerInputValidationResult, wire_ReducerRuntimeLogEntry as ReducerRuntimeLogEntry, wire_ReducerRuntimeLogEntryAcceptedClientInput as ReducerRuntimeLogEntryAcceptedClientInput, wire_ReducerRuntimeLogEntryAppliedEffect as ReducerRuntimeLogEntryAppliedEffect, wire_ReducerRuntimeLogEntryRngConsumption as ReducerRuntimeLogEntryRngConsumption, wire_ReducerRuntimeLogEntryStateCommit as ReducerRuntimeLogEntryStateCommit, wire_ReducerRuntimeState as ReducerRuntimeState, wire_ReducerSessionMeta as ReducerSessionMeta, wire_ReducerSessionState as ReducerSessionState, wire_ReducerSetupSelection as ReducerSetupSelection, wire_RngState as RngState, wire_RuntimeSimultaneousCurrent as RuntimeSimultaneousCurrent, wire_RuntimeSimultaneousState as RuntimeSimultaneousState, wire_RuntimeSimultaneousSubmission as RuntimeSimultaneousSubmission, wire_SeatProjection as SeatProjection, wire_SeatProjectionBundle as SeatProjectionBundle, wire_SimultaneousPhaseProjection as SimultaneousPhaseProjection, wire_TerminalOutcome as TerminalOutcome, wire_TransitionRecord as TransitionRecord, wire_ValidateInputRequest as ValidateInputRequest };
+  export type { wire_BoardStaticProjection as BoardStaticProjection, wire_ContinuationMap as ContinuationMap, wire_ContinuationToken as ContinuationToken, wire_DispatchRequest as DispatchRequest, wire_DispatchResult as DispatchResult, wire_DispatchResultAccept as DispatchResultAccept, wire_DispatchResultReject as DispatchResultReject, wire_DispatchTrace as DispatchTrace, wire_DispatchTraceAcceptedClientInput as DispatchTraceAcceptedClientInput, wire_DispatchTraceAppliedEffect as DispatchTraceAppliedEffect, wire_DispatchTraceRngConsumption as DispatchTraceRngConsumption, wire_Effect as Effect, wire_EffectId as EffectId, wire_EffectRollDie as EffectRollDie, wire_EffectShufflePlayerZone as EffectShufflePlayerZone, wire_EffectShuffleSharedZone as EffectShuffleSharedZone, wire_EffectTransition as EffectTransition, wire_GameEvent as GameEvent, wire_GameEventDetail as GameEventDetail, wire_GameInput as GameInput, wire_GameInputInteraction as GameInputInteraction, wire_GameOutcome as GameOutcome, wire_GameOutcomeReason as GameOutcomeReason, wire_InitializePhaseRequest as InitializePhaseRequest, wire_InitializeRequest as InitializeRequest, wire_JsonValue as JsonValue, wire_OutcomeResult as OutcomeResult, wire_OutcomeScoreComponent as OutcomeScoreComponent, wire_OutcomeStanding as OutcomeStanding, wire_OutcomeTieBreak as OutcomeTieBreak, wire_ProjectSeatsDynamicRequest as ProjectSeatsDynamicRequest, wire_ReduceRequest as ReduceRequest, wire_ReduceResult as ReduceResult, wire_ReduceResultAccept as ReduceResultAccept, wire_ReduceResultReject as ReduceResultReject, wire_ReducerContractVersion as ReducerContractVersion, wire_ReducerDomainState as ReducerDomainState, wire_ReducerFlowState as ReducerFlowState, wire_ReducerInputValidationResult as ReducerInputValidationResult, wire_ReducerRuntimeLogEntry as ReducerRuntimeLogEntry, wire_ReducerRuntimeLogEntryAcceptedClientInput as ReducerRuntimeLogEntryAcceptedClientInput, wire_ReducerRuntimeLogEntryAppliedEffect as ReducerRuntimeLogEntryAppliedEffect, wire_ReducerRuntimeLogEntryRngConsumption as ReducerRuntimeLogEntryRngConsumption, wire_ReducerRuntimeLogEntryStateCommit as ReducerRuntimeLogEntryStateCommit, wire_ReducerRuntimeState as ReducerRuntimeState, wire_ReducerSessionMeta as ReducerSessionMeta, wire_ReducerSessionState as ReducerSessionState, wire_ReducerSetupSelection as ReducerSetupSelection, wire_RngState as RngState, wire_RuntimeSimultaneousCurrent as RuntimeSimultaneousCurrent, wire_RuntimeSimultaneousState as RuntimeSimultaneousState, wire_RuntimeSimultaneousSubmission as RuntimeSimultaneousSubmission, wire_SeatProjection as SeatProjection, wire_SeatProjectionBundle as SeatProjectionBundle, wire_SimultaneousPhaseProjection as SimultaneousPhaseProjection, wire_SystemActionEvent as SystemActionEvent, wire_TransitionRecord as TransitionRecord, wire_ValidateInputRequest as ValidateInputRequest };
 }
 
 declare const ReducerContractVersionSchema: z.ZodString;
@@ -677,11 +721,98 @@ declare const ReduceResultRejectSchema: z.ZodObject<{
     errorCode: z.ZodString;
     message: z.ZodOptional<z.ZodString>;
 }, z.core.$strict>;
-declare const TerminalOutcomeSchema: z.ZodObject<{
-    winnerPlayerId: z.ZodOptional<z.ZodString>;
-    finalScores: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodNumber>>;
-    reason: z.ZodString;
+declare const GameOutcomeReasonSchema: z.ZodObject<{
+    code: z.ZodString;
+    message: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+declare const OutcomeResultSchema: z.ZodEnum<{
+    win: "win";
+    draw: "draw";
+    loss: "loss";
+    eliminated: "eliminated";
+}>;
+declare const OutcomeScoreComponentSchema: z.ZodObject<{
+    id: z.ZodString;
+    label: z.ZodString;
+    value: z.ZodNumber;
+}, z.core.$strict>;
+declare const OutcomeTieBreakSchema: z.ZodObject<{
+    id: z.ZodString;
+    label: z.ZodString;
+    value: z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>;
+}, z.core.$strict>;
+declare const OutcomeStandingSchema: z.ZodObject<{
+    playerId: z.ZodString;
+    rank: z.ZodNumber;
+    result: z.ZodEnum<{
+        win: "win";
+        draw: "draw";
+        loss: "loss";
+        eliminated: "eliminated";
+    }>;
+    score: z.ZodOptional<z.ZodNumber>;
+    scoreBreakdown: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        label: z.ZodString;
+        value: z.ZodNumber;
+    }, z.core.$strict>>>;
+    tieBreaks: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        label: z.ZodString;
+        value: z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>;
+    }, z.core.$strict>>>;
+}, z.core.$strict>;
+declare const GameOutcomeSchema: z.ZodObject<{
+    reason: z.ZodObject<{
+        code: z.ZodString;
+        message: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>;
+    standings: z.ZodArray<z.ZodObject<{
+        playerId: z.ZodString;
+        rank: z.ZodNumber;
+        result: z.ZodEnum<{
+            win: "win";
+            draw: "draw";
+            loss: "loss";
+            eliminated: "eliminated";
+        }>;
+        score: z.ZodOptional<z.ZodNumber>;
+        scoreBreakdown: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            label: z.ZodString;
+            value: z.ZodNumber;
+        }, z.core.$strict>>>;
+        tieBreaks: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            label: z.ZodString;
+            value: z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>;
+        }, z.core.$strict>>>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+declare const GameEventDetailSchema: z.ZodObject<{
+    label: z.ZodString;
+    value: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>;
+}, z.core.$strict>;
+declare const SystemActionEventSchema: z.ZodObject<{
+    kind: z.ZodLiteral<"systemAction">;
+    procedureId: z.ZodString;
+    title: z.ZodString;
+    summary: z.ZodOptional<z.ZodString>;
+    details: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        label: z.ZodString;
+        value: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>;
+    }, z.core.$strict>>>;
 }, z.core.$strict>;
+declare const GameEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    kind: z.ZodLiteral<"systemAction">;
+    procedureId: z.ZodString;
+    title: z.ZodString;
+    summary: z.ZodOptional<z.ZodString>;
+    details: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        label: z.ZodString;
+        value: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>;
+    }, z.core.$strict>>>;
+}, z.core.$strict>], "kind">;
 declare const ReduceResultAcceptSchema: z.ZodObject<{
     kind: z.ZodLiteral<"accept">;
     state: z.ZodObject<{
@@ -728,9 +859,31 @@ declare const ReduceResultAcceptSchema: z.ZodObject<{
         }, z.core.$strict>;
     }, z.core.$strict>;
     terminal: z.ZodOptional<z.ZodObject<{
-        winnerPlayerId: z.ZodOptional<z.ZodString>;
-        finalScores: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodNumber>>;
-        reason: z.ZodString;
+        reason: z.ZodObject<{
+            code: z.ZodString;
+            message: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>;
+        standings: z.ZodArray<z.ZodObject<{
+            playerId: z.ZodString;
+            rank: z.ZodNumber;
+            result: z.ZodEnum<{
+                win: "win";
+                draw: "draw";
+                loss: "loss";
+                eliminated: "eliminated";
+            }>;
+            score: z.ZodOptional<z.ZodNumber>;
+            scoreBreakdown: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                id: z.ZodString;
+                label: z.ZodString;
+                value: z.ZodNumber;
+            }, z.core.$strict>>>;
+            tieBreaks: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                id: z.ZodString;
+                label: z.ZodString;
+                value: z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>;
+            }, z.core.$strict>>>;
+        }, z.core.$strict>>;
     }, z.core.$strict>>;
     effects: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
         effectId: z.ZodString;
@@ -754,6 +907,16 @@ declare const ReduceResultAcceptSchema: z.ZodObject<{
         id: z.ZodString;
         data: z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>;
     }, z.core.$strict>>;
+    events: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"systemAction">;
+        procedureId: z.ZodString;
+        title: z.ZodString;
+        summary: z.ZodOptional<z.ZodString>;
+        details: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            label: z.ZodString;
+            value: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>;
+        }, z.core.$strict>>>;
+    }, z.core.$strict>], "kind">>;
 }, z.core.$strict>;
 declare const ReduceResultSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     kind: z.ZodLiteral<"reject">;
@@ -805,9 +968,31 @@ declare const ReduceResultSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
         }, z.core.$strict>;
     }, z.core.$strict>;
     terminal: z.ZodOptional<z.ZodObject<{
-        winnerPlayerId: z.ZodOptional<z.ZodString>;
-        finalScores: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodNumber>>;
-        reason: z.ZodString;
+        reason: z.ZodObject<{
+            code: z.ZodString;
+            message: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>;
+        standings: z.ZodArray<z.ZodObject<{
+            playerId: z.ZodString;
+            rank: z.ZodNumber;
+            result: z.ZodEnum<{
+                win: "win";
+                draw: "draw";
+                loss: "loss";
+                eliminated: "eliminated";
+            }>;
+            score: z.ZodOptional<z.ZodNumber>;
+            scoreBreakdown: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                id: z.ZodString;
+                label: z.ZodString;
+                value: z.ZodNumber;
+            }, z.core.$strict>>>;
+            tieBreaks: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                id: z.ZodString;
+                label: z.ZodString;
+                value: z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>;
+            }, z.core.$strict>>>;
+        }, z.core.$strict>>;
     }, z.core.$strict>>;
     effects: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
         effectId: z.ZodString;
@@ -831,6 +1016,16 @@ declare const ReduceResultSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
         id: z.ZodString;
         data: z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>;
     }, z.core.$strict>>;
+    events: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"systemAction">;
+        procedureId: z.ZodString;
+        title: z.ZodString;
+        summary: z.ZodOptional<z.ZodString>;
+        details: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            label: z.ZodString;
+            value: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>;
+        }, z.core.$strict>>>;
+    }, z.core.$strict>], "kind">>;
 }, z.core.$strict>], "kind">;
 declare const DispatchTraceAcceptedClientInputSchema: z.ZodObject<{
     kind: z.ZodLiteral<"acceptedClientInput">;
@@ -959,9 +1154,31 @@ declare const DispatchResultAcceptSchema: z.ZodObject<{
         }, z.core.$strict>;
     }, z.core.$strict>;
     terminal: z.ZodOptional<z.ZodObject<{
-        winnerPlayerId: z.ZodOptional<z.ZodString>;
-        finalScores: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodNumber>>;
-        reason: z.ZodString;
+        reason: z.ZodObject<{
+            code: z.ZodString;
+            message: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>;
+        standings: z.ZodArray<z.ZodObject<{
+            playerId: z.ZodString;
+            rank: z.ZodNumber;
+            result: z.ZodEnum<{
+                win: "win";
+                draw: "draw";
+                loss: "loss";
+                eliminated: "eliminated";
+            }>;
+            score: z.ZodOptional<z.ZodNumber>;
+            scoreBreakdown: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                id: z.ZodString;
+                label: z.ZodString;
+                value: z.ZodNumber;
+            }, z.core.$strict>>>;
+            tieBreaks: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                id: z.ZodString;
+                label: z.ZodString;
+                value: z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>;
+            }, z.core.$strict>>>;
+        }, z.core.$strict>>;
     }, z.core.$strict>>;
     trace: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
         kind: z.ZodLiteral<"acceptedClientInput">;
@@ -1000,6 +1217,16 @@ declare const DispatchResultAcceptSchema: z.ZodObject<{
         operation: z.ZodString;
         traceEntry: z.ZodString;
     }, z.core.$strict>], "kind">>;
+    events: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"systemAction">;
+        procedureId: z.ZodString;
+        title: z.ZodString;
+        summary: z.ZodOptional<z.ZodString>;
+        details: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            label: z.ZodString;
+            value: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>;
+        }, z.core.$strict>>>;
+    }, z.core.$strict>], "kind">>;
 }, z.core.$strict>;
 declare const DispatchResultSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     kind: z.ZodLiteral<"reject">;
@@ -1051,9 +1278,31 @@ declare const DispatchResultSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
         }, z.core.$strict>;
     }, z.core.$strict>;
     terminal: z.ZodOptional<z.ZodObject<{
-        winnerPlayerId: z.ZodOptional<z.ZodString>;
-        finalScores: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodNumber>>;
-        reason: z.ZodString;
+        reason: z.ZodObject<{
+            code: z.ZodString;
+            message: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>;
+        standings: z.ZodArray<z.ZodObject<{
+            playerId: z.ZodString;
+            rank: z.ZodNumber;
+            result: z.ZodEnum<{
+                win: "win";
+                draw: "draw";
+                loss: "loss";
+                eliminated: "eliminated";
+            }>;
+            score: z.ZodOptional<z.ZodNumber>;
+            scoreBreakdown: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                id: z.ZodString;
+                label: z.ZodString;
+                value: z.ZodNumber;
+            }, z.core.$strict>>>;
+            tieBreaks: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                id: z.ZodString;
+                label: z.ZodString;
+                value: z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>;
+            }, z.core.$strict>>>;
+        }, z.core.$strict>>;
     }, z.core.$strict>>;
     trace: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
         kind: z.ZodLiteral<"acceptedClientInput">;
@@ -1092,6 +1341,16 @@ declare const DispatchResultSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
         operation: z.ZodString;
         traceEntry: z.ZodString;
     }, z.core.$strict>], "kind">>;
+    events: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"systemAction">;
+        procedureId: z.ZodString;
+        title: z.ZodString;
+        summary: z.ZodOptional<z.ZodString>;
+        details: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            label: z.ZodString;
+            value: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>;
+        }, z.core.$strict>>>;
+    }, z.core.$strict>], "kind">>;
 }, z.core.$strict>], "kind">;
 declare const ReducerRuntimeLogEntryAcceptedClientInputSchema: z.ZodObject<{
     kind: z.ZodLiteral<"acceptedClientInput">;
@@ -1371,11 +1630,19 @@ declare const zod_EffectSchema: typeof EffectSchema;
 declare const zod_EffectShufflePlayerZoneSchema: typeof EffectShufflePlayerZoneSchema;
 declare const zod_EffectShuffleSharedZoneSchema: typeof EffectShuffleSharedZoneSchema;
 declare const zod_EffectTransitionSchema: typeof EffectTransitionSchema;
+declare const zod_GameEventDetailSchema: typeof GameEventDetailSchema;
+declare const zod_GameEventSchema: typeof GameEventSchema;
 declare const zod_GameInputInteractionSchema: typeof GameInputInteractionSchema;
 declare const zod_GameInputSchema: typeof GameInputSchema;
+declare const zod_GameOutcomeReasonSchema: typeof GameOutcomeReasonSchema;
+declare const zod_GameOutcomeSchema: typeof GameOutcomeSchema;
 declare const zod_InitializePhaseRequestSchema: typeof InitializePhaseRequestSchema;
 declare const zod_InitializeRequestSchema: typeof InitializeRequestSchema;
 declare const zod_JsonValueSchema: typeof JsonValueSchema;
+declare const zod_OutcomeResultSchema: typeof OutcomeResultSchema;
+declare const zod_OutcomeScoreComponentSchema: typeof OutcomeScoreComponentSchema;
+declare const zod_OutcomeStandingSchema: typeof OutcomeStandingSchema;
+declare const zod_OutcomeTieBreakSchema: typeof OutcomeTieBreakSchema;
 declare const zod_ProjectSeatsDynamicRequestSchema: typeof ProjectSeatsDynamicRequestSchema;
 declare const zod_ReduceRequestSchema: typeof ReduceRequestSchema;
 declare const zod_ReduceResultAcceptSchema: typeof ReduceResultAcceptSchema;
@@ -1401,11 +1668,11 @@ declare const zod_RuntimeSimultaneousSubmissionSchema: typeof RuntimeSimultaneou
 declare const zod_SeatProjectionBundleSchema: typeof SeatProjectionBundleSchema;
 declare const zod_SeatProjectionSchema: typeof SeatProjectionSchema;
 declare const zod_SimultaneousPhaseProjectionSchema: typeof SimultaneousPhaseProjectionSchema;
-declare const zod_TerminalOutcomeSchema: typeof TerminalOutcomeSchema;
+declare const zod_SystemActionEventSchema: typeof SystemActionEventSchema;
 declare const zod_TransitionRecordSchema: typeof TransitionRecordSchema;
 declare const zod_ValidateInputRequestSchema: typeof ValidateInputRequestSchema;
 declare namespace zod {
-  export { zod_BoardStaticProjectionSchema as BoardStaticProjectionSchema, zod_ContinuationMapSchema as ContinuationMapSchema, zod_ContinuationTokenSchema as ContinuationTokenSchema, zod_DispatchRequestSchema as DispatchRequestSchema, zod_DispatchResultAcceptSchema as DispatchResultAcceptSchema, zod_DispatchResultRejectSchema as DispatchResultRejectSchema, zod_DispatchResultSchema as DispatchResultSchema, zod_DispatchTraceAcceptedClientInputSchema as DispatchTraceAcceptedClientInputSchema, zod_DispatchTraceAppliedEffectSchema as DispatchTraceAppliedEffectSchema, zod_DispatchTraceRngConsumptionSchema as DispatchTraceRngConsumptionSchema, zod_DispatchTraceSchema as DispatchTraceSchema, zod_EffectIdSchema as EffectIdSchema, zod_EffectRollDieSchema as EffectRollDieSchema, zod_EffectSchema as EffectSchema, zod_EffectShufflePlayerZoneSchema as EffectShufflePlayerZoneSchema, zod_EffectShuffleSharedZoneSchema as EffectShuffleSharedZoneSchema, zod_EffectTransitionSchema as EffectTransitionSchema, zod_GameInputInteractionSchema as GameInputInteractionSchema, zod_GameInputSchema as GameInputSchema, zod_InitializePhaseRequestSchema as InitializePhaseRequestSchema, zod_InitializeRequestSchema as InitializeRequestSchema, zod_JsonValueSchema as JsonValueSchema, zod_ProjectSeatsDynamicRequestSchema as ProjectSeatsDynamicRequestSchema, zod_ReduceRequestSchema as ReduceRequestSchema, zod_ReduceResultAcceptSchema as ReduceResultAcceptSchema, zod_ReduceResultRejectSchema as ReduceResultRejectSchema, zod_ReduceResultSchema as ReduceResultSchema, zod_ReducerContractVersionSchema as ReducerContractVersionSchema, zod_ReducerDomainStateSchema as ReducerDomainStateSchema, zod_ReducerFlowStateSchema as ReducerFlowStateSchema, zod_ReducerInputValidationResultSchema as ReducerInputValidationResultSchema, zod_ReducerRuntimeLogEntryAcceptedClientInputSchema as ReducerRuntimeLogEntryAcceptedClientInputSchema, zod_ReducerRuntimeLogEntryAppliedEffectSchema as ReducerRuntimeLogEntryAppliedEffectSchema, zod_ReducerRuntimeLogEntryRngConsumptionSchema as ReducerRuntimeLogEntryRngConsumptionSchema, zod_ReducerRuntimeLogEntrySchema as ReducerRuntimeLogEntrySchema, zod_ReducerRuntimeLogEntryStateCommitSchema as ReducerRuntimeLogEntryStateCommitSchema, zod_ReducerRuntimeStateSchema as ReducerRuntimeStateSchema, zod_ReducerSessionMetaSchema as ReducerSessionMetaSchema, zod_ReducerSessionStateSchema as ReducerSessionStateSchema, zod_ReducerSetupSelectionSchema as ReducerSetupSelectionSchema, zod_RngStateSchema as RngStateSchema, zod_RuntimeSimultaneousCurrentSchema as RuntimeSimultaneousCurrentSchema, zod_RuntimeSimultaneousStateSchema as RuntimeSimultaneousStateSchema, zod_RuntimeSimultaneousSubmissionSchema as RuntimeSimultaneousSubmissionSchema, zod_SeatProjectionBundleSchema as SeatProjectionBundleSchema, zod_SeatProjectionSchema as SeatProjectionSchema, zod_SimultaneousPhaseProjectionSchema as SimultaneousPhaseProjectionSchema, zod_TerminalOutcomeSchema as TerminalOutcomeSchema, zod_TransitionRecordSchema as TransitionRecordSchema, zod_ValidateInputRequestSchema as ValidateInputRequestSchema };
+  export { zod_BoardStaticProjectionSchema as BoardStaticProjectionSchema, zod_ContinuationMapSchema as ContinuationMapSchema, zod_ContinuationTokenSchema as ContinuationTokenSchema, zod_DispatchRequestSchema as DispatchRequestSchema, zod_DispatchResultAcceptSchema as DispatchResultAcceptSchema, zod_DispatchResultRejectSchema as DispatchResultRejectSchema, zod_DispatchResultSchema as DispatchResultSchema, zod_DispatchTraceAcceptedClientInputSchema as DispatchTraceAcceptedClientInputSchema, zod_DispatchTraceAppliedEffectSchema as DispatchTraceAppliedEffectSchema, zod_DispatchTraceRngConsumptionSchema as DispatchTraceRngConsumptionSchema, zod_DispatchTraceSchema as DispatchTraceSchema, zod_EffectIdSchema as EffectIdSchema, zod_EffectRollDieSchema as EffectRollDieSchema, zod_EffectSchema as EffectSchema, zod_EffectShufflePlayerZoneSchema as EffectShufflePlayerZoneSchema, zod_EffectShuffleSharedZoneSchema as EffectShuffleSharedZoneSchema, zod_EffectTransitionSchema as EffectTransitionSchema, zod_GameEventDetailSchema as GameEventDetailSchema, zod_GameEventSchema as GameEventSchema, zod_GameInputInteractionSchema as GameInputInteractionSchema, zod_GameInputSchema as GameInputSchema, zod_GameOutcomeReasonSchema as GameOutcomeReasonSchema, zod_GameOutcomeSchema as GameOutcomeSchema, zod_InitializePhaseRequestSchema as InitializePhaseRequestSchema, zod_InitializeRequestSchema as InitializeRequestSchema, zod_JsonValueSchema as JsonValueSchema, zod_OutcomeResultSchema as OutcomeResultSchema, zod_OutcomeScoreComponentSchema as OutcomeScoreComponentSchema, zod_OutcomeStandingSchema as OutcomeStandingSchema, zod_OutcomeTieBreakSchema as OutcomeTieBreakSchema, zod_ProjectSeatsDynamicRequestSchema as ProjectSeatsDynamicRequestSchema, zod_ReduceRequestSchema as ReduceRequestSchema, zod_ReduceResultAcceptSchema as ReduceResultAcceptSchema, zod_ReduceResultRejectSchema as ReduceResultRejectSchema, zod_ReduceResultSchema as ReduceResultSchema, zod_ReducerContractVersionSchema as ReducerContractVersionSchema, zod_ReducerDomainStateSchema as ReducerDomainStateSchema, zod_ReducerFlowStateSchema as ReducerFlowStateSchema, zod_ReducerInputValidationResultSchema as ReducerInputValidationResultSchema, zod_ReducerRuntimeLogEntryAcceptedClientInputSchema as ReducerRuntimeLogEntryAcceptedClientInputSchema, zod_ReducerRuntimeLogEntryAppliedEffectSchema as ReducerRuntimeLogEntryAppliedEffectSchema, zod_ReducerRuntimeLogEntryRngConsumptionSchema as ReducerRuntimeLogEntryRngConsumptionSchema, zod_ReducerRuntimeLogEntrySchema as ReducerRuntimeLogEntrySchema, zod_ReducerRuntimeLogEntryStateCommitSchema as ReducerRuntimeLogEntryStateCommitSchema, zod_ReducerRuntimeStateSchema as ReducerRuntimeStateSchema, zod_ReducerSessionMetaSchema as ReducerSessionMetaSchema, zod_ReducerSessionStateSchema as ReducerSessionStateSchema, zod_ReducerSetupSelectionSchema as ReducerSetupSelectionSchema, zod_RngStateSchema as RngStateSchema, zod_RuntimeSimultaneousCurrentSchema as RuntimeSimultaneousCurrentSchema, zod_RuntimeSimultaneousStateSchema as RuntimeSimultaneousStateSchema, zod_RuntimeSimultaneousSubmissionSchema as RuntimeSimultaneousSubmissionSchema, zod_SeatProjectionBundleSchema as SeatProjectionBundleSchema, zod_SeatProjectionSchema as SeatProjectionSchema, zod_SimultaneousPhaseProjectionSchema as SimultaneousPhaseProjectionSchema, zod_SystemActionEventSchema as SystemActionEventSchema, zod_TransitionRecordSchema as TransitionRecordSchema, zod_ValidateInputRequestSchema as ValidateInputRequestSchema };
 }
 
 /**
@@ -1413,7 +1680,7 @@ declare namespace zod {
  * any breaking change to schema/reducer-runtime.schema.json. At bundle load
  * time hosts refuse bundles whose major version differs.
  */
-declare const REDUCER_CONTRACT_VERSION: "0.2.1";
+declare const REDUCER_CONTRACT_VERSION: "0.3.0";
 
 type MaybePromise<T> = T | Promise<T>;
 /**

package/dist/index.js

@@ -2,8 +2,8 @@ import {
   DREAMBOARD_SDK_PACKAGES,
   DREAMBOARD_SDK_PACKAGE_SET,
   DREAMBOARD_SDK_VERSION
-} from "./chunk-LKJLAGND.js";
-import "./chunk-SUMZ5OEH.js";
+} from "./chunk-DDST4U2P.js";
+import "./chunk-HK3WN4U7.js";
 import "./chunk-PZ5AY32C.js";
 export {
   DREAMBOARD_SDK_PACKAGES,

package/dist/package-set.d.ts

@@ -1,6 +1,6 @@
-declare const DREAMBOARD_SDK_VERSION: "0.4.0-alpha.4";
+declare const DREAMBOARD_SDK_VERSION: "0.4.0-alpha.6";
 declare const DREAMBOARD_SDK_PACKAGES: {
-    readonly "@dreamboard-games/sdk": "0.4.0-alpha.4";
+    readonly "@dreamboard-games/sdk": "0.4.0-alpha.6";
 };
 type DreamboardSdkPackageName = keyof typeof DREAMBOARD_SDK_PACKAGES;
 type DreamboardSdkPackageSet = {

package/dist/package-set.js

@@ -2,8 +2,8 @@ import {
   DREAMBOARD_SDK_PACKAGES,
   DREAMBOARD_SDK_PACKAGE_SET,
   DREAMBOARD_SDK_VERSION
-} from "./chunk-LKJLAGND.js";
-import "./chunk-SUMZ5OEH.js";
+} from "./chunk-DDST4U2P.js";
+import "./chunk-HK3WN4U7.js";
 import "./chunk-PZ5AY32C.js";
 export {
   DREAMBOARD_SDK_PACKAGES,

package/dist/{runtime-api-BJharVaj.d.ts → plugin-state-BRH3UiUp.d.ts}

@@ -1,5 +1,3 @@
-import './runtime-api-C6aWo9c0.js';
-
 /** Choice option surfaced on a prompt-kind interaction's structured context. */
 interface InteractionContextOption {
     id: string;
@@ -151,6 +149,8 @@ interface InteractionDescriptorBase<Key extends string = string> {
     phaseName: string;
     interactionKey: Key;
     interactionId: string;
+    label: string;
+    help?: string;
     /** Draft commit policy. Always materialized by the trusted reducer bundle. */
     commit: InteractionCommitPolicy;
     /** Canonical descriptor digest used by browser replay/protocol tooling when projected by the host. */
@@ -194,5 +194,21 @@ interface ZoneHandlesSnapshot<InteractionType extends string = string> {
     cardViewsById: Readonly<Record<string, string>>;
     playableByCardId: Readonly<Record<string, ReadonlyArray<InteractionDescriptor<InteractionType>>>>;
 }
+interface GameEventDetail {
+    label: string;
+    value: string | number | boolean;
+}
+interface SystemActionEvent {
+    kind: "systemAction";
+    procedureId: string;
+    title: string;
+    summary?: string;
+    details?: readonly GameEventDetail[];
+}
+type GameEvent = SystemActionEvent;
+type ProjectedGameEvent = GameEvent & {
+    version: number;
+    index: number;
+};
 
-export type { InputDomain as I, ZoneHandlesSnapshot as Z, InteractionDescriptor as a, InteractionInputDescriptor as b };
+export type { GameEvent as G, InputDomain as I, ProjectedGameEvent as P, SystemActionEvent as S, ZoneHandlesSnapshot as Z, GameEventDetail as a, InteractionDescriptor as b, InteractionInputDescriptor as c };

package/dist/{protocol-BP193lva.d.ts → protocol-835hEGne.d.ts}

@@ -84,10 +84,31 @@ interface InteractionDiagnosticReason {
     readonly ruleId: string;
     readonly errorCode: string;
 }
+interface SetupGuidanceStep {
+    readonly id: string;
+    readonly label: string;
+    readonly description?: string;
+}
+interface GameGuidanceProjection {
+    readonly phase: {
+        readonly id: string;
+        readonly label: string;
+        readonly summary?: string;
+        readonly objective?: string;
+    };
+    readonly setup?: {
+        readonly profileId: string;
+        readonly name: string;
+        readonly summary?: string;
+        readonly steps: readonly SetupGuidanceStep[];
+    };
+}
 interface InteractionDescriptorBase<Interaction extends string = string> {
     readonly phaseName: string;
     readonly interactionKey: Interaction;
     readonly interactionId: string;
+    readonly label: string;
+    readonly help?: string;
     readonly zoneId?: string;
     readonly zoneIds?: readonly string[];
     readonly commit: InteractionCommitPolicy;
@@ -130,6 +151,22 @@ interface SimultaneousPhaseSnapshot {
     readonly sealedPlayerIds: readonly PlayerId[];
     readonly pendingPlayerIds: readonly PlayerId[];
 }
+interface GameEventDetail {
+    readonly label: string;
+    readonly value: string | number | boolean;
+}
+interface SystemActionEvent {
+    readonly kind: "systemAction";
+    readonly procedureId: string;
+    readonly title: string;
+    readonly summary?: string;
+    readonly details?: readonly GameEventDetail[];
+}
+type GameEvent = SystemActionEvent;
+type ProjectedGameEvent = GameEvent & {
+    readonly version: number;
+    readonly index: number;
+};
 interface PluginGameplayFrame<View = unknown, Phase extends string = string, Stage extends string = string, Interaction extends string = string> {
     readonly gameVersion: number;
     readonly actionSetVersion: string;
@@ -142,12 +179,16 @@ interface PluginGameplayFrame<View = unknown, Phase extends string = string, Sta
         readonly simultaneousPhase: SimultaneousPhaseSnapshot | null;
     };
     readonly availableInteractions: ReadonlyArray<InteractionDescriptor<Interaction>>;
+    readonly guidance?: GameGuidanceProjection | null;
+    readonly recentEvents: readonly ProjectedGameEvent[];
     readonly zones: Readonly<Record<string, ZoneHandlesSnapshot<Interaction>>>;
 }
 interface ReducerSeatProjectionBundle {
     readonly currentStage?: string | null;
     readonly stageSeats?: readonly string[];
     readonly simultaneousPhase?: SimultaneousPhaseSnapshot | null;
+    readonly guidance?: GameGuidanceProjection | null;
+    readonly recentEvents?: readonly ProjectedGameEvent[];
     readonly interactionsByRef?: unknown;
     readonly seats: Readonly<Record<string, {
         readonly view?: unknown;
@@ -264,4 +305,4 @@ type ActionSetVersionInput = {
     readonly availableInteractions: readonly InteractionDescriptor[];
 };
 
-export { type ActionInteractionDescriptor as A, type RuntimeJson as B, type CanonicalJson as C, DREAMBOARD_PLUGIN_PROTOCOL as D, type SubmissionResult as E, type SubmitInteractionCommand as F, type ValidationResult as G, type HostToPluginEnvelope as H, type InputDomain as I, canonicalizePluginRuntimeJson as J, digestPluginRuntimeJson as K, encodeCanonicalPluginRuntimeJson as L, type PlayerId as P, type ReducerBoardStaticProjection as R, type SimultaneousPhaseSnapshot as S, type ValidateInteractionCommand as V, type ZoneHandlesSnapshot as Z, type ActionSetVersionInput as a, DREAMBOARD_PLUGIN_PROTOCOL_VERSION as b, type HostToPluginPayload as c, type InputDomainDependencies as d, type InputDomainDependencyCase as e, type InputSelection as f, type InteractionAvailability as g, type InteractionChoiceOption as h, type InteractionCommitPolicy as i, type InteractionContext as j, type InteractionContextOption as k, type InteractionDescriptor as l, type InteractionDiagnosticReason as m, type InteractionInputDescriptor as n, type PluginGameplayFrame as o, type PluginInteractionBasis as p, type PluginPlayerSummary as q, type PluginProtocolEnvelope as r, type PluginProtocolFrame as s, type PluginProtocolStep as t, type PluginProtocolTape as u, type PluginSessionDescriptor as v, type PluginToHostEnvelope as w, type PluginToHostPayload as x, type PromptInteractionDescriptor as y, type ReducerSeatProjectionBundle as z };
+export { type ActionInteractionDescriptor as A, type PromptInteractionDescriptor as B, type CanonicalJson as C, DREAMBOARD_PLUGIN_PROTOCOL as D, type ReducerSeatProjectionBundle as E, type RuntimeJson as F, type GameEvent as G, type HostToPluginEnvelope as H, type InputDomain as I, type SubmissionResult as J, type SubmitInteractionCommand as K, type SystemActionEvent as L, type ValidationResult as M, canonicalizePluginRuntimeJson as N, digestPluginRuntimeJson as O, type PlayerId as P, encodeCanonicalPluginRuntimeJson as Q, type ReducerBoardStaticProjection as R, type SimultaneousPhaseSnapshot as S, type ValidateInteractionCommand as V, type ZoneHandlesSnapshot as Z, type ActionSetVersionInput as a, DREAMBOARD_PLUGIN_PROTOCOL_VERSION as b, type GameEventDetail as c, type HostToPluginPayload as d, type InputDomainDependencies as e, type InputDomainDependencyCase as f, type InputSelection as g, type InteractionAvailability as h, type InteractionChoiceOption as i, type InteractionCommitPolicy as j, type InteractionContext as k, type InteractionContextOption as l, type InteractionDescriptor as m, type InteractionDiagnosticReason as n, type InteractionInputDescriptor as o, type PluginGameplayFrame as p, type PluginInteractionBasis as q, type PluginPlayerSummary as r, type PluginProtocolEnvelope as s, type PluginProtocolFrame as t, type PluginProtocolStep as u, type PluginProtocolTape as v, type PluginSessionDescriptor as w, type PluginToHostEnvelope as x, type PluginToHostPayload as y, type ProjectedGameEvent as z };