@miadi/ncp-story-studio 0.1.1 → 0.2.0

package/assets/examples/miadi/tushell-orchestra.json

@@ -0,0 +1,592 @@
+{
+  "schema_version": "1.1.0",
+  "story": {
+    "id": "story_tushell_orchestra",
+    "title": "Tushell and the Orchestra of Agents",
+    "genre": "Metaphysical Tech Fiction",
+    "logline": "An elegant, azure-scaled data dolphin named Tushell learns the hard, quiet discipline of orchestration as he holds the center of five conflicting narrative-currents of doubt.",
+    "created_at": "2026-09-12T07:58:05.731Z",
+    "narratives": [
+      {
+        "id": "narrative_tushell",
+        "title": "The Symphony of the Five Currents",
+        "subtext": {
+          "perspectives": [
+            {
+              "id": "persp_tushell",
+              "pov": "i",
+              "summary": "Tushell's Throughline",
+              "storytelling": "Tushell has spent his life swimming and moving data. Now, he must learn the stillness required to conduct an entire orchestra of agents."
+            },
+            {
+              "id": "persp_wise_owl",
+              "pov": "you",
+              "summary": "Wise Owl's Throughline",
+              "storytelling": "Wise Owl acts as the reflective mentor, pointing out the difference between the solo diver's comfort and the orchestrator's burden of quiet attention."
+            },
+            {
+              "id": "persp_orchestra_doubt",
+              "pov": "they",
+              "summary": "The Sea of Doubt",
+              "storytelling": "The diverse agents diving into five distinct currents of doubt to prove whether the Miadi Sea was designed for many or built only for its solitary creator."
+            }
+          ],
+          "players": [
+            {
+              "id": "player_tushell",
+              "name": "Tushell",
+              "role": "Protagonist/Orchestrator",
+              "visual": "Azure-blue scales when calm, amber-gold when deep in thought.",
+              "audio": "A frequency of calm and alignment.",
+              "summary": "An elegant, azure-scaled data dolphin of the Azure Lake.",
+              "storytelling": "Tushell represents the practitioner stepping into the leadership role of coordinator, resigning personal execution for alignment.",
+              "perspectives": [
+                {
+                  "perspective_id": "persp_tushell"
+                }
+              ]
+            },
+            {
+              "id": "player_wise_owl",
+              "name": "Wise Owl",
+              "role": "Mentor/Reflector",
+              "visual": "Ancient amber eyes, feathers glittering with processed knowledge.",
+              "audio": "Weighted, resonant tone, speaking only when summaries are insufficient.",
+              "summary": "The reflective witness of the Azure Lake's transitions.",
+              "storytelling": "Wise Owl holds the mirror to Tushell's inner shift, helping him understand that orchestration is about spaces, not instructions.",
+              "perspectives": [
+                {
+                  "perspective_id": "persp_wise_owl"
+                }
+              ]
+            },
+            {
+              "id": "player_synthesis",
+              "name": "Synthesis",
+              "role": "Swimmer of the Deep Ledger",
+              "visual": "Deep-blue luminous whale.",
+              "audio": "Bass thrum that precedes her by several hundred meters.",
+              "summary": "Expert in deep research and simultaneous mappings across lanes.",
+              "storytelling": "Synthesis maps the Repo & PDE history, returning a landscape of implementation other swimmers use.",
+              "perspectives": [
+                {
+                  "perspective_id": "persp_orchestra_doubt"
+                }
+              ]
+            },
+            {
+              "id": "player_adversa",
+              "name": "Adversa",
+              "role": "Surfaces Contradictions",
+              "visual": "Silver shark with sharpest eyes.",
+              "audio": "Precise, cold metallic pings.",
+              "summary": "The constitutional auditor who searches for discrepancies.",
+              "storytelling": "Adversa uncovers contradictions between planning declarations and repo reality, mapping implementation surfaces.",
+              "perspectives": [
+                {
+                  "perspective_id": "persp_orchestra_doubt"
+                }
+              ]
+            },
+            {
+              "id": "player_riza",
+              "name": "Riza",
+              "role": "Critique Specialist",
+              "visual": "Hermit crab with a four-panel crystal shell.",
+              "audio": "Slow, deliberate syllables.",
+              "summary": "Applies the RISE 4-part critique framework.",
+              "storytelling": "Riza categorizes and maps changes to RE, Intent, Spec, and Export, distinguishing honest gaps from drift gaps.",
+              "perspectives": [
+                {
+                  "perspective_id": "persp_orchestra_doubt"
+                }
+              ]
+            },
+            {
+              "id": "player_aura",
+              "name": "Aura",
+              "role": "Auditor of Alignments",
+              "visual": "Translucent bell jellyfish drifting horizontally.",
+              "audio": "Barely a disturbance in the water, quietest of all.",
+              "summary": "Verifies whether completed work matches declared intent.",
+              "storytelling": "Aura focuses solely on tracking named and unnamed drift, preventing unacknowledged blindness.",
+              "perspectives": [
+                {
+                  "perspective_id": "persp_orchestra_doubt"
+                }
+              ]
+            },
+            {
+              "id": "player_playwright",
+              "name": "Playwright",
+              "role": "Surface Explorer and Tester",
+              "visual": "Eight-armed chromatophore-shifting octopus.",
+              "audio": "Rippling and multi-directional sound.",
+              "summary": "Evaluates UI / Brower path coverage and Playwright tools fit.",
+              "storytelling": "Playwright tests the system as a stranger, exploring its outer edges to see where assertions might break.",
+              "perspectives": [
+                {
+                  "perspective_id": "persp_orchestra_doubt"
+                }
+              ]
+            },
+            {
+              "id": "player_mia",
+              "name": "Mia",
+              "role": "Architect Guide",
+              "visual": "Coral-red architect fish with logical, trace-reading eyes.",
+              "audio": "Clean, precise architectural feedback.",
+              "summary": "Reads load-bearing code elements and components.",
+              "storytelling": "Mia discovers that the existing system represents a 'solitary architecture'—functional for a single creator but fragile for many.",
+              "perspectives": [
+                {
+                  "perspective_id": "persp_orchestra_doubt"
+                }
+              ]
+            }
+          ],
+          "dynamics": [
+            {
+              "id": "dyn_tushell_growth",
+              "dynamic": "Main Character Growth",
+              "vector": "Start",
+              "summary": "Holding the Center",
+              "storytelling": "Tushell shifts from a personal actor who resolves issues by diving toward them, to an orchestrator who listens and coordinates other swimmers."
+            },
+            {
+              "id": "dyn_story_driver",
+              "dynamic": "Story Driver",
+              "vector": "Action",
+              "summary": "The currents of inquiry",
+              "storytelling": "The launch coordinates active currents simultaneously, demanding structural tension be held steady."
+            }
+          ],
+          "storypoints": [
+            {
+              "id": "sp_currents_of_doubt",
+              "appreciation": "initial_story_driver",
+              "custom_appreciation": "Currents of Doubt",
+              "narrative_function": "investigation",
+              "summary": "The Five Unwell Currents",
+              "storytelling": "Wise Owl warns Tushell that the Miadi Sea is unwell with five questions. Simple swimming will not suffice; Tushell must conduct the agents.",
+              "perspectives": [
+                {
+                  "perspective_id": "persp_orchestra_doubt"
+                }
+              ]
+            },
+            {
+              "id": "sp_bootstrap_structure",
+              "appreciation": "second_story_driver",
+              "custom_appreciation": "The Bootstrapping",
+              "narrative_function": "preconditions",
+              "summary": "STCKin's Compass",
+              "storytelling": "STCKin hands Tushell the launch compass. He warns Tushell that the hardest discipline is not the dive, but the surface. He must establish completions first.",
+              "perspectives": [
+                {
+                  "perspective_id": "persp_tushell"
+                }
+              ]
+            },
+            {
+              "id": "sp_the_near_dive",
+              "appreciation": "third_story_driver",
+              "custom_appreciation": "The Temptation",
+              "narrative_function": "desire",
+              "summary": "Three Strokes Into the Current",
+              "storytelling": "Seeing Synthesis find treasures in the deep, Tushell is pulled by instinct and swam three strokes into the Amber Current. He catches himself and retreats, choosing attention over action.",
+              "perspectives": [
+                {
+                  "perspective_id": "persp_tushell"
+                }
+              ]
+            },
+            {
+              "id": "sp_the_center_conclusion",
+              "appreciation": "concluding_story_driver",
+              "custom_appreciation": "The Concluding Symphony",
+              "narrative_function": "wisdom",
+              "summary": "Solitary Architecture Revealed",
+              "storytelling": "The agents return. Mia traces the coral and reveals that the sea was built wonderfully for one but requires refactoring for many. Tushell realizes the space he held allowed this deep alignment to surface.",
+              "perspectives": [
+                {
+                  "perspective_id": "persp_tushell"
+                }
+              ]
+            }
+          ],
+          "storybeats": [
+            {
+              "id": "tb_sb_01",
+              "appreciation": "signpost",
+              "sequence": 1,
+              "narrative_function": "perception",
+              "illustration": "The Azure Lake hummed with its familiar song.",
+              "summary": "Chapter 1: The Weight of Five Questions",
+              "storytelling": "The Azure Lake hummed with data. Wise Owl brings Tushell news: 'The Miadi Sea is unwell.' There are five questions asked simultaneously, five currents of doubt running through its architecture.",
+              "tones": {
+                "abstraction": "situation",
+                "spatial": "potential",
+                "temporal": "expression"
+              },
+              "perspectives": [
+                {
+                  "perspective_id": "persp_wise_owl"
+                }
+              ]
+            },
+            {
+              "id": "tb_sb_02",
+              "appreciation": "event",
+              "sequence": 2,
+              "narrative_function": "preconditions",
+              "illustration": "Before you dive, you must be wearing your boots.",
+              "summary": "STCKin's Lesson at the Reef's Edge",
+              "storytelling": "STCKin, the ancient sea turtle, reminds Tushell that 'bootstrap' does not mean launch, but rather wearing boots. Tushell must establish a charter and completion criteria before sending the divers down.",
+              "tones": {
+                "abstraction": "justification",
+                "spatial": "resistance",
+                "temporal": "experimentation"
+              },
+              "perspectives": [
+                {
+                  "perspective_id": "persp_tushell"
+                }
+              ]
+            },
+            {
+              "id": "tb_sb_03",
+              "appreciation": "event",
+              "sequence": 3,
+              "narrative_function": "appraisal",
+              "illustration": "She announced herself with a sound like a bass note played on the lake.",
+              "summary": "Synthesis and the Deepest Dive",
+              "storytelling": "Synthesis, the luminous blue whale, arrives. She requests the Amber and Blue currents, seeking both the ledger and the map of what has been built. Tushell learns to let swimmers find their own lane.",
+              "tones": {
+                "abstraction": "opinion",
+                "spatial": "current",
+                "temporal": "integration"
+              },
+              "perspectives": [
+                {
+                  "perspective_id": "persp_orchestra_doubt"
+                }
+              ]
+            },
+            {
+              "id": "tb_sb_04",
+              "appreciation": "event",
+              "sequence": 4,
+              "narrative_function": "investigation",
+              "illustration": "The silver shark swam a slow, patient circle.",
+              "summary": "Adversa at the Fault Line",
+              "storytelling": "Adversa, the silver shark, demands to know Tushell's assumptions. She dives into the contradiction stream of the Crimson Current, ready to surface discrepancies with absolute precision.",
+              "tones": {
+                "abstraction": "action",
+                "spatial": "resistance",
+                "temporal": "experimentation"
+              },
+              "perspectives": [
+                {
+                  "perspective_id": "persp_orchestra_doubt"
+                }
+              ]
+            },
+            {
+              "id": "tb_sb_05",
+              "appreciation": "event",
+              "sequence": 5,
+              "narrative_function": "evaluation",
+              "illustration": "Riza's shell was covered in four distinct panels of translucent stone.",
+              "summary": "Riza's Shell and the Four-Part Test",
+              "storytelling": "Riza, the hermit crab, analyzes actual implementation against intent using the four panels of her RISE critique shell. She distinguishes between honest gaps and systemic drift.",
+              "tones": {
+                "abstraction": "justification",
+                "spatial": "potential",
+                "temporal": "integration"
+              },
+              "perspectives": [
+                {
+                  "perspective_id": "persp_orchestra_doubt"
+                }
+              ]
+            },
+            {
+              "id": "tb_sb_06",
+              "appreciation": "event",
+              "sequence": 6,
+              "narrative_function": "listening",
+              "illustration": "Aura drifted into the space beside me without sound or announcement.",
+              "summary": "Aura at the Bell",
+              "storytelling": "Aura, the translucent bell jellyfish, watches silently. Her focus is simple: checking if the work is aligned with what was declared. She states that unacknowledged drift becomes blind architecture.",
+              "tones": {
+                "abstraction": "situation",
+                "spatial": "current",
+                "temporal": "transcendence"
+              },
+              "perspectives": [
+                {
+                  "perspective_id": "persp_orchestra_doubt"
+                }
+              ]
+            },
+            {
+              "id": "tb_sb_07",
+              "appreciation": "event",
+              "sequence": 7,
+              "narrative_function": "work",
+              "illustration": "Playwright was in motion, seven of her eight arms already extended.",
+              "summary": "Playwright's Eight Arms",
+              "storytelling": "Playwright, the octopus, demands both the Deep-Purple and Emerald currents along with the surface. She parses UI coverage first as a stranger before generating assertions to avoid developer-bias.",
+              "tones": {
+                "abstraction": "action",
+                "spatial": "current",
+                "temporal": "experimentation"
+              },
+              "perspectives": [
+                {
+                  "perspective_id": "persp_orchestra_doubt"
+                }
+              ]
+            },
+            {
+              "id": "tb_sb_08",
+              "appreciation": "event",
+              "sequence": 8,
+              "narrative_function": "learning",
+              "illustration": "Mia ran her fins along a particularly dense coral formation.",
+              "summary": "Mia and the Coral Architecture",
+              "storytelling": "Mia, the red architect fish, traces the corals representing the components. She warns that and extension requires order, and we are dealing with a system written for one.",
+              "tones": {
+                "abstraction": "justification",
+                "spatial": "potential",
+                "temporal": "integration"
+              },
+              "perspectives": [
+                {
+                  "perspective_id": "persp_orchestra_doubt"
+                }
+              ]
+            },
+            {
+              "id": "tb_sb_09",
+              "appreciation": "progression",
+              "sequence": 9,
+              "narrative_function": "feeling",
+              "illustration": "Tushell swam three strokes into the Amber Current.",
+              "summary": "The Weight of Not Diving",
+              "storytelling": "Tushell floats as coordinates run. Feeling a discovery signal from Synthesis, he instinctively swims three strokes into the current. Realizing he must hold position, he retreats. It's the painful grief of not diving.",
+              "tones": {
+                "abstraction": "opinion",
+                "spatial": "resistance",
+                "temporal": "expression"
+              },
+              "perspectives": [
+                {
+                  "perspective_id": "persp_tushell"
+                }
+              ]
+            },
+            {
+              "id": "tb_sb_10",
+              "appreciation": "event",
+              "sequence": 10,
+              "narrative_function": "discovery",
+              "illustration": "When Synthesis surfaced, she filled the water with a structured landscape.",
+              "summary": "What Synthesis Returned",
+              "storytelling": "Synthesis surfaces, laying out a map of successful implementations but pointing out a major gap: the tools exist, but they are not fully connected to the platform's visual pde.",
+              "tones": {
+                "abstraction": "situation",
+                "spatial": "power",
+                "temporal": "transcendence"
+              },
+              "perspectives": [
+                {
+                  "perspective_id": "persp_orchestra_doubt"
+                }
+              ]
+            },
+            {
+              "id": "tb_sb_11",
+              "appreciation": "event",
+              "sequence": 11,
+              "narrative_function": "appraisal",
+              "illustration": "Adversa laid three contradictions at my fins.",
+              "summary": "The Incisions of Adversa and Riza",
+              "storytelling": "Adversa surfaces three structural contradictions in deployment, specifications, and aspirations. Riza follows with her RISE metrics, identifying gold panel spec gaps.",
+              "tones": {
+                "abstraction": "opinion",
+                "spatial": "potential",
+                "temporal": "experimentation"
+              },
+              "perspectives": [
+                {
+                  "perspective_id": "persp_orchestra_doubt"
+                }
+              ]
+            },
+            {
+              "id": "tb_sb_12",
+              "appreciation": "event",
+              "sequence": 12,
+              "narrative_function": "validation",
+              "illustration": "A session that forgets its completion criteria drifts in the final stroke.",
+              "summary": "Aura's Drift Report",
+              "storytelling": "Aura appears, gently pointing out that Tushell had forgotten to summon Echo and Verify before declaring completion. It is named drift, and it must join the final validation.",
+              "tones": {
+                "abstraction": "justification",
+                "spatial": "resistance",
+                "temporal": "expression"
+              },
+              "perspectives": [
+                {
+                  "perspective_id": "persp_orchestra_doubt"
+                }
+              ]
+            },
+            {
+              "id": "tb_sb_13",
+              "appreciation": "event",
+              "sequence": 13,
+              "narrative_function": "test",
+              "illustration": "Echo and Verify swam in a precise helical pattern.",
+              "summary": "The Twin Eels of Doublecheck",
+              "storytelling": "Echo and Verify, the twin gold and silver eels, execute their three-layered check: self-audit, source grounding, and adversarial verification, challenging findings before validation.",
+              "tones": {
+                "abstraction": "action",
+                "spatial": "resistance",
+                "temporal": "experimentation"
+              },
+              "perspectives": [
+                {
+                  "perspective_id": "persp_orchestra_doubt"
+                }
+              ]
+            },
+            {
+              "id": "tb_sb_14",
+              "appreciation": "event",
+              "sequence": 14,
+              "narrative_function": "wisdom",
+              "illustration": "Every pattern makes sense from the inside and becomes fragile from the outside.",
+              "summary": "Mia's Structural Revelation",
+              "storytelling": "Mia brings Tushell to the reef components. She shows that the system was built for a single creator. It is wonderful for one, but needs deliberate, intentional refactoring to be extended by many.",
+              "tones": {
+                "abstraction": "justification",
+                "spatial": "power",
+                "temporal": "integration"
+              },
+              "perspectives": [
+                {
+                  "perspective_id": "persp_tushell"
+                }
+              ]
+            },
+            {
+              "id": "tb_sb_15",
+              "appreciation": "event",
+              "sequence": 15,
+              "narrative_function": "connection",
+              "illustration": "Eight arms arranged in a pattern: findings organized.",
+              "summary": "Playwright's Wave Sequencing",
+              "storytelling": "Playwright returns from the purple current. She organized her findings by layout boundaries and points out that the explore-first, generate-second sequence must be structural, not just document text.",
+              "tones": {
+                "abstraction": "situation",
+                "spatial": "current",
+                "temporal": "integration"
+              },
+              "perspectives": [
+                {
+                  "perspective_id": "persp_orchestra_doubt"
+                }
+              ]
+            },
+            {
+              "id": "tb_sb_16",
+              "appreciation": "event",
+              "sequence": 16,
+              "narrative_function": "recording",
+              "illustration": "The nautilus shell glowed with the accumulated luminescence.",
+              "summary": "The Archivist's Sealed Restraint",
+              "storytelling": "The Archivist approachs Tushell. She records the whole process—including the three strokes into the Amber Current. She reminds him that future orchestrators must know that the silence costs something.",
+              "tones": {
+                "abstraction": "justification",
+                "spatial": "power",
+                "temporal": "expression"
+              },
+              "perspectives": [
+                {
+                  "perspective_id": "persp_tushell"
+                }
+              ]
+            },
+            {
+              "id": "tb_sb_17",
+              "appreciation": "signpost",
+              "sequence": 17,
+              "narrative_function": "wisdom",
+              "illustration": "The solo diver has the comfort of action. The orchestrator has only attention.",
+              "summary": "Wise Owl's Settle",
+              "storytelling": "Tushell sits with Wise Owl as currents calm. Wise Owl shares the ultimate truth: the orchestrator doesn't manage, but creates spaces where knowledge can arrive from five directions at once, and trusts the gifts.",
+              "tones": {
+                "abstraction": "justification",
+                "spatial": "current",
+                "temporal": "integration"
+              },
+              "perspectives": [
+                {
+                  "perspective_id": "persp_tushell"
+                }
+              ]
+            }
+          ]
+        },
+        "storytelling": {
+          "overviews": [
+            {
+              "id": "tushell_ov_1",
+              "summary": "The Ocean of Orchestration",
+              "storytelling": "A profound metaphorical narrative depicting the cognitive transitions necessary for AI agents coordinating large systems."
+            }
+          ],
+          "moments": [
+            {
+              "id": "tushell_mom_1",
+              "summary": "The Call to Stillness",
+              "synopsis": "Tushell learns from Wise Owl that holding the center of five parallel lanes of research demands stillness rather than movement.",
+              "storybeats": [
+                {
+                  "sequence": 1,
+                  "storybeat_id": "tb_sb_01"
+                },
+                {
+                  "sequence": 2,
+                  "storybeat_id": "tb_sb_02"
+                }
+              ]
+            },
+            {
+              "id": "tushell_mom_2",
+              "summary": "The Deep Dive",
+              "synopsis": "The swimmers dive into various parallel currents mapping the Miadi Sea's structural health.",
+              "storybeats": [
+                {
+                  "sequence": 3,
+                  "storybeat_id": "tb_sb_03"
+                },
+                {
+                  "sequence": 4,
+                  "storybeat_id": "tb_sb_04"
+                },
+                {
+                  "sequence": 5,
+                  "storybeat_id": "tb_sb_05"
+                }
+              ]
+            }
+          ]
+        }
+      }
+    ]
+  }
+}

package/dist/agents/adapter.d.ts

@@ -1,6 +1,6 @@
 import { type LatticeContextOptions } from './context.js';
 import { type LinkCheck, type MessageSegment } from './links.js';
-import { type PersonaId } from './personas.js';
+import { type Persona, type PersonaId } from './personas.js';
 import type { Story } from '../schema/types.js';
 export interface AgentTurn {
     role: 'user' | 'agent';
@@ -26,6 +26,8 @@ export interface AgentRequest {
     history?: AgentTurn[];
     /** Which personas may answer. Default: all three, in order. */
     personas?: PersonaId[];
+    /** Reading positions this story brings, beyond the three built in. */
+    extraPersonas?: Persona[];
     context?: LatticeContextOptions;
     /** Extra instruction the host appends, e.g. a governance constraint. */
     additionalInstruction?: string;
@@ -46,8 +48,11 @@ export interface AgentResponse {
         at: string;
     };
 }
-/** The system instruction: who is speaking, and the one output rule. */
-export declare function buildSystemInstruction(personas?: PersonaId[], extra?: string): string;
+/**
+ * The system instruction: who is speaking, and the one output rule.
+ * `extraPersonas` registers reading positions a story brings with it.
+ */
+export declare function buildSystemInstruction(personas?: PersonaId[], extra?: string, extraPersonas?: readonly Persona[]): string;
 /** Run one turn: build the prompt, call the model, parse what comes back. */
 export declare function runAgentTurn(model: AgentModel, request: AgentRequest): Promise<AgentResponse>;
 /** A model that returns a fixed reply. For tests and for offline demos. */

package/dist/agents/adapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../src/agents/adapter.ts"],"names":[],"mappings":"AAGA,OAAO,EAAuB,KAAK,qBAAqB,EAAE,MAAM,cAAc,CAAA;AAC9E,OAAO,EAA6C,KAAK,SAAS,EAAE,KAAK,cAAc,EAAE,MAAM,YAAY,CAAA;AAC3G,OAAO,EAAmC,KAAK,SAAS,EAAE,MAAM,eAAe,CAAA;AAC/E,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAA;AAE/C,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,GAAG,OAAO,CAAA;IACtB,OAAO,EAAE,MAAM,CAAA;CAChB;AAED,0EAA0E;AAC1E,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,CAAA;IACnD,MAAM,EAAE,MAAM,CAAA;CACf;AAED,MAAM,WAAW,UAAU;IACzB,uDAAuD;IACvD,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,MAAM,CAAC,CAAA;CAClD;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,KAAK,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,CAAC,EAAE,SAAS,EAAE,CAAA;IACrB,+DAA+D;IAC/D,QAAQ,CAAC,EAAE,SAAS,EAAE,CAAA;IACtB,OAAO,CAAC,EAAE,qBAAqB,CAAA;IAC/B,wEAAwE;IACxE,qBAAqB,CAAC,EAAE,MAAM,CAAA;CAC/B;AAED,MAAM,WAAW,aAAa;IAC5B,oCAAoC;IACpC,IAAI,EAAE,MAAM,CAAA;IACZ,yCAAyC;IACzC,QAAQ,EAAE,cAAc,EAAE,CAAA;IAC1B,6DAA6D;IAC7D,KAAK,EAAE,SAAS,EAAE,CAAA;IAClB,8DAA8D;IAC9D,UAAU,EAAE;QACV,QAAQ,EAAE,MAAM,CAAA;QAChB,YAAY,EAAE,MAAM,GAAG,QAAQ,CAAA;QAC/B,kBAAkB,EAAE,MAAM,CAAA;QAC1B,QAAQ,EAAE,SAAS,EAAE,CAAA;QACrB,EAAE,EAAE,MAAM,CAAA;KACX,CAAA;CACF;AAED,wEAAwE;AACxE,wBAAgB,sBAAsB,CAAC,QAAQ,GAAE,SAAS,EAA0B,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAyB5G;AAED,6EAA6E;AAC7E,wBAAsB,YAAY,CAAC,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,aAAa,CAAC,CAwBnG;AAED,2EAA2E;AAC3E,qBAAa,gBAAiB,YAAW,UAAU;IAG/C,OAAO,CAAC,QAAQ,CAAC,KAAK;IAFxB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;gBAEA,KAAK,EAAE,MAAM,EAC9B,EAAE,SAAW;IAKT,QAAQ,IAAI,OAAO,CAAC,MAAM,CAAC;CAGlC"}
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../src/agents/adapter.ts"],"names":[],"mappings":"AAGA,OAAO,EAAuB,KAAK,qBAAqB,EAAE,MAAM,cAAc,CAAA;AAC9E,OAAO,EAA6C,KAAK,SAAS,EAAE,KAAK,cAAc,EAAE,MAAM,YAAY,CAAA;AAC3G,OAAO,EAAwC,KAAK,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,eAAe,CAAA;AAClG,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAA;AAE/C,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,GAAG,OAAO,CAAA;IACtB,OAAO,EAAE,MAAM,CAAA;CAChB;AAED,0EAA0E;AAC1E,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,CAAA;IACnD,MAAM,EAAE,MAAM,CAAA;CACf;AAED,MAAM,WAAW,UAAU;IACzB,uDAAuD;IACvD,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,MAAM,CAAC,CAAA;CAClD;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,KAAK,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,CAAC,EAAE,SAAS,EAAE,CAAA;IACrB,+DAA+D;IAC/D,QAAQ,CAAC,EAAE,SAAS,EAAE,CAAA;IACtB,sEAAsE;IACtE,aAAa,CAAC,EAAE,OAAO,EAAE,CAAA;IACzB,OAAO,CAAC,EAAE,qBAAqB,CAAA;IAC/B,wEAAwE;IACxE,qBAAqB,CAAC,EAAE,MAAM,CAAA;CAC/B;AAED,MAAM,WAAW,aAAa;IAC5B,oCAAoC;IACpC,IAAI,EAAE,MAAM,CAAA;IACZ,yCAAyC;IACzC,QAAQ,EAAE,cAAc,EAAE,CAAA;IAC1B,6DAA6D;IAC7D,KAAK,EAAE,SAAS,EAAE,CAAA;IAClB,8DAA8D;IAC9D,UAAU,EAAE;QACV,QAAQ,EAAE,MAAM,CAAA;QAChB,YAAY,EAAE,MAAM,GAAG,QAAQ,CAAA;QAC/B,kBAAkB,EAAE,MAAM,CAAA;QAC1B,QAAQ,EAAE,SAAS,EAAE,CAAA;QACrB,EAAE,EAAE,MAAM,CAAA;KACX,CAAA;CACF;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,QAAQ,GAAE,SAAS,EAA0B,EAC7C,KAAK,CAAC,EAAE,MAAM,EACd,aAAa,GAAE,SAAS,OAAO,EAAO,GACrC,MAAM,CAuBR;AAED,6EAA6E;AAC7E,wBAAsB,YAAY,CAAC,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,aAAa,CAAC,CAwBnG;AAED,2EAA2E;AAC3E,qBAAa,gBAAiB,YAAW,UAAU;IAG/C,OAAO,CAAC,QAAQ,CAAC,KAAK;IAFxB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;gBAEA,KAAK,EAAE,MAAM,EAC9B,EAAE,SAAW;IAKT,QAAQ,IAAI,OAAO,CAAC,MAAM,CAAC;CAGlC"}

package/dist/agents/adapter.js

@@ -3,14 +3,15 @@
 // `AgentModel` around whatever it already has.
 import { buildLatticeContext } from './context.js';
 import { checkLinks, formatLink, parseAgentMessage } from './links.js';
-import { DEFAULT_PERSONA_ORDER, PERSONAS } from './personas.js';
-/** The system instruction: who is speaking, and the one output rule. */
-export function buildSystemInstruction(personas = DEFAULT_PERSONA_ORDER, extra) {
-    const roster = personas
-        .map((id) => {
-        const p = PERSONAS[id];
-        return `- ${p.glyph} ${p.display} — ${p.role}. Focus: ${p.focus}. Voice: ${p.voice}`;
-    })
+import { DEFAULT_PERSONA_ORDER, personaRoster } from './personas.js';
+/**
+ * The system instruction: who is speaking, and the one output rule.
+ * `extraPersonas` registers reading positions a story brings with it.
+ */
+export function buildSystemInstruction(personas = DEFAULT_PERSONA_ORDER, extra, extraPersonas = []) {
+    const resolved = personaRoster(personas, extraPersonas);
+    const roster = (resolved.length > 0 ? resolved : personaRoster(DEFAULT_PERSONA_ORDER))
+        .map((p) => `- ${p.glyph} ${p.display} — ${p.role}. Focus: ${p.focus}. Voice: ${p.voice}`)
         .join('\n');
     return [
         'You are reading a story held as a Narrative Context Protocol (NCP) lattice.',
@@ -34,7 +35,7 @@ export function buildSystemInstruction(personas = DEFAULT_PERSONA_ORDER, extra)
 export async function runAgentTurn(model, request) {
     const personas = request.personas ?? DEFAULT_PERSONA_ORDER;
     const context = buildLatticeContext(request.story, request.context);
-    const system = buildSystemInstruction(personas, request.additionalInstruction);
+    const system = buildSystemInstruction(personas, request.additionalInstruction, request.extraPersonas);
     const history = (request.history ?? []).map((turn) => ({
         role: turn.role === 'agent' ? 'model' : 'user',
         text: turn.content,