run-dmcp 0.1.0

package/dist/types/index.d.ts

@@ -0,0 +1,969 @@
+export interface Game {
+    id: string;
+    name: string;
+    setting: string;
+    style: string;
+    rules: RuleSystem | null;
+    preferences: GamePreferences | null;
+    currentLocationId: string | null;
+    titleImageId: string | null;
+    faviconImageId: string | null;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface GameSummary {
+    id: string;
+    name: string;
+    setting: string;
+    style: string;
+    titleImageId: string | null;
+    faviconImageId: string | null;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface GamePreferences {
+    genre: PreferenceValue<string>;
+    tone: PreferenceValue<string>;
+    setting: PreferenceValue<string>;
+    complexity: PreferenceValue<string>;
+    combatFrequency: PreferenceValue<string>;
+    combatStyle: PreferenceValue<string>;
+    lethality: PreferenceValue<string>;
+    narrativeStyle: PreferenceValue<string>;
+    playerAgency: PreferenceValue<string>;
+    npcDepth: PreferenceValue<string>;
+    romanceContent: PreferenceValue<string>;
+    worldFamiliarity: PreferenceValue<string>;
+    magicOrTechLevel: PreferenceValue<string>;
+    politicalComplexity: PreferenceValue<string>;
+    sessionLength: PreferenceValue<string>;
+    pacingPreference: PreferenceValue<string>;
+    contentToAvoid: string[];
+    contentToInclude: string[];
+    inspirations: string[];
+    characterCreation: PreferenceValue<string>;
+    startingPowerLevel: PreferenceValue<string>;
+    additionalNotes: string;
+    imageGenerationPresets?: ImageGenerationPreset[];
+    defaultImagePresetId?: string;
+    imagePromptTemplates?: ImagePromptTemplate[];
+}
+export interface ImageGenerationPreset {
+    id: string;
+    name: string;
+    description?: string;
+    entityTypes?: string[];
+    isDefault?: boolean;
+    config: ImageGenerationPreferences;
+    createdAt?: string;
+    updatedAt?: string;
+}
+export interface ImagePromptTemplate {
+    id: string;
+    name: string;
+    description?: string;
+    entityType: string;
+    promptTemplate: string;
+    negativePromptTemplate?: string;
+    promptPrefix?: string;
+    promptSuffix?: string;
+    fieldAliases?: Record<string, string>;
+    defaults?: Record<string, string>;
+    priority?: number;
+    isDefault?: boolean;
+    createdAt?: string;
+    updatedAt?: string;
+}
+export interface ImageGenerationPreferences {
+    defaultTool?: "dalle" | "sdxl" | "midjourney" | "comfyui" | "flux" | "other";
+    defaultStyle?: {
+        artisticStyle?: string;
+        mood?: string;
+        colorScheme?: string;
+        qualityTags?: string[];
+        negativePrompts?: string[];
+        influences?: string[];
+    };
+    comfyui?: {
+        endpoint?: string;
+        checkpoint?: string;
+        loras?: Array<{
+            name: string;
+            weight: number;
+        }>;
+        samplerSettings?: {
+            sampler?: string;
+            scheduler?: string;
+            steps?: number;
+            cfg?: number;
+        };
+        workflows?: Record<string, {
+            name: string;
+            description?: string;
+            workflow: Record<string, unknown>;
+            inputNodes?: {
+                positivePrompt?: string;
+                negativePrompt?: string;
+                checkpoint?: string;
+                seed?: string;
+                width?: string;
+                height?: string;
+                steps?: string;
+                cfg?: string;
+                sampler?: string;
+                scheduler?: string;
+            };
+        }>;
+        defaultWorkflowId?: string;
+        defaultWorkflow?: string;
+        workflowOverrides?: Record<string, unknown>;
+    };
+    dalle?: {
+        model?: string;
+        quality?: "standard" | "hd";
+        style?: "vivid" | "natural";
+        size?: "1024x1024" | "1792x1024" | "1024x1792";
+    };
+    midjourney?: {
+        version?: string;
+        stylize?: number;
+        chaos?: number;
+        quality?: number;
+        aspectRatio?: string;
+    };
+    sdxl?: {
+        model?: string;
+        samplerName?: string;
+        steps?: number;
+        cfg?: number;
+        width?: number;
+        height?: number;
+        negativePrompt?: string;
+    };
+    flux?: {
+        model?: string;
+        steps?: number;
+        guidance?: number;
+    };
+    defaults?: {
+        aspectRatio?: string;
+        generateOnCreate?: boolean;
+        savePrompts?: boolean;
+        framing?: {
+            character?: string;
+            location?: string;
+            item?: string;
+        };
+    };
+    consistency?: {
+        maintainColorPalette?: boolean;
+        characterSeedImages?: Record<string, string>;
+        styleReferenceImage?: string;
+        useCharacterRefs?: boolean;
+    };
+    notes?: string;
+}
+export interface PreferenceValue<T> {
+    value: T | null;
+    delegatedToDM: boolean;
+    notes?: string;
+}
+export interface InterviewQuestion {
+    id: keyof GamePreferences;
+    category: string;
+    question: string;
+    description: string;
+    options?: {
+        value: string;
+        label: string;
+        description: string;
+    }[];
+    allowFreeform: boolean;
+    allowDelegate: boolean;
+    delegateLabel?: string;
+}
+export interface ImageGeneration {
+    subject: SubjectDescription;
+    style: StyleDescription;
+    composition: CompositionDescription;
+    prompts?: {
+        generic?: string;
+        sdxl?: string;
+        dalle?: string;
+        midjourney?: string;
+        flux?: string;
+        comfyui?: ComfyUIPrompt;
+    };
+    generations?: GeneratedImage[];
+    consistency?: {
+        characterRef?: string;
+        seedImage?: string;
+        colorPalette?: string[];
+        styleRef?: string;
+    };
+}
+export interface SubjectDescription {
+    type: "character" | "location" | "item" | "scene";
+    primaryDescription: string;
+    physicalTraits?: {
+        age?: string;
+        gender?: string;
+        bodyType?: string;
+        height?: string;
+        skinTone?: string;
+        hairColor?: string;
+        hairStyle?: string;
+        eyeColor?: string;
+        facialFeatures?: string;
+        distinguishingMarks?: string[];
+    };
+    attire?: {
+        description: string;
+        colors?: string[];
+        materials?: string[];
+        accessories?: string[];
+    };
+    environment?: {
+        setting: string;
+        timeOfDay?: string;
+        weather?: string;
+        lighting?: string;
+        architecture?: string;
+        vegetation?: string;
+        notableFeatures?: string[];
+    };
+    objectDetails?: {
+        material?: string;
+        size?: string;
+        condition?: string;
+        glowOrEffects?: string;
+    };
+    pose?: string;
+    expression?: string;
+    action?: string;
+}
+export interface StyleDescription {
+    artisticStyle: string;
+    genre: string;
+    mood: string;
+    colorScheme?: string;
+    influences?: string[];
+    qualityTags?: string[];
+    negativeElements?: string[];
+}
+export interface CompositionDescription {
+    framing: string;
+    cameraAngle?: string;
+    aspectRatio?: string;
+    focusPoint?: string;
+    background?: string;
+    depth?: string;
+}
+export interface ComfyUIPrompt {
+    positive: string;
+    negative: string;
+    checkpoint?: string;
+    loras?: {
+        name: string;
+        weight: number;
+    }[];
+    samplerSettings?: {
+        sampler?: string;
+        scheduler?: string;
+        steps?: number;
+        cfg?: number;
+    };
+}
+export interface GeneratedImage {
+    id: string;
+    tool: string;
+    prompt: string;
+    url?: string;
+    base64?: string;
+    seed?: number;
+    timestamp: string;
+    metadata?: Record<string, unknown>;
+}
+export interface RuleSystem {
+    name: string;
+    description: string;
+    attributes: AttributeDef[];
+    skills: SkillDef[];
+    derivedStats: DerivedStatDef[];
+    combatRules: CombatRules;
+    checkMechanics: CheckMechanics;
+    progression: ProgressionRules;
+}
+export interface AttributeDef {
+    name: string;
+    abbreviation: string;
+    description: string;
+    defaultValue: number;
+    minValue: number;
+    maxValue: number;
+}
+export interface SkillDef {
+    name: string;
+    governingAttribute: string;
+    description: string;
+}
+export interface DerivedStatDef {
+    name: string;
+    abbreviation: string;
+    description: string;
+    formula: string;
+}
+export interface CombatRules {
+    initiativeFormula: string;
+    actionsPerTurn: number;
+    attackFormula: string;
+    defenseFormula: string;
+    damageFormula: string;
+    conditions: ConditionDef[];
+}
+export interface ConditionDef {
+    name: string;
+    description: string;
+    effects: string;
+}
+export interface CheckMechanics {
+    baseDice: string;
+    modifierCalculation: string;
+    difficultyScale: Record<string, number>;
+    criticalSuccess?: number;
+    criticalFailure?: number;
+}
+export interface ProgressionRules {
+    experienceFormula: string;
+    levelUpThresholds: number[];
+    attributePointsPerLevel: number;
+    skillPointsPerLevel: number;
+}
+export interface Character {
+    id: string;
+    gameId: string;
+    name: string;
+    isPlayer: boolean;
+    attributes: Record<string, number>;
+    skills: Record<string, number>;
+    status: CharacterStatus;
+    locationId: string | null;
+    notes: string;
+    voice: VoiceDescription | null;
+    imageGen: ImageGeneration | null;
+    createdAt: string;
+}
+export interface VoiceDescription {
+    pitch: "very_low" | "low" | "medium" | "high" | "very_high";
+    speed: "very_slow" | "slow" | "medium" | "fast" | "very_fast";
+    tone: string;
+    accent?: string;
+    quirks?: string[];
+    description?: string;
+}
+export interface CharacterStatus {
+    health: number;
+    maxHealth: number;
+    conditions: string[];
+    experience: number;
+    level: number;
+    [key: string]: unknown;
+}
+export interface Location {
+    id: string;
+    gameId: string;
+    name: string;
+    description: string;
+    properties: LocationProperties;
+    imageGen: ImageGeneration | null;
+}
+export interface LocationProperties {
+    exits: Exit[];
+    features: string[];
+    atmosphere: string;
+    [key: string]: unknown;
+}
+export interface Exit {
+    direction: string;
+    destinationId: string;
+    description?: string;
+    locked?: boolean;
+    hidden?: boolean;
+}
+export interface Item {
+    id: string;
+    gameId: string;
+    ownerId: string;
+    ownerType: "character" | "location";
+    name: string;
+    properties: ItemProperties;
+    imageGen: ImageGeneration | null;
+}
+export interface ItemProperties {
+    description: string;
+    type: string;
+    weight?: number;
+    value?: number;
+    effects?: string[];
+    [key: string]: unknown;
+}
+export interface Quest {
+    id: string;
+    gameId: string;
+    name: string;
+    description: string;
+    objectives: QuestObjective[];
+    status: "active" | "completed" | "failed" | "abandoned";
+    rewards?: string;
+}
+export interface QuestObjective {
+    id: string;
+    description: string;
+    completed: boolean;
+    optional?: boolean;
+}
+export interface NarrativeEvent {
+    id: string;
+    gameId: string;
+    eventType: string;
+    content: string;
+    metadata: Record<string, unknown>;
+    timestamp: string;
+}
+export interface Combat {
+    id: string;
+    gameId: string;
+    locationId: string;
+    participants: CombatParticipant[];
+    currentTurn: number;
+    round: number;
+    status: "active" | "resolved";
+    log: string[];
+}
+export interface CombatParticipant {
+    characterId: string;
+    initiative: number;
+    isActive: boolean;
+}
+export interface DiceRoll {
+    expression: string;
+    rolls: number[];
+    modifier: number;
+    total: number;
+}
+export interface CheckResult {
+    roll: DiceRoll;
+    modifier: number;
+    total: number;
+    difficulty: number;
+    success: boolean;
+    criticalSuccess: boolean;
+    criticalFailure: boolean;
+    margin: number;
+}
+export interface Resource {
+    id: string;
+    gameId: string;
+    ownerId: string | null;
+    ownerType: "game" | "character";
+    name: string;
+    description: string;
+    category: string | null;
+    value: number;
+    minValue: number | null;
+    maxValue: number | null;
+    createdAt: string;
+}
+export interface ResourceChange {
+    id: string;
+    resourceId: string;
+    previousValue: number;
+    newValue: number;
+    delta: number;
+    reason: string | null;
+    timestamp: string;
+}
+export type ConstraintKind = "bounded" | "monotonic" | "conserved";
+/** For 'monotonic': the only direction the value is allowed to move. */
+export type MonotonicDirection = "increasing" | "decreasing";
+export interface ResourceConstraint {
+    id: string;
+    gameId: string;
+    kind: ConstraintKind;
+    resourceIds: string[];
+    direction: MonotonicDirection | null;
+    total: number | null;
+    createdAt: string;
+}
+export interface GameDateTime {
+    year: number;
+    month: number;
+    day: number;
+    hour: number;
+    minute: number;
+}
+export interface CalendarConfig {
+    monthNames: string[];
+    daysPerMonth: number[];
+    hoursPerDay: number;
+    minutesPerHour: number;
+    startYear: number;
+    eraName?: string;
+}
+export interface GameTime {
+    gameId: string;
+    currentTime: GameDateTime;
+    calendarConfig: CalendarConfig;
+}
+export interface ExpiryConsequence {
+    resourceId: string;
+    delta: number;
+}
+export interface ScheduledEvent {
+    id: string;
+    gameId: string;
+    name: string;
+    description: string;
+    triggerTime: GameDateTime;
+    recurring: string | null;
+    triggered: boolean;
+    metadata: Record<string, unknown>;
+    consequence: ExpiryConsequence | null;
+}
+export interface Timer {
+    id: string;
+    gameId: string;
+    name: string;
+    description: string;
+    timerType: "countdown" | "stopwatch" | "clock";
+    currentValue: number;
+    maxValue: number | null;
+    direction: "up" | "down";
+    triggerAt: number | null;
+    triggered: boolean;
+    unit: string;
+    visibleToPlayers: boolean;
+    createdAt: string;
+    consequence: ExpiryConsequence | null;
+}
+export interface TableEntry {
+    minRoll: number;
+    maxRoll: number;
+    result: string;
+    weight?: number;
+    subtable?: string;
+    metadata?: Record<string, unknown>;
+}
+export interface RandomTable {
+    id: string;
+    gameId: string;
+    name: string;
+    description: string;
+    category: string | null;
+    entries: TableEntry[];
+    rollExpression: string;
+    createdAt: string;
+}
+export interface TableRollResult {
+    table: RandomTable;
+    roll: DiceRoll;
+    entry: TableEntry;
+    result: string;
+    subtableResults?: TableRollResult[];
+}
+export interface Secret {
+    id: string;
+    gameId: string;
+    name: string;
+    description: string;
+    category: string | null;
+    relatedEntityId: string | null;
+    relatedEntityType: string | null;
+    revealedTo: string[];
+    isPublic: boolean;
+    clues: string[];
+    createdAt: string;
+}
+export interface Relationship {
+    id: string;
+    gameId: string;
+    sourceId: string;
+    sourceType: string;
+    targetId: string;
+    targetType: string;
+    relationshipType: string;
+    value: number;
+    label: string | null;
+    notes: string;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface RelationshipChange {
+    id: string;
+    relationshipId: string;
+    previousValue: number;
+    newValue: number;
+    reason: string | null;
+    timestamp: string;
+}
+export interface Faction {
+    id: string;
+    gameId: string;
+    name: string;
+    description: string;
+    leaderId: string | null;
+    headquartersId: string | null;
+    resources: Record<string, number>;
+    goals: string[];
+    traits: string[];
+    status: "active" | "disbanded" | "hidden";
+    createdAt: string;
+}
+export interface Ability {
+    id: string;
+    gameId: string;
+    ownerId: string | null;
+    ownerType: "template" | "character";
+    name: string;
+    description: string;
+    category: string | null;
+    cost: Record<string, number>;
+    cooldown: number | null;
+    currentCooldown: number;
+    effects: string[];
+    requirements: Record<string, number>;
+    tags: string[];
+    createdAt: string;
+}
+export interface StatusEffect {
+    id: string;
+    gameId: string;
+    targetId: string;
+    name: string;
+    description: string;
+    effectType: "buff" | "debuff" | "neutral" | null;
+    duration: number | null;
+    stacks: number;
+    maxStacks: number | null;
+    effects: Record<string, number>;
+    sourceId: string | null;
+    sourceType: string | null;
+    expiresAt: string | null;
+    createdAt: string;
+}
+export interface Tag {
+    id: string;
+    gameId: string;
+    entityId: string;
+    entityType: string;
+    tag: string;
+    color: string | null;
+    notes: string;
+    createdAt: string;
+}
+export interface Note {
+    id: string;
+    gameId: string;
+    title: string;
+    content: string;
+    category: string | null;
+    pinned: boolean;
+    relatedEntityId: string | null;
+    relatedEntityType: string | null;
+    tags: string[];
+    createdAt: string;
+    updatedAt: string;
+}
+export interface ExternalUpdate {
+    id: string;
+    gameId: string;
+    sourceAgent: string;
+    sourceDescription: string | null;
+    updateType: string;
+    category: string | null;
+    title: string;
+    content: string;
+    structuredData: Record<string, unknown> | null;
+    targetEntityId: string | null;
+    targetEntityType: string | null;
+    priority: "low" | "normal" | "high" | "urgent";
+    status: "pending" | "acknowledged" | "applied" | "rejected";
+    createdAt: string;
+    acknowledgedAt: string | null;
+    appliedAt: string | null;
+    dmNotes: string | null;
+}
+export interface PendingUpdatesResult {
+    gameId: string;
+    pendingCount: number;
+    urgentCount: number;
+    updates: ExternalUpdate[];
+    hasUrgent: boolean;
+    suggestion: string;
+}
+export interface PauseState {
+    id: string;
+    gameId: string;
+    currentScene: string;
+    sceneAtmosphere: string | null;
+    immediateSituation: string;
+    pendingPlayerAction: string | null;
+    awaitingResponseTo: string | null;
+    presentedChoices: string[] | null;
+    activeThreads: NarrativeThread[];
+    dmShortTermPlans: string | null;
+    dmLongTermPlans: string | null;
+    upcomingReveals: string[];
+    npcAttitudes: Record<string, string>;
+    activeConversations: ActiveConversation[];
+    recentTone: string | null;
+    playerApparentGoals: string | null;
+    unresolvedHooks: string[];
+    pauseReason: string | null;
+    createdAt: string;
+    modelUsed: string | null;
+}
+export interface NarrativeThread {
+    name: string;
+    description: string;
+    status: "active" | "background" | "climax" | "resolving";
+    urgency: "low" | "medium" | "high" | "critical";
+    involvedCharacterIds?: string[];
+    involvedLocationIds?: string[];
+    relatedQuestId?: string;
+    notes?: string;
+}
+export interface ActiveConversation {
+    npcId: string;
+    topic: string;
+    npcEmotionalState: string;
+    lastNpcStatement?: string;
+    playerIntent?: string;
+}
+export interface PauseChecklist {
+    gameId: string;
+    gameName: string;
+    currentState: {
+        playerLocation: string | null;
+        activeQuests: number;
+        activeCombat: boolean;
+        activeTimers: number;
+        pendingEvents: number;
+        recentEventCount: number;
+    };
+    gameStateAudit: GameStateAudit;
+    persistenceReminders: PersistenceReminder[];
+    checklist: PauseChecklistItem[];
+    existingPauseState: PauseState | null;
+    instructions: string;
+}
+export interface GameStateAudit {
+    characters: {
+        total: number;
+        players: number;
+        npcs: number;
+        withNotes: number;
+        withConditions: number;
+    };
+    locations: {
+        total: number;
+        connected: number;
+    };
+    quests: {
+        active: number;
+        completed: number;
+        failed: number;
+    };
+    items: {
+        total: number;
+        inInventories: number;
+        inLocations: number;
+    };
+    combat: {
+        active: boolean;
+        combatId: string | null;
+        round: number | null;
+        participantCount: number;
+    };
+    resources: {
+        gameLevel: number;
+        characterLevel: number;
+    };
+    timers: {
+        active: number;
+        triggered: number;
+    };
+    scheduledEvents: {
+        pending: number;
+        triggered: number;
+    };
+    relationships: {
+        total: number;
+    };
+    secrets: {
+        total: number;
+        revealed: number;
+        hidden: number;
+    };
+    factions: {
+        active: number;
+        disbanded: number;
+    };
+    abilities: {
+        templates: number;
+        characterOwned: number;
+    };
+    notes: {
+        total: number;
+        pinned: number;
+    };
+    statusEffects: {
+        activeCount: number;
+        affectedCharacters: number;
+    };
+    tags: {
+        uniqueTags: number;
+    };
+    randomTables: {
+        total: number;
+    };
+    narrativeEvents: {
+        total: number;
+        recentHour: number;
+    };
+    images: {
+        total: number;
+    };
+    time: {
+        hasCalendar: boolean;
+        currentTime: string | null;
+    };
+}
+export interface PersistenceReminder {
+    category: "critical" | "important" | "suggested";
+    entityType: string;
+    tool: string;
+    reminder: string;
+    reason: string;
+    entityIds?: string[];
+    entityNames?: string[];
+}
+export interface PauseChecklistItem {
+    category: string;
+    item: string;
+    description: string;
+    required: boolean;
+    example?: string;
+}
+export interface ResumeContext {
+    pauseState: PauseState;
+    gameState: {
+        game: Game;
+        playerCharacter: Character | null;
+        currentLocation: Location | null;
+        activeQuests: Quest[];
+        activeCombat: Combat | null;
+        recentEvents: NarrativeEvent[];
+        activeTimers: Timer[];
+        pendingScheduledEvents: ScheduledEvent[];
+    };
+    narrativeSummary: string;
+    resumePrompt: string;
+    warnings: string[];
+}
+export interface StoredImage {
+    id: string;
+    gameId: string;
+    entityId: string;
+    entityType: string;
+    entityName?: string;
+    filePath: string;
+    fileSize: number;
+    mimeType: string;
+    width: number | null;
+    height: number | null;
+    label: string | null;
+    description: string | null;
+    source: "generated" | "uploaded" | "url";
+    sourceUrl: string | null;
+    generationTool: string | null;
+    generationPrompt: string | null;
+    isPrimary: boolean;
+    createdAt: string;
+}
+export interface StoreImageParams {
+    gameId: string;
+    entityId: string;
+    entityType: string;
+    url: string;
+    label?: string;
+    description?: string;
+    mimeType?: string;
+    generationTool?: string;
+    generationPrompt?: string;
+    setAsPrimary?: boolean;
+}
+export interface ImageListResult {
+    entityId: string;
+    entityType: string;
+    images: StoredImage[];
+    primaryImage: StoredImage | null;
+}
+export interface StoredAudio {
+    id: string;
+    gameId: string;
+    entityId: string;
+    entityType: string;
+    entityName?: string;
+    filePath: string;
+    fileSize: number;
+    mimeType: string;
+    durationMs: number | null;
+    sampleRate: number | null;
+    label: string | null;
+    description: string | null;
+    source: "generated" | "uploaded" | "url";
+    sourceUrl: string | null;
+    ttsEngine: string | null;
+    ttsVoice: string | null;
+    ttsText: string | null;
+    ttsSettings: Record<string, unknown> | null;
+    isVoiceReference: boolean;
+    voiceName: string | null;
+    voiceDescription: string | null;
+    isPrimary: boolean;
+    createdAt: string;
+}
+export interface StoreAudioParams {
+    gameId: string;
+    entityId: string;
+    entityType: string;
+    url?: string;
+    filePath?: string;
+    label?: string;
+    description?: string;
+    mimeType?: string;
+    ttsEngine?: string;
+    ttsVoice?: string;
+    ttsText?: string;
+    ttsSettings?: Record<string, unknown>;
+    isVoiceReference?: boolean;
+    voiceName?: string;
+    voiceDescription?: string;
+    setAsPrimary?: boolean;
+}
+export interface AudioListResult {
+    entityId: string;
+    entityType: string;
+    audioFiles: StoredAudio[];
+    primaryAudio: StoredAudio | null;
+}
+export interface VoiceReferenceResult {
+    gameId: string;
+    characterId: string;
+    characterName: string;
+    voiceReferences: StoredAudio[];
+    /** Full file paths ready to pass to TTS voice cloning tools */
+    filePaths: string[];
+    totalCount: number;
+}