zeus-api-types 1.0.71 → 1.0.72

package/dist/game-state.d.ts

@@ -182,6 +182,26 @@ export interface DialogContext {
     last_updated_turn?: number;
     history: DialogMessage[];
 }
+export declare const MetadataPromptTargets: {
+    readonly narrativeTurn0: number;
+    readonly narrative: number;
+    readonly narrativeLastTurn: number;
+    readonly update: number;
+    readonly gameInit: number;
+    readonly choiceMetadata: number;
+    readonly dialog: number;
+};
+export type MetadataPromptTargetKey = keyof typeof MetadataPromptTargets;
+export type MetadataPromptTargetMask = (typeof MetadataPromptTargets)[MetadataPromptTargetKey];
+export declare const ALL_METADATA_PROMPT_TARGETS: number;
+export declare function hasMetadataPromptTarget(mask: number, target: MetadataPromptTargetMask): boolean;
+export declare function buildMetadataPromptIncludeMask(targets: MetadataPromptTargetKey[]): number;
+export type MetadataCustomDataShapeValue = string | number | boolean;
+export interface MetadataCustomDataShapeEntry {
+    promptIncludeMask?: number;
+    [key: string]: MetadataCustomDataShapeValue | undefined;
+}
+export type MetadataCustomDataShape = Record<string, MetadataCustomDataShapeEntry>;
 /**
  * Metadata for game state
  * NOTE: genre moved to immutable block (pre-MVP, no backward compatibility)
@@ -203,6 +223,7 @@ export interface Metadata {
     nextActPrologue?: string;
     nextActTime?: string;
     nextActLocation?: string;
+    customDataShape?: MetadataCustomDataShape;
     user?: UserMetadata;
     [key: string]: unknown;
 }

package/dist/game-state.js

@@ -1,7 +1,10 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.ALL_METADATA_PROMPT_TARGETS = exports.MetadataPromptTargets = void 0;
 exports.computeTimeString = computeTimeString;
 exports.formatTimeHuman = formatTimeHuman;
+exports.hasMetadataPromptTarget = hasMetadataPromptTarget;
+exports.buildMetadataPromptIncludeMask = buildMetadataPromptIncludeMask;
 /**
  * Derives the canonical time string from scalar time fields.
  * Use this everywhere instead of reading time.current, which may be stale.
@@ -22,3 +25,20 @@ function formatTimeHuman(time) {
     const minute = time.minute.toString().padStart(2, '0');
     return `Day ${time.day}, ${hour12}:${minute}${period}`;
 }
+exports.MetadataPromptTargets = {
+    narrativeTurn0: 1 << 0,
+    narrative: 1 << 1,
+    narrativeLastTurn: 1 << 2,
+    update: 1 << 3,
+    gameInit: 1 << 4,
+    choiceMetadata: 1 << 5,
+    dialog: 1 << 6,
+};
+exports.ALL_METADATA_PROMPT_TARGETS = Object.values(exports.MetadataPromptTargets)
+    .reduce((mask, target) => mask | target, 0);
+function hasMetadataPromptTarget(mask, target) {
+    return (mask & target) === target;
+}
+function buildMetadataPromptIncludeMask(targets) {
+    return targets.reduce((mask, target) => mask | exports.MetadataPromptTargets[target], 0);
+}

package/dist/index.d.ts

@@ -3,7 +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 { ALL_METADATA_PROMPT_TARGETS, buildMetadataPromptIncludeMask, computeTimeString, formatTimeHuman, hasMetadataPromptTarget, MetadataPromptTargets } from './game-state';
+export type { BaseImmutableState, DialogContext, DialogMessage, GameMetadata, GameState, GameStateReduced, GenreImmutableState, HistoryEntry, ImmutableState, Location, Metadata, MetadataCustomDataShape, MetadataCustomDataShapeEntry, MetadataCustomDataShapeValue, MetadataPromptTargetKey, MetadataPromptTargetMask, 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,7 +1,11 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.formatTimeHuman = exports.computeTimeString = void 0;
+exports.MetadataPromptTargets = exports.hasMetadataPromptTarget = exports.formatTimeHuman = exports.computeTimeString = exports.buildMetadataPromptIncludeMask = exports.ALL_METADATA_PROMPT_TARGETS = void 0;
 // Game State Utilities (value exports — not type-only)
 var game_state_1 = require("./game-state");
+Object.defineProperty(exports, "ALL_METADATA_PROMPT_TARGETS", { enumerable: true, get: function () { return game_state_1.ALL_METADATA_PROMPT_TARGETS; } });
+Object.defineProperty(exports, "buildMetadataPromptIncludeMask", { enumerable: true, get: function () { return game_state_1.buildMetadataPromptIncludeMask; } });
 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; } });
+Object.defineProperty(exports, "hasMetadataPromptTarget", { enumerable: true, get: function () { return game_state_1.hasMetadataPromptTarget; } });
+Object.defineProperty(exports, "MetadataPromptTargets", { enumerable: true, get: function () { return game_state_1.MetadataPromptTargets; } });

package/package.json

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