Package Exports

coaia-narrative
coaia-narrative/dist/index.js

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (coaia-narrative) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

coaia-narrative

Creative Orientation AI Agentic Memories - Extended with Narrative Beat Support

A complete MCP server extending structural tension charts with multi-universe narrative beat capture for comprehensive incident documentation and creative-oriented memory management.

Installation

npm install coaia-narrative

Usage

# Run with default memory file
npx coaia-narrative

# Run with custom memory path
npx coaia-narrative --memory-path ./my-charts.jsonl

# In Claude Desktop (claude_desktop_config.json)
{
  "mcpServers": {
    "coaia-narrative": {
      "command": "npx",
      "args": ["-y", "coaia-narrative", "--memory-path", "./narrative-memory.jsonl"],
      "env": {
        "COAIA_TOOLS": "STC_TOOLS,NARRATIVE_TOOLS"
      }
    }
  }
}

Core Features

Structural Tension Charts (Proven Foundation)

list_active_charts - View all charts and progress
create_structural_tension_chart - Create new chart with desired outcome + current reality + action steps
add_action_step - Add strategic actions (creates telescoped sub-charts)
telescope_action_step - Break down actions into detailed sub-charts
mark_action_complete - Complete actions and update current reality

Narrative Beat Support (Extended Capability)

Documents complex incidents across three archetypal universes:

Engineer-world: Technical/analytical perspective
Ceremony-world: Relational/spiritual protocol awareness
Story-engine-world: Narrative/creative progression

Creative Orientation Principles

✅ Focus on Creation - "What do you want to create?" not "What needs fixing?" ✅ Structural Tension - Honest current reality + clear desired outcome creates natural momentum ✅ Advancing Patterns - Success builds momentum; completed actions flow into reality ✅ Multi-Universe Awareness - Technical + relational + narrative perspectives simultaneously

Tool Configuration

# Default: Both STCs and narrative tools
COAIA_TOOLS="STC_TOOLS,NARRATIVE_TOOLS" npx coaia-narrative

# Structural tension charts only
COAIA_TOOLS="STC_TOOLS" npx coaia-narrative

# Minimal core tools
COAIA_TOOLS="CORE_TOOLS" npx coaia-narrative

Memory Format

Memory stored as JSONL with:

Entity records - Structural tension charts, current reality, desired outcomes, action steps
Relation records - Links between entities showing chart hierarchy and advancement
Narrative records - Extended narrative beat entities with multi-universe perspective

All records are backward compatible JSONL format.

Status

✅ Production Ready - MCP server fully functional and tested

Builds with npm run build and launches successfully with all tools available.

License

MIT