zeus-api-types 1.0.45 → 1.0.48

package/dist/game-state.d.ts

@@ -1,3 +1,82 @@
+export interface AIOperationTokens {
+    prompt_tokens: number;
+    completion_tokens: number;
+    total_tokens: number;
+    count: number;
+}
+export interface AIMetadata {
+    tokensUsed: {
+        total: {
+            prompt_tokens: number;
+            completion_tokens: number;
+            total_tokens: number;
+        };
+        byOperation: {
+            narrative?: AIOperationTokens;
+            dialog?: AIOperationTokens;
+            updateScript?: AIOperationTokens;
+            choiceMetadata?: AIOperationTokens;
+            gameInit?: AIOperationTokens;
+            genreInit?: AIOperationTokens;
+        };
+    };
+    modelsUsed: string[];
+    operationCount: number;
+    operationsByType: Record<string, number>;
+    firstOperationAt?: string;
+    lastOperationAt?: string;
+}
+/**
+ * Tag structure for both system-level and author-defined metadata
+ * - System tags (in immutable): managed by backend, hidden from UI
+ * - Author tags (in metadata): user-editable via genre editor
+ */
+export interface Tag {
+    /** Unique key identifier (max 64 chars) */
+    key: string;
+    /** Value as string or array of strings (max 64 chars per item) */
+    value: string | string[];
+}
+/**
+ * Base interface for all immutable blocks
+ */
+export interface BaseImmutableState {
+    id: string;
+    hash?: string;
+}
+/**
+ * Game-specific immutable state
+ */
+export interface ImmutableState extends BaseImmutableState {
+    userId: string;
+    genre: string;
+    author: string;
+    ai?: {
+        metadata: AIMetadata;
+    };
+    act?: number;
+    sagaId?: string;
+    previousActId?: string;
+    nextActId?: string;
+    [key: string]: unknown;
+}
+/**
+ * Genre-specific immutable state (for genre authoring)
+ */
+export interface GenreImmutableState extends BaseImmutableState {
+    genre: string;
+    author: string;
+    published: boolean;
+    createdAt: string;
+    tags?: Tag[];
+}
+/**
+ * World container - reduced version without events (for frontend)
+ */
+export interface WorldReduced {
+    locations: Record<string, Location>;
+    npcs: Record<string, NPC>;
+}
 /**
  * Game State Types
  *
@@ -63,13 +142,6 @@ export interface Location extends WorldEntity {
     name: string;
     description: string;
 }
-/**
- * World container - reduced version without events (for frontend)
- */
-export interface WorldReduced {
-    locations: Record<string, Location>;
-    npcs: Record<string, NPC>;
-}
 export interface DialogMessage {
     speaker: string;
     message: string;
@@ -89,6 +161,7 @@ export interface HistoryEntry {
         meta?: unknown;
     };
     charactersPresent?: NpcExistingOrNewOp[];
+    dialogHistory?: DialogMessage[];
 }
 export interface PresentationCache {
     turn: number;

package/dist/game-state.js

@@ -1,8 +1,5 @@
 "use strict";
-/**
- * Game State Types
- *
- * Core game state interfaces shared between middle-layer and frontend.
- * Extracted from middle-layer/src/core/GameState.ts
- */
+// ============================================================================
+// AI METADATA TRACKING
+// ============================================================================
 Object.defineProperty(exports, "__esModule", { value: true });

package/dist/index.d.ts

@@ -1,4 +1,4 @@
 export type { ApiError, ApiErrorResponse } from './errors';
 export type { NarrativeStartEventPayload, NarrativeChunkEventPayload, NarrativeCompleteEventPayload, NarrativeMetadataEventPayload, MetadataEventPayload, DoneEventPayload, ErrorEventPayload, NarrativeSSEEventPayload, } from './sse/narrative';
-export type { TimeState, WorldEntity, Player, NPC, Location, WorldReduced, DialogMessage, HistoryEntry, PresentationCache, Session, StoryArc, } from './game-state';
+export type { TimeState, WorldEntity, Player, NPC, Location, WorldReduced, DialogMessage, HistoryEntry, PresentationCache, Session, StoryArc, AIOperationTokens, AIMetadata, Tag, BaseImmutableState, ImmutableState, GenreImmutableState, } from './game-state';
 export type { NarrativeFontPreferences, SoundPreferences, ModelStackPreset, ModelEntry, ModelStack, ModelStackPreferences, SystemModelPresets, AIPreferences, UserPreferences, UserMetadata, } from './user-preferences';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "zeus-api-types",
-  "version": "1.0.45",
+  "version": "1.0.48",
   "description": "Shared API types for Wagtales - SSE payloads, error types, and common interfaces",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -20,7 +20,7 @@
     "build": "tsc",
     "clean": "rimraf dist",
     "prepublishOnly": "npm run build",
-    "publish": "npm version patch && npm publish"
+    "release": "npm version patch && npm publish"
   },
   "keywords": [
     "wagtales",