zeus-api-types 1.0.47 → 1.0.48

package/dist/game-state.d.ts

@@ -1,3 +1,75 @@
+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)
  */

package/dist/game-state.js

@@ -1,2 +1,5 @@
 "use strict";
+// ============================================================================
+// 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.47",
+  "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",