ava-langgraph-narrative-intelligence 0.1.0

package/dist/unified_state_bridge-CIDm1kuf.d.cts

@@ -0,0 +1,266 @@
+/**
+ * Unified Narrative State Bridge
+ *
+ * The shared contract between all six systems in the Narrative Intelligence Stack:
+ * 1. LangGraph Narrative Intelligence Toolkit
+ * 2. ava-langflow Universal Router
+ * 3. ava-Flowise Agent Coordination
+ * 4. LangChain/Langfuse Tracing
+ * 5. Storytelling System
+ * 6. Miadi-46 Event-Driven Platform
+ */
+/**
+ * The three interpretive universes from multiverse_3act
+ */
+declare enum Universe {
+    ENGINEER = "engineer",// Mia - The Builder
+    CEREMONY = "ceremony",// Ava8 - The Keeper
+    STORY_ENGINE = "story_engine"
+}
+/**
+ * Single universe's interpretation of an event
+ */
+interface UniversePerspective {
+    universe: Universe;
+    intent: string;
+    confidence: number;
+    suggestedFlows: string[];
+    context: Record<string, unknown>;
+}
+/**
+ * Create a UniversePerspective
+ */
+declare function createUniversePerspective(universe: Universe, intent: string, confidence: number, options?: Partial<UniversePerspective>): UniversePerspective;
+/**
+ * Complete three-universe analysis of an event
+ */
+interface ThreeUniverseAnalysis {
+    engineer: UniversePerspective;
+    ceremony: UniversePerspective;
+    storyEngine: UniversePerspective;
+    leadUniverse: Universe;
+    coherenceScore: number;
+    timestamp: string;
+}
+/**
+ * Create a ThreeUniverseAnalysis
+ */
+declare function createThreeUniverseAnalysis(engineer: UniversePerspective, ceremony: UniversePerspective, storyEngine: UniversePerspective, leadUniverse: Universe, coherenceScore: number): ThreeUniverseAnalysis;
+/**
+ * Get perspective for a specific universe
+ */
+declare function getPerspective(analysis: ThreeUniverseAnalysis, universe: Universe): UniversePerspective;
+/**
+ * Phases in the three-act structure
+ */
+declare enum NarrativePhase {
+    SETUP = "setup",// Act 1
+    CONFRONTATION = "confrontation",// Act 2
+    RESOLUTION = "resolution"
+}
+/**
+ * Narrative functions for story beats
+ */
+declare enum NarrativeFunction {
+    INCITING_INCIDENT = "inciting_incident",
+    RISING_ACTION = "rising_action",
+    TURNING_POINT = "turning_point",
+    COMPLICATION = "complication",
+    CRISIS = "crisis",
+    CLIMAX = "climax",
+    RESOLUTION = "resolution",
+    DENOUEMENT = "denouement",
+    BEAT = "beat"
+}
+/**
+ * Current position in the narrative journey
+ */
+interface NarrativePosition {
+    act: number;
+    phase: NarrativePhase;
+    currentBeatId?: string;
+    beatCount: number;
+    characterArcStrength: number;
+    thematicResonance: number;
+    emotionalTone: string;
+    leadUniverse: Universe;
+}
+/**
+ * Create a NarrativePosition with defaults
+ */
+declare function createNarrativePosition(options?: Partial<NarrativePosition>): NarrativePosition;
+/**
+ * A single story beat with three-universe perspectives
+ */
+interface StoryBeat {
+    id: string;
+    sequence: number;
+    content: string;
+    narrativeFunction: NarrativeFunction;
+    act: number;
+    universeAnalysis?: ThreeUniverseAnalysis;
+    leadUniverse: Universe;
+    emotionalTone: string;
+    thematicTags: string[];
+    characterId?: string;
+    characterArcImpact: number;
+    source: string;
+    sourceEventId?: string;
+    timestamp: string;
+    enrichmentsApplied: string[];
+    qualityScore: number;
+}
+/**
+ * Create a StoryBeat with defaults
+ */
+declare function createStoryBeat(id: string, sequence: number, content: string, narrativeFunction: NarrativeFunction, act: number, options?: Partial<StoryBeat>): StoryBeat;
+/**
+ * Character state tracking for arc continuity
+ */
+interface CharacterState {
+    id: string;
+    name: string;
+    archetype: string;
+    universe: Universe;
+    arcPosition: number;
+    initialState: string;
+    currentState: string;
+    growthPoints: Array<{
+        timestamp: string;
+        impact: number;
+        description: string;
+    }>;
+    relationships: string[];
+}
+/**
+ * Create a CharacterState with defaults
+ */
+declare function createCharacterState(id: string, name: string, archetype: string, universe: Universe, options?: Partial<CharacterState>): CharacterState;
+/**
+ * A thematic thread being tracked across the narrative
+ */
+interface ThematicThread {
+    id: string;
+    name: string;
+    description: string;
+    strength: number;
+    tensionLevel: number;
+    resolutionProgress: number;
+    beatIds: string[];
+}
+/**
+ * Create a ThematicThread with defaults
+ */
+declare function createThematicThread(id: string, name: string, description: string, options?: Partial<ThematicThread>): ThematicThread;
+/**
+ * Record of a routing decision for tracing
+ */
+interface RoutingDecision {
+    id: string;
+    backend: string;
+    flow: string;
+    universeAnalysis: ThreeUniverseAnalysis;
+    narrativePosition: NarrativePosition;
+    score: number;
+    method: string;
+    success: boolean;
+    resultSummary: string;
+    latencyMs: number;
+    timestamp: string;
+}
+/**
+ * Create a RoutingDecision
+ */
+declare function createRoutingDecision(id: string, backend: string, flow: string, universeAnalysis: ThreeUniverseAnalysis, narrativePosition: NarrativePosition, score: number, options?: Partial<RoutingDecision>): RoutingDecision;
+/**
+ * The complete unified state shared across all systems.
+ * This is THE contract that all six systems use to communicate.
+ */
+interface UnifiedNarrativeState {
+    storyId: string;
+    sessionId: string;
+    position: NarrativePosition;
+    beats: StoryBeat[];
+    characters: Record<string, CharacterState>;
+    themes: Record<string, ThematicThread>;
+    routingDecisions: RoutingDecision[];
+    currentEpisodeId?: string;
+    episodeBeatsCount: number;
+    createdAt: string;
+    updatedAt: string;
+    overallCoherence: number;
+    emotionalArcStrength: number;
+}
+/**
+ * Create a new UnifiedNarrativeState
+ */
+declare function createUnifiedNarrativeState(storyId: string, sessionId: string, options?: {
+    includeDefaultCharacters?: boolean;
+    includeDefaultThemes?: boolean;
+}): UnifiedNarrativeState;
+/**
+ * Add a beat to the state
+ */
+declare function addBeat(state: UnifiedNarrativeState, beat: StoryBeat): void;
+/**
+ * Add a routing decision to the state
+ */
+declare function addRoutingDecision(state: UnifiedNarrativeState, decision: RoutingDecision): void;
+/**
+ * Update character arc position
+ */
+declare function updateCharacterArc(state: UnifiedNarrativeState, characterId: string, impact: number, description: string): void;
+/**
+ * Update theme strength
+ */
+declare function updateThemeStrength(state: UnifiedNarrativeState, themeId: string, strengthDelta: number): void;
+/**
+ * Get the last n beats for context
+ */
+declare function getLastNBeats(state: UnifiedNarrativeState, n?: number): StoryBeat[];
+/**
+ * Calculate overall narrative coherence
+ */
+declare function calculateCoherence(state: UnifiedNarrativeState): number;
+/**
+ * Check if we should create a new episode
+ */
+declare function shouldCreateNewEpisode(state: UnifiedNarrativeState): boolean;
+/**
+ * Start a new episode
+ */
+declare function startNewEpisode(state: UnifiedNarrativeState, episodeId: string): void;
+/**
+ * Get the three main archetypes from multiverse_3act
+ */
+declare function getDefaultCharacters(): Record<string, CharacterState>;
+/**
+ * Get default thematic threads from multiverse_3act
+ */
+declare function getDefaultThemes(): Record<string, ThematicThread>;
+/**
+ * Create a story beat from a webhook event
+ */
+declare function createBeatFromWebhook(eventId: string, content: string, universeAnalysis: ThreeUniverseAnalysis, sequence: number): StoryBeat;
+/**
+ * Standard Redis key patterns for state storage
+ */
+declare const RedisKeys: {
+    state: (sessionId: string) => string;
+    currentState: () => string;
+    beats: (sessionId: string) => string;
+    beat: (beatId: string) => string;
+    eventAnalysis: (eventId: string) => string;
+    routingHistory: (sessionId: string) => string;
+    episode: (episodeId: string) => string;
+};
+/**
+ * Serialize state to JSON
+ */
+declare function serializeState(state: UnifiedNarrativeState): string;
+/**
+ * Deserialize state from JSON
+ */
+declare function deserializeState(json: string): UnifiedNarrativeState;
+
+export { updateCharacterArc as A, updateThemeStrength as B, type CharacterState as C, NarrativeFunction as N, RedisKeys as R, type StoryBeat as S, type ThematicThread as T, type UnifiedNarrativeState as U, NarrativePhase as a, type NarrativePosition as b, type RoutingDecision as c, type ThreeUniverseAnalysis as d, Universe as e, type UniversePerspective as f, addBeat as g, addRoutingDecision as h, calculateCoherence as i, createBeatFromWebhook as j, createCharacterState as k, createNarrativePosition as l, createRoutingDecision as m, createStoryBeat as n, createThematicThread as o, createThreeUniverseAnalysis as p, createUnifiedNarrativeState as q, createUniversePerspective as r, deserializeState as s, getDefaultCharacters as t, getDefaultThemes as u, getLastNBeats as v, getPerspective as w, serializeState as x, shouldCreateNewEpisode as y, startNewEpisode as z };

package/dist/unified_state_bridge-CIDm1kuf.d.ts

@@ -0,0 +1,266 @@
+/**
+ * Unified Narrative State Bridge
+ *
+ * The shared contract between all six systems in the Narrative Intelligence Stack:
+ * 1. LangGraph Narrative Intelligence Toolkit
+ * 2. ava-langflow Universal Router
+ * 3. ava-Flowise Agent Coordination
+ * 4. LangChain/Langfuse Tracing
+ * 5. Storytelling System
+ * 6. Miadi-46 Event-Driven Platform
+ */
+/**
+ * The three interpretive universes from multiverse_3act
+ */
+declare enum Universe {
+    ENGINEER = "engineer",// Mia - The Builder
+    CEREMONY = "ceremony",// Ava8 - The Keeper
+    STORY_ENGINE = "story_engine"
+}
+/**
+ * Single universe's interpretation of an event
+ */
+interface UniversePerspective {
+    universe: Universe;
+    intent: string;
+    confidence: number;
+    suggestedFlows: string[];
+    context: Record<string, unknown>;
+}
+/**
+ * Create a UniversePerspective
+ */
+declare function createUniversePerspective(universe: Universe, intent: string, confidence: number, options?: Partial<UniversePerspective>): UniversePerspective;
+/**
+ * Complete three-universe analysis of an event
+ */
+interface ThreeUniverseAnalysis {
+    engineer: UniversePerspective;
+    ceremony: UniversePerspective;
+    storyEngine: UniversePerspective;
+    leadUniverse: Universe;
+    coherenceScore: number;
+    timestamp: string;
+}
+/**
+ * Create a ThreeUniverseAnalysis
+ */
+declare function createThreeUniverseAnalysis(engineer: UniversePerspective, ceremony: UniversePerspective, storyEngine: UniversePerspective, leadUniverse: Universe, coherenceScore: number): ThreeUniverseAnalysis;
+/**
+ * Get perspective for a specific universe
+ */
+declare function getPerspective(analysis: ThreeUniverseAnalysis, universe: Universe): UniversePerspective;
+/**
+ * Phases in the three-act structure
+ */
+declare enum NarrativePhase {
+    SETUP = "setup",// Act 1
+    CONFRONTATION = "confrontation",// Act 2
+    RESOLUTION = "resolution"
+}
+/**
+ * Narrative functions for story beats
+ */
+declare enum NarrativeFunction {
+    INCITING_INCIDENT = "inciting_incident",
+    RISING_ACTION = "rising_action",
+    TURNING_POINT = "turning_point",
+    COMPLICATION = "complication",
+    CRISIS = "crisis",
+    CLIMAX = "climax",
+    RESOLUTION = "resolution",
+    DENOUEMENT = "denouement",
+    BEAT = "beat"
+}
+/**
+ * Current position in the narrative journey
+ */
+interface NarrativePosition {
+    act: number;
+    phase: NarrativePhase;
+    currentBeatId?: string;
+    beatCount: number;
+    characterArcStrength: number;
+    thematicResonance: number;
+    emotionalTone: string;
+    leadUniverse: Universe;
+}
+/**
+ * Create a NarrativePosition with defaults
+ */
+declare function createNarrativePosition(options?: Partial<NarrativePosition>): NarrativePosition;
+/**
+ * A single story beat with three-universe perspectives
+ */
+interface StoryBeat {
+    id: string;
+    sequence: number;
+    content: string;
+    narrativeFunction: NarrativeFunction;
+    act: number;
+    universeAnalysis?: ThreeUniverseAnalysis;
+    leadUniverse: Universe;
+    emotionalTone: string;
+    thematicTags: string[];
+    characterId?: string;
+    characterArcImpact: number;
+    source: string;
+    sourceEventId?: string;
+    timestamp: string;
+    enrichmentsApplied: string[];
+    qualityScore: number;
+}
+/**
+ * Create a StoryBeat with defaults
+ */
+declare function createStoryBeat(id: string, sequence: number, content: string, narrativeFunction: NarrativeFunction, act: number, options?: Partial<StoryBeat>): StoryBeat;
+/**
+ * Character state tracking for arc continuity
+ */
+interface CharacterState {
+    id: string;
+    name: string;
+    archetype: string;
+    universe: Universe;
+    arcPosition: number;
+    initialState: string;
+    currentState: string;
+    growthPoints: Array<{
+        timestamp: string;
+        impact: number;
+        description: string;
+    }>;
+    relationships: string[];
+}
+/**
+ * Create a CharacterState with defaults
+ */
+declare function createCharacterState(id: string, name: string, archetype: string, universe: Universe, options?: Partial<CharacterState>): CharacterState;
+/**
+ * A thematic thread being tracked across the narrative
+ */
+interface ThematicThread {
+    id: string;
+    name: string;
+    description: string;
+    strength: number;
+    tensionLevel: number;
+    resolutionProgress: number;
+    beatIds: string[];
+}
+/**
+ * Create a ThematicThread with defaults
+ */
+declare function createThematicThread(id: string, name: string, description: string, options?: Partial<ThematicThread>): ThematicThread;
+/**
+ * Record of a routing decision for tracing
+ */
+interface RoutingDecision {
+    id: string;
+    backend: string;
+    flow: string;
+    universeAnalysis: ThreeUniverseAnalysis;
+    narrativePosition: NarrativePosition;
+    score: number;
+    method: string;
+    success: boolean;
+    resultSummary: string;
+    latencyMs: number;
+    timestamp: string;
+}
+/**
+ * Create a RoutingDecision
+ */
+declare function createRoutingDecision(id: string, backend: string, flow: string, universeAnalysis: ThreeUniverseAnalysis, narrativePosition: NarrativePosition, score: number, options?: Partial<RoutingDecision>): RoutingDecision;
+/**
+ * The complete unified state shared across all systems.
+ * This is THE contract that all six systems use to communicate.
+ */
+interface UnifiedNarrativeState {
+    storyId: string;
+    sessionId: string;
+    position: NarrativePosition;
+    beats: StoryBeat[];
+    characters: Record<string, CharacterState>;
+    themes: Record<string, ThematicThread>;
+    routingDecisions: RoutingDecision[];
+    currentEpisodeId?: string;
+    episodeBeatsCount: number;
+    createdAt: string;
+    updatedAt: string;
+    overallCoherence: number;
+    emotionalArcStrength: number;
+}
+/**
+ * Create a new UnifiedNarrativeState
+ */
+declare function createUnifiedNarrativeState(storyId: string, sessionId: string, options?: {
+    includeDefaultCharacters?: boolean;
+    includeDefaultThemes?: boolean;
+}): UnifiedNarrativeState;
+/**
+ * Add a beat to the state
+ */
+declare function addBeat(state: UnifiedNarrativeState, beat: StoryBeat): void;
+/**
+ * Add a routing decision to the state
+ */
+declare function addRoutingDecision(state: UnifiedNarrativeState, decision: RoutingDecision): void;
+/**
+ * Update character arc position
+ */
+declare function updateCharacterArc(state: UnifiedNarrativeState, characterId: string, impact: number, description: string): void;
+/**
+ * Update theme strength
+ */
+declare function updateThemeStrength(state: UnifiedNarrativeState, themeId: string, strengthDelta: number): void;
+/**
+ * Get the last n beats for context
+ */
+declare function getLastNBeats(state: UnifiedNarrativeState, n?: number): StoryBeat[];
+/**
+ * Calculate overall narrative coherence
+ */
+declare function calculateCoherence(state: UnifiedNarrativeState): number;
+/**
+ * Check if we should create a new episode
+ */
+declare function shouldCreateNewEpisode(state: UnifiedNarrativeState): boolean;
+/**
+ * Start a new episode
+ */
+declare function startNewEpisode(state: UnifiedNarrativeState, episodeId: string): void;
+/**
+ * Get the three main archetypes from multiverse_3act
+ */
+declare function getDefaultCharacters(): Record<string, CharacterState>;
+/**
+ * Get default thematic threads from multiverse_3act
+ */
+declare function getDefaultThemes(): Record<string, ThematicThread>;
+/**
+ * Create a story beat from a webhook event
+ */
+declare function createBeatFromWebhook(eventId: string, content: string, universeAnalysis: ThreeUniverseAnalysis, sequence: number): StoryBeat;
+/**
+ * Standard Redis key patterns for state storage
+ */
+declare const RedisKeys: {
+    state: (sessionId: string) => string;
+    currentState: () => string;
+    beats: (sessionId: string) => string;
+    beat: (beatId: string) => string;
+    eventAnalysis: (eventId: string) => string;
+    routingHistory: (sessionId: string) => string;
+    episode: (episodeId: string) => string;
+};
+/**
+ * Serialize state to JSON
+ */
+declare function serializeState(state: UnifiedNarrativeState): string;
+/**
+ * Deserialize state from JSON
+ */
+declare function deserializeState(json: string): UnifiedNarrativeState;
+
+export { updateCharacterArc as A, updateThemeStrength as B, type CharacterState as C, NarrativeFunction as N, RedisKeys as R, type StoryBeat as S, type ThematicThread as T, type UnifiedNarrativeState as U, NarrativePhase as a, type NarrativePosition as b, type RoutingDecision as c, type ThreeUniverseAnalysis as d, Universe as e, type UniversePerspective as f, addBeat as g, addRoutingDecision as h, calculateCoherence as i, createBeatFromWebhook as j, createCharacterState as k, createNarrativePosition as l, createRoutingDecision as m, createStoryBeat as n, createThematicThread as o, createThreeUniverseAnalysis as p, createUnifiedNarrativeState as q, createUniversePerspective as r, deserializeState as s, getDefaultCharacters as t, getDefaultThemes as u, getLastNBeats as v, getPerspective as w, serializeState as x, shouldCreateNewEpisode as y, startNewEpisode as z };

package/package.json

@@ -0,0 +1,91 @@
+{
+  "name": "ava-langgraph-narrative-intelligence",
+  "version": "0.1.0",
+  "description": "Narrative Intelligence Toolkit for LangGraph.js - Three-universe processing and NCP analysis",
+  "type": "module",
+  "engines": {
+    "node": ">=18"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    },
+    "./schemas": {
+      "types": "./dist/schemas/index.d.ts",
+      "import": "./dist/schemas/index.js",
+      "require": "./dist/schemas/index.cjs"
+    },
+    "./graphs": {
+      "types": "./dist/graphs/index.d.ts",
+      "import": "./dist/graphs/index.js",
+      "require": "./dist/graphs/index.cjs"
+    },
+    "./nodes": {
+      "types": "./dist/nodes/index.d.ts",
+      "import": "./dist/nodes/index.js",
+      "require": "./dist/nodes/index.cjs"
+    },
+    "./integrations": {
+      "types": "./dist/integrations/index.d.ts",
+      "import": "./dist/integrations/index.js",
+      "require": "./dist/integrations/index.cjs"
+    }
+  },
+  "files": [
+    "dist",
+    "src"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "lint": "eslint src",
+    "lint:fix": "eslint src --fix",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "clean": "rm -rf dist"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/avadisabelle/ava-langgraphjs.git",
+    "directory": "libs/narrative-intelligence"
+  },
+  "keywords": [
+    "langgraph",
+    "narrative",
+    "intelligence",
+    "three-universe",
+    "ncp",
+    "storytelling"
+  ],
+  "author": "ava",
+  "license": "MIT",
+  "dependencies": {
+    "uuid": "^9.0.0"
+  },
+  "peerDependencies": {
+    "@langchain/langgraph": ">=0.2.0",
+    "ioredis": ">=5.0.0"
+  },
+  "peerDependenciesMeta": {
+    "@langchain/langgraph": {
+      "optional": true
+    },
+    "ioredis": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@langchain/langgraph": "^0.2.0",
+    "@types/node": "^20.0.0",
+    "@types/uuid": "^9.0.0",
+    "eslint": "^8.0.0",
+    "ioredis": "^5.0.0",
+    "tsup": "^8.0.0",
+    "typescript": "^5.0.0",
+    "vitest": "^1.0.0"
+  }
+}