holonovel 2026.8.22

package/dist/core/state.d.ts

@@ -0,0 +1,396 @@
+import { WorldModel } from "../world/model.js";
+export type Badge = "player" | "game_master" | "observer" | "none";
+export declare function normalizeBadge(raw: unknown): Badge;
+export declare function migrateNovelData(data: any): any;
+export interface NovelEntity {
+    id: string;
+    name: string;
+    personality?: {
+        description?: string;
+        voice?: string;
+        background?: string;
+        goals?: string;
+    };
+    voice_examples?: {
+        context: string;
+        dialogue: string;
+        tag?: string;
+    }[];
+    inventory: string[];
+    current_room: string | null;
+    conditions: string[];
+    condition_rounds: Record<string, number>;
+    stats?: Record<string, any>;
+}
+export interface NpcState {
+    id: string;
+    name: string;
+    description?: string;
+    disposition?: string;
+    location?: string;
+    personality?: {
+        description?: string;
+        voice?: string;
+        background?: string;
+        goals?: string;
+    };
+    voice_examples?: {
+        context: string;
+        dialogue: string;
+        tag?: string;
+    }[];
+    conditions: string[];
+    condition_rounds: Record<string, number>;
+}
+export interface LoreEntry {
+    key: string;
+    content: string;
+    triggers: string[];
+    badge_scope: "game_master" | "shared";
+    priority: number;
+    sticky: number;
+    sticky_remaining: number;
+    enabled: boolean;
+    group?: string;
+}
+export interface Countdown {
+    name: string;
+    ticks: number;
+    total: number;
+    type: "round" | "narrative";
+    scope?: string;
+    direction?: string;
+    clock_type?: "danger" | "racing" | "linked" | "tug_of_war" | "faction" | "mission";
+    on_scene_transition?: boolean;
+}
+export interface CombatState {
+    participants: string[];
+    dangers: {
+        name: string;
+        ac?: number;
+        hp?: number;
+        max_hp?: number;
+        initiative_bonus?: number;
+    }[];
+    round: number;
+    turn_order: string[];
+    current_turn: number;
+    active: boolean;
+}
+export interface AuditEntry {
+    timestamp: string;
+    badge: Badge;
+    tool: string;
+    args: string;
+    output_prefix: string;
+    hash: string;
+}
+export interface StoryEntry {
+    index: number;
+    type: "decision" | "moment" | "revelation" | "bond" | "consequence";
+    entry: string;
+    scene_anchor: string;
+    entity_ids: string[];
+    timestamp: string;
+}
+export interface FactionState {
+    id: string;
+    name: string;
+    description: string;
+    goals: string[];
+    resources: string;
+    clock: number;
+    clock_max: number;
+    status: string;
+}
+export interface SecretState {
+    key: string;
+    content: string;
+    triggers: string[];
+    badge_scope: "game_master" | "shared";
+    known_by: string[];
+}
+export interface Relationship {
+    entity_a: string;
+    entity_b: string;
+    type: "ally" | "rival" | "neutral" | "mentor" | "dependent" | "suspicious";
+    value?: number;
+    description?: string;
+}
+export interface GMContext {
+    current_scene?: string;
+    immediate_situation?: string;
+    pending_player_action?: string;
+    short_term_plans?: string;
+    long_term_plans?: string;
+    active_threads?: {
+        name: string;
+        status: string;
+        urgency: string;
+        description: string;
+    }[];
+    npc_attitudes?: Record<string, string>;
+    player_goals?: string;
+    saved_at?: string;
+    story_context?: string[];
+    active_vows?: {
+        name: string;
+        difficulty: string;
+        milestone_count: number;
+    }[];
+    faction_clocks?: {
+        name: string;
+        clock: number;
+        clock_max: number;
+        status: string;
+    }[];
+    countdown_positions?: {
+        name: string;
+        ticks: number;
+        total: number;
+    }[];
+    npc_dispositions?: {
+        name: string;
+        disposition?: string;
+        location?: string;
+    }[];
+    relationships?: Relationship[];
+}
+export interface CodexEntry {
+    id: string;
+    kind: string;
+    visibility: "library" | "shared" | "private";
+    name: string;
+    content: Record<string, any>;
+    description?: string;
+    tags?: string[];
+    imported_at: string;
+    codex_modified_at: string;
+}
+export interface VowState {
+    name: string;
+    description: string;
+    parties: string[];
+    difficulty: "troublesome" | "dangerous" | "formidable" | "extreme" | "epic";
+    scope: "gm" | "shared" | "faction" | "party";
+    milestones: number;
+    rank_track: number;
+    state: "active" | "resolved" | "forsaken";
+    outcome?: string;
+    consequences?: string;
+    reason?: string;
+}
+export interface NoteEntry {
+    key: string;
+    content: string;
+    badge_scope: "game_master" | "player" | "shared";
+}
+export interface Checkpoint {
+    label: string;
+    timestamp: string;
+    state: any;
+}
+export interface ConditionState {
+    conditions: string[];
+    condition_rounds: Record<string, number>;
+}
+export interface AutonomyState {
+    level: "full" | "mechanical_prompt" | "manual";
+    confirmation: "auto" | "confirm" | "prompt";
+    safety: "safe" | "moderate" | "hardcore";
+    creativity: "predictable" | "standard" | "chaotic";
+    confirmed_safety_tiers: string[];
+}
+export declare const DEFAULT_AUTONOMY: AutonomyState;
+export declare function normalizeAutonomy(raw: unknown): AutonomyState;
+export declare function autonomyDefaultsFromEnv(): AutonomyState;
+export declare const DIFFICULTY_TRACKS: Record<string, number>;
+export interface NovelState {
+    slug: string;
+    name: string;
+    ruleset: string | null;
+    badge: Badge;
+    entities: Map<string, NovelEntity>;
+    active_entity_id: string | null;
+    npcs: Map<string, NpcState>;
+    scene_description: string;
+    scene_location?: string;
+    scene_time_of_day?: string;
+    scene_atmosphere?: string;
+    scene_history: {
+        timestamp: string;
+        description: string;
+        location?: string;
+        time_of_day?: string;
+        atmosphere?: string;
+    }[];
+    scene_type: ("combat" | "social" | "exploration" | "neutral")[];
+    narrative_directive: string;
+    combat: CombatState | null;
+    countdowns: Map<string, Countdown>;
+    lore: Map<string, LoreEntry>;
+    briefing_assembly_count: number;
+    player_signals: Record<string, string>;
+    adventure_slug: string | null;
+    generated_adventure: any | null;
+    audit_log: AuditEntry[];
+    undo_stacks: Record<string, NovelState[]>;
+    redo_stacks: Record<string, NovelState[]>;
+    briefing_order: string[];
+    action_patterns_enabled: boolean;
+    session_zero_completed: boolean;
+    characters_present: boolean;
+    characters_present_ids: string[];
+    adventure_set: boolean;
+    pending_workflow: {
+        decision: string;
+        snapshot: any;
+    } | {
+        decision: string;
+        snapshot: any;
+        creation?: import("./character-creation.js").CreationWorkflowState;
+    } | null;
+    connection_counter: number;
+    pending_staleness_counter: number;
+    pov_mode: "character" | "omniscient";
+    autonomy: AutonomyState;
+    help_category_overrides: Record<string, string>;
+    story_journal: StoryEntry[];
+    factions: FactionState[];
+    secrets: SecretState[];
+    relationships: Relationship[];
+    gm_context: GMContext;
+    constraint_overrides: {
+        type: string;
+        name?: string;
+        source?: string;
+        prerequisites?: string[];
+        slots_remaining?: number;
+        match_all?: boolean;
+    }[];
+    synthesis_activated: Record<string, number>;
+    synthesis_module_enabled: Record<string, boolean>;
+    notes: NoteEntry[];
+    vows: VowState[];
+    checkpoints: Checkpoint[];
+    description: string;
+    genre: string;
+    adventure_index: {
+        npcs: Array<{
+            name: string;
+            description?: string;
+        }>;
+        locations: Array<{
+            name: string;
+            description: string;
+        }>;
+        factions: Array<{
+            name: string;
+            goals?: string;
+        }>;
+        premise: string;
+        hooks: string[];
+    } | null;
+    adventure_scene_waypoint: {
+        anchor: string;
+        description: string;
+    } | null;
+    world: WorldModel;
+    metadata: {
+        created: string;
+        modified: string;
+        session_count: number;
+        total_combat_rounds: number;
+        last_scene_anchor: string;
+    };
+}
+export interface RosterEntity extends NovelEntity {
+}
+export declare class StateManager {
+    novels: Map<string, NovelState>;
+    roster: Map<string, RosterEntity>;
+    activeNovelId: string | null;
+    buildFingerprint: {
+        specVersion: string;
+        specRepoUrl: string;
+        specHash: string;
+        sourceHash: string;
+        rulesetHash: string;
+        buildTimestamp: string;
+        lastSpecReview?: string;
+        lastGauntlet?: string;
+    };
+    enriched: boolean;
+    enrichmentManifest: any;
+    maxLoreTokens: number | null;
+    serverNotes: Map<string, string>;
+    codex: Map<string, CodexEntry>;
+    private npcCounter;
+    private entityCounter;
+    private stateDir;
+    constructor(stateDir: string);
+    get activeNovel(): NovelState | undefined;
+    requireGM(badge: Badge): void;
+    requirePlayer(badge: Badge): void;
+    requireNotObserver(badge: Badge): void;
+    requireNovel(): NovelState;
+    getActiveEntity(): NovelEntity | undefined;
+    resolveEntity(entityId?: string): NovelEntity;
+    resolveEntityNullable(entityId?: string): NovelEntity | undefined;
+    createNovel(name: string, ruleset?: string | null): NovelState;
+    bindNovelRuleset(slug: string): NovelState;
+    resumeNovel(slug: string): NovelState;
+    private loadNovelFromData;
+    switchNovel(slug: string): NovelState;
+    endNovel(novel: NovelState, dispose: "yes" | "cancel"): {
+        removed: boolean;
+    };
+    cleanupExpiredTrash(): void;
+    snapshot(novel: NovelState, badge: Badge): void;
+    undo(novel: NovelState, badge: Badge): {
+        data: any;
+    } | null;
+    redo(novel: NovelState, badge: Badge): {
+        data: any;
+    } | null;
+    audit(novel: NovelState, badge: Badge, tool: string, args: any, output_prefix?: string): void;
+    auditForbidden(badge: Badge, tool: string, args: any): void;
+    verifyAuditChain(novel: NovelState): {
+        valid: boolean;
+        entries: number;
+        first_broken_index?: number;
+    };
+    getEnrichmentHealth(): any;
+    initCombat(novel: NovelState, participants: string[], dangers: {
+        name: string;
+        ac?: number;
+        hp?: number;
+        max_hp?: number;
+        initiative_bonus?: number;
+    }[], seedStr?: string): CombatState;
+    advanceCombat(novel: NovelState): CombatState;
+    endCombat(novel: NovelState, outcome: string): void;
+    addCombatParticipant(novel: NovelState, participantId: string): CombatState;
+    removeCombatParticipant(novel: NovelState, participantId: string): {
+        combat: CombatState | null;
+        ended: boolean;
+        outcome?: string;
+    };
+    combatReport(novel: NovelState): string;
+    worldHasRooms(novel: NovelState): boolean;
+    saveNovel(novel: NovelState): void;
+    saveRoster(): void;
+    loadRoster(): void;
+    addToRoster(entity: NovelEntity): string;
+    loadServerNotes(): void;
+    saveServerNotes(): void;
+    loadCodex(): void;
+    saveCodex(): void;
+    createEntity(name: string, personality?: {
+        description?: string;
+        voice?: string;
+        background?: string;
+        goals?: string;
+    }, stats?: Record<string, any>): NovelEntity;
+    addEntity(novel: NovelState, entity: NovelEntity): void;
+}