zeus-api-types 1.0.66 → 1.0.69

package/dist/game-state.d.ts

@@ -60,11 +60,24 @@ 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;
+/**
+ * Formats time into a human-readable string for AI prompt ingestion.
+ * @example formatTimeHuman({ day: 1, hour: 15, minute: 11 }) === 'Day 1, 3:11pm'
+ * @example formatTimeHuman({ day: 3, hour: 0, minute: 5 }) === 'Day 3, 12:05am'
+ */
+export declare function formatTimeHuman(time: Pick<TimeState, 'day' | 'hour' | 'minute'>): string;
 /**
  * Base interface for world entities (NPCs, Locations, etc.)
  * All world entities share this common structure
@@ -206,7 +219,7 @@ export interface GameState {
 }
 export interface GameStateReduced {
     currentTurn: number;
-    time: TimeState;
+    time: string;
     location: string;
     player: Player;
     world: WorldReduced;

package/dist/game-state.js

@@ -1,2 +1,24 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.computeTimeString = computeTimeString;
+exports.formatTimeHuman = formatTimeHuman;
+/**
+ * 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')}`;
+}
+/**
+ * Formats time into a human-readable string for AI prompt ingestion.
+ * @example formatTimeHuman({ day: 1, hour: 15, minute: 11 }) === 'Day 1, 3:11pm'
+ * @example formatTimeHuman({ day: 3, hour: 0, minute: 5 }) === 'Day 3, 12:05am'
+ */
+function formatTimeHuman(time) {
+    const h = time.hour;
+    const period = h < 12 ? 'am' : 'pm';
+    const hour12 = h % 12 === 0 ? 12 : h % 12;
+    const minute = time.minute.toString().padStart(2, '0');
+    return `Day ${time.day}, ${hour12}:${minute}${period}`;
+}

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, formatTimeHuman } 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,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatTimeHuman = 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; } });
+Object.defineProperty(exports, "formatTimeHuman", { enumerable: true, get: function () { return game_state_1.formatTimeHuman; } });

package/package.json

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