@mythxengine/types 0.1.0

package/dist/game/dice.d.ts

@@ -0,0 +1,87 @@
+/**
+ * Dice and RNG types
+ */
+import type { AbilityName } from "./abilities.js";
+/**
+ * RNG state for deterministic randomness
+ */
+export interface RNGState {
+    seed: number;
+    cursor: number;
+}
+/**
+ * Advantage state for a roll
+ */
+export type RollAdvantageState = "advantage" | "disadvantage" | "normal";
+/**
+ * Information about an advantage/disadvantage roll
+ */
+export interface AdvantageInfo {
+    type: "advantage" | "disadvantage";
+    bothRolls: [number, number];
+    selected: "higher" | "lower";
+}
+/**
+ * Result of a dice roll
+ */
+export interface DiceResult {
+    /** Original expression, e.g., "2d6+3" */
+    expression: string;
+    /** Individual die results, e.g., [4, 2] */
+    rolls: number[];
+    /** Flat modifier */
+    modifier: number;
+    /** Final total */
+    total: number;
+    /** Sum before modifier */
+    natural: number;
+    /** Critical status */
+    critical?: "success" | "failure";
+    /** Advantage/disadvantage info if applicable */
+    advantage?: AdvantageInfo;
+}
+/**
+ * Parsed dice expression
+ */
+export interface ParsedDice {
+    count: number;
+    sides: number;
+    modifier: number;
+    ability?: AbilityName;
+}
+/**
+ * A modifier to a roll
+ */
+export interface Modifier {
+    source: string;
+    amount: number;
+}
+/**
+ * Result of a skill/ability test
+ */
+export interface TestResult {
+    skill: string;
+    ability: AbilityName;
+    abilityMod: number;
+    skillBonus: number;
+    otherMods: number;
+    totalMod: number;
+    difficulty: number;
+    roll: DiceResult;
+    success: boolean;
+    margin: number;
+    critical: boolean;
+    /** The advantage state used for this test */
+    advantageState: RollAdvantageState;
+}
+/**
+ * Standard difficulty levels
+ */
+export declare const DIFFICULTY: {
+    readonly EASY: 8;
+    readonly STANDARD: 12;
+    readonly HARD: 16;
+    readonly EXTREME: 20;
+};
+export type DifficultyLevel = keyof typeof DIFFICULTY;
+//# sourceMappingURL=dice.d.ts.map

package/dist/game/dice.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dice.d.ts","sourceRoot":"","sources":["../../src/game/dice.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAElD;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG,WAAW,GAAG,cAAc,GAAG,QAAQ,CAAC;AAEzE;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,WAAW,GAAG,cAAc,CAAC;IACnC,SAAS,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC5B,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC;CAC9B;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,yCAAyC;IACzC,UAAU,EAAE,MAAM,CAAC;IACnB,2CAA2C;IAC3C,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,oBAAoB;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,kBAAkB;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,0BAA0B;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,sBAAsB;IACtB,QAAQ,CAAC,EAAE,SAAS,GAAG,SAAS,CAAC;IACjC,gDAAgD;IAChD,SAAS,CAAC,EAAE,aAAa,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,WAAW,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,WAAW,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,UAAU,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,OAAO,CAAC;IAClB,6CAA6C;IAC7C,cAAc,EAAE,kBAAkB,CAAC;CACpC;AAED;;GAEG;AACH,eAAO,MAAM,UAAU;;;;;CAKb,CAAC;AAEX,MAAM,MAAM,eAAe,GAAG,MAAM,OAAO,UAAU,CAAC"}

package/dist/game/dice.js

@@ -0,0 +1,13 @@
+/**
+ * Dice and RNG types
+ */
+/**
+ * Standard difficulty levels
+ */
+export const DIFFICULTY = {
+    EASY: 8,
+    STANDARD: 12,
+    HARD: 16,
+    EXTREME: 20,
+};
+//# sourceMappingURL=dice.js.map

package/dist/game/dice.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dice.js","sourceRoot":"","sources":["../../src/game/dice.ts"],"names":[],"mappings":"AAAA;;GAEG;AAmFH;;GAEG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,IAAI,EAAE,CAAC;IACP,QAAQ,EAAE,EAAE;IACZ,IAAI,EAAE,EAAE;IACR,OAAO,EAAE,EAAE;CACH,CAAC"}

package/dist/game/events.d.ts

@@ -0,0 +1,85 @@
+/**
+ * Game events - emitted by engine
+ */
+import type { Condition } from "./conditions.js";
+import type { DiceResult } from "./dice.js";
+/**
+ * Immutable events emitted by the engine
+ */
+export type GameEvent = SceneEnteredEvent | SkillTestResultEvent | DamageDealtEvent | DamageTakenEvent | CharacterDefeatedEvent | CombatStartedEvent | CombatEndedEvent | TurnAdvancedEvent | ConditionAppliedEvent | ConditionRemovedEvent | FlagSetEvent | RNGAdvancedEvent | ErrorEvent;
+export interface SceneEnteredEvent {
+    type: "SCENE_ENTERED";
+    locationId: string;
+    description: string;
+}
+export interface SkillTestResultEvent {
+    type: "SKILL_TEST_RESULT";
+    characterId: string;
+    skill: string;
+    roll: DiceResult;
+    success: boolean;
+    margin: number;
+}
+export interface DamageDealtEvent {
+    type: "DAMAGE_DEALT";
+    attackerId: string;
+    targetId: string;
+    amount: number;
+    weapon: string;
+}
+export interface DamageTakenEvent {
+    type: "DAMAGE_TAKEN";
+    characterId: string;
+    amount: number;
+    hpRemaining: number;
+}
+export interface CharacterDefeatedEvent {
+    type: "CHARACTER_DEFEATED";
+    characterId: string;
+}
+export interface CombatStartedEvent {
+    type: "COMBAT_STARTED";
+    enemies: string[];
+    turnOrder: string[];
+}
+export interface CombatEndedEvent {
+    type: "COMBAT_ENDED";
+    outcome: "victory" | "defeat" | "fled";
+}
+export interface TurnAdvancedEvent {
+    type: "TURN_ADVANCED";
+    actorId: string;
+    round: number;
+}
+export interface ConditionAppliedEvent {
+    type: "CONDITION_APPLIED";
+    targetId: string;
+    condition: Condition;
+}
+export interface ConditionRemovedEvent {
+    type: "CONDITION_REMOVED";
+    targetId: string;
+    conditionId: string;
+}
+export interface FlagSetEvent {
+    type: "FLAG_SET";
+    flag: string;
+    value: boolean;
+}
+export interface RNGAdvancedEvent {
+    type: "RNG_ADVANCED";
+    cursor: number;
+}
+export interface ErrorEvent {
+    type: "ERROR";
+    message: string;
+    recoverable: boolean;
+}
+export type EventType = GameEvent["type"];
+/**
+ * Type guard to check event type
+ */
+export declare function isEventType<T extends EventType>(event: GameEvent, type: T): event is Extract<GameEvent, {
+    type: T;
+}>;
+//# sourceMappingURL=events.d.ts.map

package/dist/game/events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../src/game/events.ts"],"names":[],"mappings":"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"}

package/dist/game/events.js

@@ -0,0 +1,10 @@
+/**
+ * Game events - emitted by engine
+ */
+/**
+ * Type guard to check event type
+ */
+export function isEventType(event, type) {
+    return event.type === type;
+}
+//# sourceMappingURL=events.js.map

package/dist/game/events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../../src/game/events.ts"],"names":[],"mappings":"AAAA;;GAEG;AA0GH;;GAEG;AACH,MAAM,UAAU,WAAW,CACzB,KAAgB,EAChB,IAAO;IAEP,OAAO,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC;AAC7B,CAAC"}

package/dist/game/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Game types - re-export all
+ */
+export * from "./abilities.js";
+export * from "./conditions.js";
+export * from "./character.js";
+export * from "./dice.js";
+export * from "./combat.js";
+export * from "./actions.js";
+export * from "./events.js";
+export * from "./state.js";
+export * from "./player.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/game/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/game/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC"}

package/dist/game/index.js

@@ -0,0 +1,13 @@
+/**
+ * Game types - re-export all
+ */
+export * from "./abilities.js";
+export * from "./conditions.js";
+export * from "./character.js";
+export * from "./dice.js";
+export * from "./combat.js";
+export * from "./actions.js";
+export * from "./events.js";
+export * from "./state.js";
+export * from "./player.js";
+//# sourceMappingURL=index.js.map

package/dist/game/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/game/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC"}

package/dist/game/player.d.ts

@@ -0,0 +1,110 @@
+/**
+ * Player/Actor types for multi-player support
+ *
+ * Key insight: Separate players (who takes turns) from characters (game mechanics).
+ * A player controls a character, but they are distinct entities.
+ */
+/**
+ * AI playstyle persona for AI-controlled players
+ */
+export type AIPlaystyle = "tactical" | "roleplay" | "cautious" | "reckless";
+/**
+ * AI persona configuration for AI-controlled players
+ */
+export interface PlayerAIPersona {
+    /** How the AI approaches decisions */
+    playstyle: AIPlaystyle;
+    /** How much the AI talks in-character (0-10) */
+    talkativeness: number;
+    /** Specific personality notes for this AI player */
+    personalityNotes?: string;
+}
+/**
+ * Player role in the session
+ */
+export type PlayerRole = "gm" | "pc" | "spectator";
+/**
+ * Whether the player is human or AI controlled
+ */
+export type PlayerControlType = "human" | "ai";
+/**
+ * Player status in the session
+ */
+export type PlayerStatus = "active" | "inactive" | "waiting_for_input";
+/**
+ * Pending action for human players awaiting input
+ */
+export interface PendingPlayerAction {
+    /** What we're asking the player to decide */
+    prompt: string;
+    /** Optional preset choices */
+    choices?: string[];
+    /** When this action was requested */
+    requestedAt: string;
+    /** Context for the decision (scene, situation, etc.) */
+    context?: string;
+}
+/**
+ * Player/Actor in the session
+ *
+ * Represents someone (human or AI) who takes actions in the game.
+ * Players control characters, but the mapping is separate.
+ */
+export interface Player {
+    /** Unique player ID (e.g., "player-1", "ai-rogue") */
+    id: string;
+    /** Display name for this player */
+    name: string;
+    /** Role in the game */
+    role: PlayerRole;
+    /** Human or AI controlled */
+    controlType: PlayerControlType;
+    /** Linked character ID (for PC players) */
+    characterId?: string;
+    /** Current status */
+    status: PlayerStatus;
+    /** AI configuration (only for AI players) */
+    aiPersona?: PlayerAIPersona;
+    /** Pending action awaiting input (only for human players) */
+    pendingAction?: PendingPlayerAction;
+    /** When this player joined */
+    joinedAt: string;
+    /** Last activity timestamp */
+    lastActiveAt: string;
+}
+/**
+ * Turn coordination strategy
+ */
+export type TurnStrategy = "round_robin" | "gm_directed" | "free_form";
+/**
+ * Turn state for coordinated gameplay
+ */
+export interface TurnState {
+    /** How turns are managed */
+    strategy: TurnStrategy;
+    /** Currently active player ID (null if no one's turn) */
+    currentPlayerId: string | null;
+    /** Turn order (player IDs) for round_robin */
+    turnOrder: string[];
+    /** Current index in turnOrder */
+    turnIndex: number;
+    /** Current round number (increments when all players have acted) */
+    round: number;
+    /** Whether we're waiting for human input */
+    waitingForHumanInput: boolean;
+    /** When turns started */
+    startedAt: string;
+}
+/**
+ * Create default AI persona
+ */
+export declare function createDefaultAIPersona(playstyle?: AIPlaystyle): PlayerAIPersona;
+/**
+ * Create a new player
+ */
+export declare function createPlayer(id: string, name: string, role: PlayerRole, controlType: PlayerControlType): Player;
+/**
+ * Create initial turn state
+ */
+export declare function createTurnState(strategy: TurnStrategy, playerIds: string[]): TurnState;
+//# sourceMappingURL=player.d.ts.map

package/dist/game/player.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"player.d.ts","sourceRoot":"","sources":["../../src/game/player.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,UAAU,GAAG,UAAU,GAAG,UAAU,GAAG,UAAU,CAAC;AAE5E;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,sCAAsC;IACtC,SAAS,EAAE,WAAW,CAAC;IACvB,gDAAgD;IAChD,aAAa,EAAE,MAAM,CAAC;IACtB,oDAAoD;IACpD,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,IAAI,GAAG,IAAI,GAAG,WAAW,CAAC;AAEnD;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG,OAAO,GAAG,IAAI,CAAC;AAE/C;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,UAAU,GAAG,mBAAmB,CAAC;AAEvE;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,6CAA6C;IAC7C,MAAM,EAAE,MAAM,CAAC;IACf,8BAA8B;IAC9B,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,qCAAqC;IACrC,WAAW,EAAE,MAAM,CAAC;IACpB,wDAAwD;IACxD,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;;GAKG;AACH,MAAM,WAAW,MAAM;IACrB,sDAAsD;IACtD,EAAE,EAAE,MAAM,CAAC;IACX,mCAAmC;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,uBAAuB;IACvB,IAAI,EAAE,UAAU,CAAC;IACjB,6BAA6B;IAC7B,WAAW,EAAE,iBAAiB,CAAC;IAC/B,2CAA2C;IAC3C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,qBAAqB;IACrB,MAAM,EAAE,YAAY,CAAC;IACrB,6CAA6C;IAC7C,SAAS,CAAC,EAAE,eAAe,CAAC;IAC5B,6DAA6D;IAC7D,aAAa,CAAC,EAAE,mBAAmB,CAAC;IACpC,8BAA8B;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,8BAA8B;IAC9B,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,aAAa,GAAG,aAAa,GAAG,WAAW,CAAC;AAEvE;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,4BAA4B;IAC5B,QAAQ,EAAE,YAAY,CAAC;IACvB,yDAAyD;IACzD,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,8CAA8C;IAC9C,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,iCAAiC;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,oEAAoE;IACpE,KAAK,EAAE,MAAM,CAAC;IACd,4CAA4C;IAC5C,oBAAoB,EAAE,OAAO,CAAC;IAC9B,yBAAyB;IACzB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,SAAS,GAAE,WAAwB,GAAG,eAAe,CAK3F;AAED;;GAEG;AACH,wBAAgB,YAAY,CAC1B,EAAE,EAAE,MAAM,EACV,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,UAAU,EAChB,WAAW,EAAE,iBAAiB,GAC7B,MAAM,CAWR;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,YAAY,EACtB,SAAS,EAAE,MAAM,EAAE,GAClB,SAAS,CAUX"}

package/dist/game/player.js

@@ -0,0 +1,45 @@
+/**
+ * Player/Actor types for multi-player support
+ *
+ * Key insight: Separate players (who takes turns) from characters (game mechanics).
+ * A player controls a character, but they are distinct entities.
+ */
+/**
+ * Create default AI persona
+ */
+export function createDefaultAIPersona(playstyle = "tactical") {
+    return {
+        playstyle,
+        talkativeness: 5,
+    };
+}
+/**
+ * Create a new player
+ */
+export function createPlayer(id, name, role, controlType) {
+    const now = new Date().toISOString();
+    return {
+        id,
+        name,
+        role,
+        controlType,
+        status: "active",
+        joinedAt: now,
+        lastActiveAt: now,
+    };
+}
+/**
+ * Create initial turn state
+ */
+export function createTurnState(strategy, playerIds) {
+    return {
+        strategy,
+        currentPlayerId: playerIds.length > 0 ? playerIds[0] : null,
+        turnOrder: playerIds,
+        turnIndex: 0,
+        round: 1,
+        waitingForHumanInput: false,
+        startedAt: new Date().toISOString(),
+    };
+}
+//# sourceMappingURL=player.js.map

package/dist/game/player.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"player.js","sourceRoot":"","sources":["../../src/game/player.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAsGH;;GAEG;AACH,MAAM,UAAU,sBAAsB,CAAC,YAAyB,UAAU;IACxE,OAAO;QACL,SAAS;QACT,aAAa,EAAE,CAAC;KACjB,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY,CAC1B,EAAU,EACV,IAAY,EACZ,IAAgB,EAChB,WAA8B;IAE9B,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACrC,OAAO;QACL,EAAE;QACF,IAAI;QACJ,IAAI;QACJ,WAAW;QACX,MAAM,EAAE,QAAQ;QAChB,QAAQ,EAAE,GAAG;QACb,YAAY,EAAE,GAAG;KAClB,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAC7B,QAAsB,EACtB,SAAmB;IAEnB,OAAO;QACL,QAAQ;QACR,eAAe,EAAE,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI;QAC3D,SAAS,EAAE,SAAS;QACpB,SAAS,EAAE,CAAC;QACZ,KAAK,EAAE,CAAC;QACR,oBAAoB,EAAE,KAAK;QAC3B,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;KACpC,CAAC;AACJ,CAAC"}

package/dist/game/state.d.ts

@@ -0,0 +1,99 @@
+/**
+ * Engine state types
+ */
+import type { Character, NPC, Enemy } from "./character.js";
+import type { RNGState } from "./dice.js";
+import type { CombatState } from "./combat.js";
+import type { GameEvent } from "./events.js";
+/**
+ * Game phase
+ */
+export type GamePhase = {
+    mode: "EXPLORATION";
+} | {
+    mode: "DIALOGUE";
+    npcId: string;
+} | {
+    mode: "COMBAT";
+    turnIndex: number;
+} | {
+    mode: "REST";
+} | {
+    mode: "SCENE_TRANSITION";
+};
+/**
+ * Game time tracking
+ */
+export interface GameTime {
+    day: number;
+    hour: number;
+    minute: number;
+}
+/**
+ * A deadline/countdown in the game
+ */
+export interface Deadline {
+    id: string;
+    name: string;
+    description: string;
+    /** When this deadline expires */
+    expiresAt: GameTime;
+    /** Optional flag to set when deadline expires */
+    onExpireFlag?: string;
+    /** Whether to warn when approaching (within 1 hour) */
+    warnOnApproach: boolean;
+}
+/**
+ * Pure game state managed by the engine
+ * This is a subset of SessionState - just the mechanics
+ */
+export interface EngineState {
+    sessionId: string;
+    rng: RNGState;
+    /** Action sequence number */
+    seq: number;
+    party: Character[];
+    npcs: NPC[];
+    enemies: Enemy[];
+    currentLocationId: string;
+    phase: GamePhase;
+    combat: CombatState | null;
+    worldFlags: string[];
+    questFlags: Record<string, boolean>;
+    gameTime: GameTime;
+}
+/**
+ * Result of dispatching an action
+ */
+export interface DispatchResult {
+    nextState: EngineState;
+    events: GameEvent[];
+    requiresNarration: boolean;
+}
+/**
+ * Create initial game time (dawn of day 1)
+ */
+export declare function createInitialGameTime(): GameTime;
+/**
+ * Advance game time
+ */
+export declare function advanceGameTime(time: GameTime, minutes: number): GameTime;
+/**
+ * Convert GameTime to total minutes (for comparison)
+ */
+export declare function gameTimeToMinutes(time: GameTime): number;
+/**
+ * Compare two game times
+ * Returns negative if a < b, 0 if equal, positive if a > b
+ */
+export declare function compareGameTime(a: GameTime, b: GameTime): number;
+/**
+ * Calculate minutes remaining until a deadline
+ * Returns negative if deadline has passed
+ */
+export declare function minutesUntil(current: GameTime, target: GameTime): number;
+/**
+ * Format minutes as human-readable duration (e.g., "2 hours 30 minutes")
+ */
+export declare function formatDuration(minutes: number): string;
+//# sourceMappingURL=state.d.ts.map

package/dist/game/state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../src/game/state.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAC5D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C;;GAEG;AACH,MAAM,MAAM,SAAS,GACjB;IAAE,IAAI,EAAE,aAAa,CAAA;CAAE,GACvB;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACnC;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GACrC;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAChB;IAAE,IAAI,EAAE,kBAAkB,CAAA;CAAE,CAAC;AAEjC;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,iCAAiC;IACjC,SAAS,EAAE,QAAQ,CAAC;IACpB,iDAAiD;IACjD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,uDAAuD;IACvD,cAAc,EAAE,OAAO,CAAC;CACzB;AAED;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,QAAQ,CAAC;IACd,6BAA6B;IAC7B,GAAG,EAAE,MAAM,CAAC;IAEZ,KAAK,EAAE,SAAS,EAAE,CAAC;IACnB,IAAI,EAAE,GAAG,EAAE,CAAC;IACZ,OAAO,EAAE,KAAK,EAAE,CAAC;IAEjB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,KAAK,EAAE,SAAS,CAAC;IAEjB,MAAM,EAAE,WAAW,GAAG,IAAI,CAAC;IAE3B,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAEpC,QAAQ,EAAE,QAAQ,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,WAAW,CAAC;IACvB,MAAM,EAAE,SAAS,EAAE,CAAC;IACpB,iBAAiB,EAAE,OAAO,CAAC;CAC5B;AAED;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,QAAQ,CAEhD;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,GAAG,QAAQ,CAUzE;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,CAExD;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,QAAQ,GAAG,MAAM,CAEhE;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,GAAG,MAAM,CAExE;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAYtD"}

package/dist/game/state.js

@@ -0,0 +1,60 @@
+/**
+ * Engine state types
+ */
+/**
+ * Create initial game time (dawn of day 1)
+ */
+export function createInitialGameTime() {
+    return { day: 1, hour: 6, minute: 0 };
+}
+/**
+ * Advance game time
+ */
+export function advanceGameTime(time, minutes) {
+    let totalMinutes = time.hour * 60 + time.minute + minutes;
+    let days = Math.floor(totalMinutes / (24 * 60));
+    totalMinutes = totalMinutes % (24 * 60);
+    return {
+        day: time.day + days,
+        hour: Math.floor(totalMinutes / 60),
+        minute: totalMinutes % 60,
+    };
+}
+/**
+ * Convert GameTime to total minutes (for comparison)
+ */
+export function gameTimeToMinutes(time) {
+    return (time.day - 1) * 24 * 60 + time.hour * 60 + time.minute;
+}
+/**
+ * Compare two game times
+ * Returns negative if a < b, 0 if equal, positive if a > b
+ */
+export function compareGameTime(a, b) {
+    return gameTimeToMinutes(a) - gameTimeToMinutes(b);
+}
+/**
+ * Calculate minutes remaining until a deadline
+ * Returns negative if deadline has passed
+ */
+export function minutesUntil(current, target) {
+    return gameTimeToMinutes(target) - gameTimeToMinutes(current);
+}
+/**
+ * Format minutes as human-readable duration (e.g., "2 hours 30 minutes")
+ */
+export function formatDuration(minutes) {
+    if (minutes < 0)
+        return "expired";
+    if (minutes === 0)
+        return "now";
+    const hours = Math.floor(minutes / 60);
+    const mins = minutes % 60;
+    const parts = [];
+    if (hours > 0)
+        parts.push(`${hours} hour${hours !== 1 ? "s" : ""}`);
+    if (mins > 0)
+        parts.push(`${mins} minute${mins !== 1 ? "s" : ""}`);
+    return parts.join(" ");
+}
+//# sourceMappingURL=state.js.map

package/dist/game/state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.js","sourceRoot":"","sources":["../../src/game/state.ts"],"names":[],"mappings":"AAAA;;GAEG;AA2EH;;GAEG;AACH,MAAM,UAAU,qBAAqB;IACnC,OAAO,EAAE,GAAG,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC;AACxC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,IAAc,EAAE,OAAe;IAC7D,IAAI,YAAY,GAAG,IAAI,CAAC,IAAI,GAAG,EAAE,GAAG,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC;IAC1D,IAAI,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,GAAG,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC;IAChD,YAAY,GAAG,YAAY,GAAG,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC;IAExC,OAAO;QACL,GAAG,EAAE,IAAI,CAAC,GAAG,GAAG,IAAI;QACpB,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,YAAY,GAAG,EAAE,CAAC;QACnC,MAAM,EAAE,YAAY,GAAG,EAAE;KAC1B,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,IAAc;IAC9C,OAAO,CAAC,IAAI,CAAC,GAAG,GAAG,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,IAAI,GAAG,EAAE,GAAG,IAAI,CAAC,MAAM,CAAC;AACjE,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,CAAW,EAAE,CAAW;IACtD,OAAO,iBAAiB,CAAC,CAAC,CAAC,GAAG,iBAAiB,CAAC,CAAC,CAAC,CAAC;AACrD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,OAAiB,EAAE,MAAgB;IAC9D,OAAO,iBAAiB,CAAC,MAAM,CAAC,GAAG,iBAAiB,CAAC,OAAO,CAAC,CAAC;AAChE,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,OAAe;IAC5C,IAAI,OAAO,GAAG,CAAC;QAAE,OAAO,SAAS,CAAC;IAClC,IAAI,OAAO,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IAEhC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,GAAG,EAAE,CAAC,CAAC;IACvC,MAAM,IAAI,GAAG,OAAO,GAAG,EAAE,CAAC;IAE1B,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,IAAI,KAAK,GAAG,CAAC;QAAE,KAAK,CAAC,IAAI,CAAC,GAAG,KAAK,QAAQ,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IACpE,IAAI,IAAI,GAAG,CAAC;QAAE,KAAK,CAAC,IAAI,CAAC,GAAG,IAAI,UAAU,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAEnE,OAAO,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACzB,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * @mythxengine/types
+ *
+ * Core type definitions for the RPG MCP server
+ */
+export * from "./game/index.js";
+export * from "./rules/index.js";
+export * from "./session/index.js";
+export * from "./tools/contract.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,cAAc,iBAAiB,CAAC;AAGhC,cAAc,kBAAkB,CAAC;AAGjC,cAAc,oBAAoB,CAAC;AAGnC,cAAc,qBAAqB,CAAC"}

package/dist/index.js

@@ -0,0 +1,14 @@
+/**
+ * @mythxengine/types
+ *
+ * Core type definitions for the RPG MCP server
+ */
+// Game types
+export * from "./game/index.js";
+// Rules configuration types
+export * from "./rules/index.js";
+// Session types
+export * from "./session/index.js";
+// Tool contract types
+export * from "./tools/contract.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,aAAa;AACb,cAAc,iBAAiB,CAAC;AAEhC,4BAA4B;AAC5B,cAAc,kBAAkB,CAAC;AAEjC,gBAAgB;AAChB,cAAc,oBAAoB,CAAC;AAEnC,sBAAsB;AACtB,cAAc,qBAAqB,CAAC"}