zeus-api-types 1.0.65 → 1.0.67

package/dist/game-state.d.ts

@@ -60,11 +60,18 @@ export interface WorldReduced {
  * Core game state interfaces shared between middle-layer and frontend.
  */
 export interface TimeState {
-    current: string;
+    /** @deprecated Do not write this field. Use computeTimeString(time) to derive it. */
+    current?: string;
     day: number;
     hour: number;
     minute: number;
 }
+/**
+ * Derives the canonical time string from scalar time fields.
+ * Use this everywhere instead of reading time.current, which may be stale.
+ * @example computeTimeString({ day: 1, hour: 10, minute: 38 }) === 'day_1_10:38'
+ */
+export declare function computeTimeString(time: Pick<TimeState, 'day' | 'hour' | 'minute'>): string;
 /**
  * Base interface for world entities (NPCs, Locations, etc.)
  * All world entities share this common structure
@@ -82,9 +89,7 @@ export interface WorldEntity {
  */
 export interface Player extends WorldEntity {
     name: string;
-    motivation?: string;
-    role?: string;
-    backstory?: string;
+    description: string;
     tone?: string;
 }
 /**
@@ -94,10 +99,7 @@ export interface Player extends WorldEntity {
 export interface NPC extends WorldEntity {
     name: string;
     discovered: boolean;
-    playable?: boolean;
-    motivation?: string;
-    role?: string;
-    backstory?: string;
+    playable: boolean;
     tone?: string;
 }
 export interface NpcExistingOrNewOp {

package/dist/game-state.js

@@ -1,2 +1,11 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.computeTimeString = computeTimeString;
+/**
+ * Derives the canonical time string from scalar time fields.
+ * Use this everywhere instead of reading time.current, which may be stale.
+ * @example computeTimeString({ day: 1, hour: 10, minute: 38 }) === 'day_1_10:38'
+ */
+function computeTimeString(time) {
+    return `day_${time.day}_${time.hour.toString().padStart(2, '0')}:${time.minute.toString().padStart(2, '0')}`;
+}

package/dist/index.d.ts

@@ -3,6 +3,7 @@ export type { DoneEventPayload, ErrorEventPayload, MetadataEventPayload, Narrati
 export type { AIMetadata, AIOperationTokens, AIOperationType } from './ai';
 export type { BaseDeckCard, DeckDefinition, FixtureSet, MultiDeckDefinition, NarrativeStyleCard, StoryArc, StoryArcCard } from './deck';
 export type { BaseEvent, DeterministicEvent, EventHistoryEntry, EventPropagation, ProbabilisticEvent, ScheduledEvent, WorldEvents } from './events';
+export { computeTimeString } from './game-state';
 export type { BaseImmutableState, DialogContext, DialogMessage, GameMetadata, GameState, GameStateReduced, GenreImmutableState, HistoryEntry, ImmutableState, Location, Metadata, NPC, NpcExistingOrNewOp, Player, PresentationCache, PresentationChoiceMeta, PromptVariables, Session, StateSnapshot, Tag, TimeState, World, WorldEntity, WorldReduced } from './game-state';
 export type { AIPreferences, ModelEntry, ModelStack, ModelStackPreferences, ModelStackPreset, NarrativeFontPreferences, SoundPreferences, SystemModelPresets, UserMetadata, UserPreferences } from './user-preferences';
 export type { CreatePresetRequest, CreatePresetResponse, DeletePresetResponse, ListPresetsResponse, PaginatedPresetsResponse, PaginationMetadata, PresetIndex, PresetMetadata, UpdatePresetRequest, UpdatePresetResponse } from './preset';

package/dist/index.js

@@ -1,2 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.computeTimeString = void 0;
+// Game State Utilities (value exports — not type-only)
+var game_state_1 = require("./game-state");
+Object.defineProperty(exports, "computeTimeString", { enumerable: true, get: function () { return game_state_1.computeTimeString; } });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "zeus-api-types",
-  "version": "1.0.65",
+  "version": "1.0.67",
   "description": "Shared API types for Wagtales - SSE payloads, error types, and common interfaces",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",