@ai-rpg-engine/modules 2.0.2 → 2.0.4

package/dist/pressure-system.d.ts

@@ -0,0 +1,101 @@
+import type { PlayerRumor } from './player-rumor.js';
+import type { PressureResolution } from './pressure-resolution.js';
+export type PressureKind = 'bounty-issued' | 'faction-summons' | 'merchant-blacklist' | 'revenge-attempt' | 'investigation-opened' | 'heresy-whisper' | 'chapel-sanction' | 'case-opened' | 'witness-vanished' | 'mutiny-brewing' | 'navy-bounty' | 'infection-suspicion' | 'camp-panic' | 'corp-manhunt' | 'ice-escalation';
+export type PressureVisibility = 'hidden' | 'rumored' | 'known' | 'public';
+export type WorldPressure = {
+    id: string;
+    kind: PressureKind;
+    /** Faction that generated this pressure */
+    sourceFactionId: string;
+    /** Structured claim about what this pressure represents */
+    description: string;
+    /** What triggered it — rumor id, milestone label, or event type */
+    triggeredBy: string;
+    /** 0-1, higher = more imminent */
+    urgency: number;
+    /** How widely known this pressure is */
+    visibility: PressureVisibility;
+    /** Turns remaining before expiry (null = permanent until resolved) */
+    turnsRemaining: number | null;
+    /** Possible outcomes if the player engages or ignores */
+    potentialOutcomes: string[];
+    /** Genre/thematic tags */
+    tags: string[];
+    /** Engine tick when created */
+    createdAtTick: number;
+    /** Set when pressure is resolved (transitions from active to resolved) */
+    resolution?: PressureResolution;
+    /** If this pressure was spawned by fallout from another pressure */
+    chainedFrom?: string;
+};
+export type PressureInputs = {
+    playerRumors: PlayerRumor[];
+    reputation: Array<{
+        factionId: string;
+        value: number;
+    }>;
+    milestones: Array<{
+        label: string;
+        tags: string[];
+    }>;
+    factionStates: Record<string, {
+        alertLevel: number;
+        cohesion: number;
+    }>;
+    districtMetrics?: Record<string, {
+        alertPressure: number;
+        rumorDensity: number;
+        stability: number;
+    }>;
+    playerLevel: number;
+    totalTurns: number;
+    activePressures: WorldPressure[];
+    /** From PackMetadata.genres[0], e.g. 'fantasy', 'cyberpunk' */
+    genre: string;
+    /** Current engine tick for timestamps */
+    currentTick: number;
+};
+export type PressureSpawnResult = {
+    pressure: WorldPressure;
+    /** One-line reason for director mode */
+    reason: string;
+};
+export type PressureTickResult = {
+    /** Pressures still active after this tick */
+    active: WorldPressure[];
+    /** Pressures that expired this tick (turnsRemaining hit 0) */
+    expired: WorldPressure[];
+};
+/**
+ * Tick all active pressures: decrement timers, remove expired,
+ * escalate visibility over time. Returns active + expired arrays.
+ */
+export declare function tickPressures(pressures: WorldPressure[], currentTick: number): PressureTickResult;
+/**
+ * Evaluate simulation state for new pressure. Returns at most ONE new pressure.
+ * Returns null most turns — scarcity by design.
+ */
+export declare function evaluatePressures(inputs: PressureInputs): PressureSpawnResult | null;
+/** Get pressures originating from a specific faction. */
+export declare function getPressuresForFaction(pressures: WorldPressure[], factionId: string): WorldPressure[];
+/** Get pressures the player would be aware of (not hidden). */
+export declare function getVisiblePressures(pressures: WorldPressure[]): WorldPressure[];
+/** Format a single pressure for the director /pressures view. */
+export declare function formatPressureForDirector(pressure: WorldPressure): string;
+/** Compact summary for narrator prompt injection (~15 tokens). */
+export declare function formatPressureForNarrator(pressure: WorldPressure): string;
+/** NPC-facing description for dialogue context. */
+export declare function formatPressureForDialogue(pressure: WorldPressure): string;
+export declare function makePressure(opts: {
+    kind: PressureKind;
+    sourceFactionId: string;
+    description: string;
+    triggeredBy: string;
+    urgency: number;
+    visibility: PressureVisibility;
+    turnsRemaining: number | null;
+    potentialOutcomes: string[];
+    tags: string[];
+    currentTick: number;
+}): WorldPressure;
+//# sourceMappingURL=pressure-system.d.ts.map

package/dist/pressure-system.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pressure-system.d.ts","sourceRoot":"","sources":["../src/pressure-system.ts"],"names":[],"mappings":"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"}