@its-not-rocket-science/ananke 0.1.69 → 0.5.1

package/dist/src/world-evolution.d.ts

@@ -0,0 +1,201 @@
+import { WORLD_EVOLUTION_BACKEND_SCHEMA_VERSION, type WorldEvolutionDelta, type WorldEvolutionMetrics, type WorldEvolutionRulesetId, type WorldEvolutionRulesetProfile, type WorldEvolutionRunResult, type WorldEvolutionSnapshot } from "./world-evolution-backend/index.js";
+export declare const WORLD_EVOLUTION_ORCHESTRATION_SCHEMA_VERSION: "ananke.world-evolution-orchestration.v1";
+export declare const WORLD_EVOLUTION_ENGINE_VERSION = "0.5.1";
+export declare const WORLD_EVOLUTION_CHECKPOINT_SCHEMA_VERSION: "ananke.world-evolution-checkpoint.v1";
+export type EvolutionRuleset = WorldEvolutionRulesetProfile;
+export interface EvolutionSessionConfig {
+    seed: number;
+    canonicalSnapshot: WorldEvolutionSnapshot;
+    rulesetId?: WorldEvolutionRulesetId;
+    ruleset?: EvolutionRuleset;
+    checkpointInterval?: number;
+    includeDeltas?: boolean;
+    label?: string;
+}
+export interface EvolutionRequest {
+    steps: number;
+    checkpointInterval?: number;
+    includeDeltas?: boolean;
+    includeCheckpointDiffs?: boolean;
+}
+export interface EvolutionTimelineEvent {
+    step: number;
+    tick: number;
+    kind: "evolution.step";
+    summary: string;
+    tradeCount: number;
+    warCount: number;
+    migrationCount: number;
+    climateEventCount: number;
+    epidemicPopulationDelta: number;
+    metrics: WorldEvolutionMetrics;
+}
+export interface EvolutionCheckpoint {
+    step: number;
+    tick: number;
+    summary: string;
+    snapshot: WorldEvolutionSnapshot;
+    metadata: EvolutionCheckpointMetadata;
+}
+export interface EvolutionCheckpointMetadata {
+    engineVersion: string;
+    seed: number;
+    rulesetProfile: EvolutionRuleset;
+    step: number;
+    schemaVersion: typeof WORLD_EVOLUTION_BACKEND_SCHEMA_VERSION;
+}
+export interface EvolutionCheckpointDiff {
+    fromStep: number;
+    toStep: number;
+    fromTick: number;
+    toTick: number;
+    fromSnapshotHash: string;
+    toSnapshotHash: string;
+    worldChanges: Record<string, unknown>;
+    polityDeltas: Array<{
+        polityId: string;
+        populationDelta: number;
+        treasuryDelta_cu: number;
+        stabilityDelta_Q: number;
+        moraleDelta_Q: number;
+    }>;
+}
+export interface SerializedEvolutionCheckpoint {
+    schemaVersion: typeof WORLD_EVOLUTION_CHECKPOINT_SCHEMA_VERSION;
+    checkpoint: EvolutionCheckpoint;
+}
+export interface EvolutionRunResult {
+    schemaVersion: typeof WORLD_EVOLUTION_ORCHESTRATION_SCHEMA_VERSION;
+    engineVersion: string;
+    sessionId: string;
+    request: EvolutionRequest;
+    ruleset: EvolutionRuleset;
+    initialSnapshot: WorldEvolutionSnapshot;
+    finalSnapshot: WorldEvolutionSnapshot;
+    timeline: EvolutionTimelineEvent[];
+    metrics: WorldEvolutionMetrics;
+    checkpoints?: EvolutionCheckpoint[];
+    checkpointDiffs?: EvolutionCheckpointDiff[];
+    deltas?: WorldEvolutionDelta[];
+}
+export interface EvolutionSessionSummary {
+    schemaVersion: typeof WORLD_EVOLUTION_ORCHESTRATION_SCHEMA_VERSION;
+    sessionId: string;
+    label?: string;
+    engineVersion: string;
+    seed: number;
+    totalSteps: number;
+    ruleset: EvolutionRuleset;
+    initialSnapshot: WorldEvolutionSnapshot;
+    currentSnapshot: WorldEvolutionSnapshot;
+    metrics: WorldEvolutionMetrics;
+    timelineEvents: number;
+    checkpointCount: number;
+}
+export interface EvolutionSession {
+    readonly sessionId: string;
+    readonly schemaVersion: typeof WORLD_EVOLUTION_ORCHESTRATION_SCHEMA_VERSION;
+    readonly engineVersion: string;
+    readonly seed: number;
+    readonly label?: string;
+    readonly ruleset: EvolutionRuleset;
+    readonly canonicalInitialSnapshot: WorldEvolutionSnapshot;
+    readonly state: {
+        totalSteps: number;
+        currentSnapshot: WorldEvolutionSnapshot;
+        timeline: EvolutionTimelineEvent[];
+        checkpoints: EvolutionCheckpoint[];
+        lastMetrics: WorldEvolutionMetrics;
+        defaultCheckpointInterval?: number;
+        defaultIncludeDeltas: boolean;
+    };
+}
+export interface ResumeEvolutionOptions {
+    label?: string;
+    checkpointInterval?: number;
+    includeDeltas?: boolean;
+}
+export interface EvolutionBranchMetadata {
+    name: string;
+    description?: string;
+    seed: number;
+    rulesetProfile: EvolutionRuleset;
+    createdAtStep: number;
+    parentBranchId?: string;
+}
+export interface EvolutionBranchSnapshotRef {
+    snapshot: WorldEvolutionSnapshot;
+    step: number;
+    tick: number;
+    snapshotHash: string;
+}
+export interface EvolutionBranchDerivedState {
+    totalSteps: number;
+    currentSnapshot: WorldEvolutionSnapshot;
+    timeline: EvolutionTimelineEvent[];
+    lastMetrics: WorldEvolutionMetrics;
+}
+export interface EvolutionBranch {
+    branchId: string;
+    schemaVersion: typeof WORLD_EVOLUTION_ORCHESTRATION_SCHEMA_VERSION;
+    baseSnapshotRef: EvolutionBranchSnapshotRef;
+    derivedState: EvolutionBranchDerivedState;
+    branchMetadata: EvolutionBranchMetadata;
+}
+export interface CreateEvolutionBranchInput {
+    baseSnapshot: WorldEvolutionSnapshot;
+    metadata: {
+        name: string;
+        description?: string;
+        seed: number;
+        rulesetProfile?: EvolutionRuleset;
+        rulesetId?: WorldEvolutionRulesetId;
+        createdAtStep?: number;
+        parentBranchId?: string;
+    };
+    baseStep?: number;
+}
+export interface ForkEvolutionBranchInput {
+    metadata: {
+        name: string;
+        description?: string;
+        seed?: number;
+        rulesetProfile?: EvolutionRuleset;
+        rulesetId?: WorldEvolutionRulesetId;
+    };
+}
+export interface EvolutionBranchDiff {
+    branchId: string;
+    baseSnapshotRef: Pick<EvolutionBranchSnapshotRef, "step" | "tick" | "snapshotHash">;
+    branchStep: number;
+    branchTick: number;
+    branchSnapshotHash: string;
+    worldChanges: Record<string, unknown>;
+    polityDeltas: Array<{
+        polityId: string;
+        populationDelta: number;
+        treasuryDelta_cu: number;
+        stabilityDelta_Q: number;
+        moraleDelta_Q: number;
+    }>;
+}
+export declare function createEvolutionSession(config: EvolutionSessionConfig): EvolutionSession;
+export declare function runEvolution(session: EvolutionSession, request: EvolutionRequest): EvolutionRunResult;
+export declare function stepEvolution(session: EvolutionSession, request?: Omit<EvolutionRequest, "steps"> & {
+    steps?: number;
+}): EvolutionRunResult;
+export declare function getEvolutionSummary(session: EvolutionSession): EvolutionSessionSummary;
+export declare function resumeEvolutionSessionFromCheckpoint(checkpoint: EvolutionCheckpoint, options?: ResumeEvolutionOptions): EvolutionSession;
+export declare function createEvolutionBranch(input: CreateEvolutionBranchInput): EvolutionBranch;
+export declare function forkEvolutionBranch(branch: EvolutionBranch, input: ForkEvolutionBranchInput): EvolutionBranch;
+export declare function runEvolutionOnBranch(branch: EvolutionBranch, request: EvolutionRequest): EvolutionRunResult;
+export declare function diffBranchAgainstBase(branch: EvolutionBranch): EvolutionBranchDiff;
+export declare function serializeEvolutionResult(result: EvolutionRunResult): string;
+export declare function deserializeEvolutionResult(json: string): EvolutionRunResult;
+export declare function serializeEvolutionCheckpoint(checkpoint: EvolutionCheckpoint): string;
+export declare function deserializeEvolutionCheckpoint(json: string): EvolutionCheckpoint;
+export declare function serializeEvolutionIntermediateState(session: EvolutionSession): string;
+export declare function serializeEvolutionFinalState(result: Pick<EvolutionRunResult, "finalSnapshot" | "sessionId" | "engineVersion" | "ruleset">): string;
+export declare function buildEvolutionCheckpointDiffs(checkpoints: readonly EvolutionCheckpoint[]): EvolutionCheckpointDiff[];
+export type { WorldEvolutionSnapshot, WorldEvolutionMetrics, WorldEvolutionDelta, WorldEvolutionRulesetId, };
+export type { WorldEvolutionRunResult as EvolutionBackendRunResult };