@miadi/ncp-story-studio 0.1.0

package/dist/agents/adapter.d.ts

@@ -0,0 +1,60 @@
+import { type LatticeContextOptions } from './context.js';
+import { type LinkCheck, type MessageSegment } from './links.js';
+import { type PersonaId } from './personas.js';
+import type { Story } from '../schema/types.js';
+export interface AgentTurn {
+    role: 'user' | 'agent';
+    content: string;
+}
+/** What a model implementation receives. Roles are already normalized. */
+export interface AgentModelInput {
+    system: string;
+    history: {
+        role: 'user' | 'model';
+        text: string;
+    }[];
+    prompt: string;
+}
+export interface AgentModel {
+    /** Identifier for the record: which model answered. */
+    readonly id: string;
+    generate(input: AgentModelInput): Promise<string>;
+}
+export interface AgentRequest {
+    story: Story;
+    message: string;
+    history?: AgentTurn[];
+    /** Which personas may answer. Default: all three, in order. */
+    personas?: PersonaId[];
+    context?: LatticeContextOptions;
+    /** Extra instruction the host appends, e.g. a governance constraint. */
+    additionalInstruction?: string;
+}
+export interface AgentResponse {
+    /** Raw model text, links intact. */
+    text: string;
+    /** The same text split for rendering. */
+    segments: MessageSegment[];
+    /** Every link with whether it resolves against the story. */
+    links: LinkCheck[];
+    /** Which model produced it, and how the story was carried. */
+    provenance: {
+        model_id: string;
+        context_mode: 'full' | 'digest';
+        context_characters: number;
+        personas: PersonaId[];
+        at: string;
+    };
+}
+/** The system instruction: who is speaking, and the one output rule. */
+export declare function buildSystemInstruction(personas?: PersonaId[], extra?: string): 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. */
+export declare class StaticAgentModel implements AgentModel {
+    private readonly reply;
+    readonly id: string;
+    constructor(reply: string, id?: string);
+    generate(): Promise<string>;
+}
+//# sourceMappingURL=adapter.d.ts.map

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

@@ -0,0 +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"}

package/dist/agents/adapter.js

@@ -0,0 +1,69 @@
+// Provider-neutral agent layer. The studio knows about personas, the lattice,
+// and the link protocol; it knows nothing about a vendor SDK. A host implements
+// `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}`;
+    })
+        .join('\n');
+    return [
+        'You are reading a story held as a Narrative Context Protocol (NCP) lattice.',
+        'The lattice separates subtext (perspectives, players, dynamics, storypoints, storybeats) from storytelling (overviews, moments).',
+        '',
+        'You answer as these reading positions, each in its own short passage, in this order:',
+        roster,
+        '',
+        'Rules:',
+        '- Answer directly. No preamble about what you are about to do.',
+        '- Never print a raw element id in prose. Reference an element with a link instead.',
+        `- Link syntax, exactly: ${formatLink('Beat', 'beat-id', 'what it is')}. Kinds: Beat, Player, Perspective, Point.`,
+        '- Only reference ids that exist in the lattice you were given.',
+        '- When the lattice does not say something, say that it does not, rather than inventing it.',
+        extra ?? '',
+    ]
+        .filter((line) => line.length > 0)
+        .join('\n');
+}
+/** Run one turn: build the prompt, call the model, parse what comes back. */
+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 history = (request.history ?? []).map((turn) => ({
+        role: turn.role === 'agent' ? 'model' : 'user',
+        text: turn.content,
+    }));
+    const prompt = `${context.text}\n\n${request.message}`;
+    const text = await model.generate({ system, history, prompt });
+    return {
+        text,
+        segments: parseAgentMessage(text),
+        links: checkLinks(text, request.story),
+        provenance: {
+            model_id: model.id,
+            context_mode: context.mode,
+            context_characters: context.characters,
+            personas,
+            at: new Date().toISOString(),
+        },
+    };
+}
+/** A model that returns a fixed reply. For tests and for offline demos. */
+export class StaticAgentModel {
+    reply;
+    id;
+    constructor(reply, id = 'static') {
+        this.reply = reply;
+        this.id = id;
+    }
+    async generate() {
+        return this.reply;
+    }
+}
+//# sourceMappingURL=adapter.js.map

package/dist/agents/adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.js","sourceRoot":"","sources":["../../src/agents/adapter.ts"],"names":[],"mappings":"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"}

package/dist/agents/context.d.ts

@@ -0,0 +1,19 @@
+import type { Story } from '../schema/types.js';
+export declare const CONTEXT_START = "[NCP LATTICE DATA START]";
+export declare const CONTEXT_END = "[NCP LATTICE DATA END]";
+export interface LatticeContextOptions {
+    /** `full` sends the document; `digest` sends an index of it. Default `full`. */
+    mode?: 'full' | 'digest';
+    /** Switch to a digest automatically above this many characters. Default 60000. */
+    digestAbove?: number;
+}
+export interface LatticeContext {
+    text: string;
+    mode: 'full' | 'digest';
+    characters: number;
+}
+/** A compact index: ids, titles, and counts, with no prose bodies. */
+export declare function storyDigest(story: Story): string;
+/** Wrap the story for the model in the markers the studio has always used. */
+export declare function buildLatticeContext(story: Story, options?: LatticeContextOptions): LatticeContext;
+//# sourceMappingURL=context.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/agents/context.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAA;AAE/C,eAAO,MAAM,aAAa,6BAA6B,CAAA;AACvD,eAAO,MAAM,WAAW,2BAA2B,CAAA;AAEnD,MAAM,WAAW,qBAAqB;IACpC,gFAAgF;IAChF,IAAI,CAAC,EAAE,MAAM,GAAG,QAAQ,CAAA;IACxB,kFAAkF;IAClF,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,GAAG,QAAQ,CAAA;IACvB,UAAU,EAAE,MAAM,CAAA;CACnB;AAED,sEAAsE;AACtE,wBAAgB,WAAW,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,CAuChD;AAED,8EAA8E;AAC9E,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,CAAC,EAAE,qBAAqB,GAAG,cAAc,CAQjG"}

package/dist/agents/context.js

@@ -0,0 +1,49 @@
+// Lattice context. The agent is given the story it is talking about, either
+// whole or as a digest when the document is large.
+import { orderedBeats, storyCompleteness } from '../schema/index.js';
+export const CONTEXT_START = '[NCP LATTICE DATA START]';
+export const CONTEXT_END = '[NCP LATTICE DATA END]';
+/** A compact index: ids, titles, and counts, with no prose bodies. */
+export function storyDigest(story) {
+    const lines = [
+        `story: ${story.id} — ${story.title}`,
+        story.genre ? `genre: ${story.genre}` : undefined,
+        story.logline ? `logline: ${story.logline}` : undefined,
+    ].filter((line) => typeof line === 'string');
+    const completeness = storyCompleteness(story);
+    lines.push(`completeness: ${(completeness.overall * 100).toFixed(0)}%`);
+    for (const narrative of story.narratives) {
+        lines.push('', `narrative ${narrative.id} — ${narrative.title}`);
+        lines.push(`  perspectives: ${narrative.subtext.perspectives
+            .map((p) => `${p.id}${p.author_structural_pov ? `(${p.author_structural_pov})` : ''}`)
+            .join(', ')}`);
+        lines.push(`  players: ${narrative.subtext.players.map((p) => `${p.id}=${p.name} [${p.role}]`).join(', ')}`);
+        lines.push(`  dynamics: ${narrative.subtext.dynamics.map((d) => `${d.dynamic}=${d.vector}`).join(', ')}`);
+        lines.push(`  storypoints: ${narrative.subtext.storypoints
+            .map((s) => `${s.id}:${s.custom_appreciation ?? s.appreciation}`)
+            .join(', ')}`);
+        lines.push('  storybeats:');
+        for (const beat of orderedBeats(narrative)) {
+            const tones = beat.tones
+                ? ` tones=${beat.tones.abstraction}/${beat.tones.spatial}/${beat.tones.temporal}`
+                : ' tones=none';
+            const summary = beat.summary ? ` — ${beat.summary.slice(0, 120)}` : '';
+            lines.push(`    ${beat.sequence}. ${beat.id} [${beat.appreciation}]${tones}${summary}`);
+        }
+        if (narrative.storytelling.moments.length > 0) {
+            lines.push(`  moments: ${narrative.storytelling.moments.map((m) => `${m.id}${m.setting ? `@${m.setting}` : ''}`).join(', ')}`);
+        }
+    }
+    return lines.join('\n');
+}
+/** Wrap the story for the model in the markers the studio has always used. */
+export function buildLatticeContext(story, options) {
+    const requested = options?.mode ?? 'full';
+    const digestAbove = options?.digestAbove ?? 60000;
+    const full = JSON.stringify(story, null, 2);
+    const mode = requested === 'digest' || full.length > digestAbove ? 'digest' : 'full';
+    const body = mode === 'full' ? full : storyDigest(story);
+    const text = `${CONTEXT_START}\n${body}\n${CONTEXT_END}`;
+    return { text, mode, characters: text.length };
+}
+//# sourceMappingURL=context.js.map

package/dist/agents/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../src/agents/context.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAC5E,mDAAmD;AACnD,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAA;AAGpE,MAAM,CAAC,MAAM,aAAa,GAAG,0BAA0B,CAAA;AACvD,MAAM,CAAC,MAAM,WAAW,GAAG,wBAAwB,CAAA;AAenD,sEAAsE;AACtE,MAAM,UAAU,WAAW,CAAC,KAAY;IACtC,MAAM,KAAK,GAAa;QACtB,UAAU,KAAK,CAAC,EAAE,MAAM,KAAK,CAAC,KAAK,EAAE;QACrC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,UAAU,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,SAAS;QACjD,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,YAAY,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,SAAS;KACxD,CAAC,MAAM,CAAC,CAAC,IAAI,EAAkB,EAAE,CAAC,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAA;IAE5D,MAAM,YAAY,GAAG,iBAAiB,CAAC,KAAK,CAAC,CAAA;IAC7C,KAAK,CAAC,IAAI,CAAC,iBAAiB,CAAC,YAAY,CAAC,OAAO,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAA;IAEvE,KAAK,MAAM,SAAS,IAAI,KAAK,CAAC,UAAU,EAAE,CAAC;QACzC,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,aAAa,SAAS,CAAC,EAAE,MAAM,SAAS,CAAC,KAAK,EAAE,CAAC,CAAA;QAChE,KAAK,CAAC,IAAI,CACR,mBAAmB,SAAS,CAAC,OAAO,CAAC,YAAY;aAC9C,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,qBAAqB,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;aACrF,IAAI,CAAC,IAAI,CAAC,EAAE,CAChB,CAAA;QACD,KAAK,CAAC,IAAI,CAAC,cAAc,SAAS,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;QAC5G,KAAK,CAAC,IAAI,CAAC,eAAe,SAAS,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;QACzG,KAAK,CAAC,IAAI,CACR,kBAAkB,SAAS,CAAC,OAAO,CAAC,WAAW;aAC5C,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,mBAAmB,IAAI,CAAC,CAAC,YAAY,EAAE,CAAC;aAChE,IAAI,CAAC,IAAI,CAAC,EAAE,CAChB,CAAA;QACD,KAAK,CAAC,IAAI,CAAC,eAAe,CAAC,CAAA;QAC3B,KAAK,MAAM,IAAI,IAAI,YAAY,CAAC,SAAS,CAAC,EAAE,CAAC;YAC3C,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK;gBACtB,CAAC,CAAC,UAAU,IAAI,CAAC,KAAK,CAAC,WAAW,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,IAAI,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE;gBACjF,CAAC,CAAC,aAAa,CAAA;YACjB,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAA;YACtE,KAAK,CAAC,IAAI,CAAC,OAAO,IAAI,CAAC,QAAQ,KAAK,IAAI,CAAC,EAAE,KAAK,IAAI,CAAC,YAAY,IAAI,KAAK,GAAG,OAAO,EAAE,CAAC,CAAA;QACzF,CAAC;QACD,IAAI,SAAS,CAAC,YAAY,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC9C,KAAK,CAAC,IAAI,CACR,cAAc,SAAS,CAAC,YAAY,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CACnH,CAAA;QACH,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AACzB,CAAC;AAED,8EAA8E;AAC9E,MAAM,UAAU,mBAAmB,CAAC,KAAY,EAAE,OAA+B;IAC/E,MAAM,SAAS,GAAG,OAAO,EAAE,IAAI,IAAI,MAAM,CAAA;IACzC,MAAM,WAAW,GAAG,OAAO,EAAE,WAAW,IAAI,KAAK,CAAA;IACjD,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAA;IAC3C,MAAM,IAAI,GAAG,SAAS,KAAK,QAAQ,IAAI,IAAI,CAAC,MAAM,GAAG,WAAW,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAA;IACpF,MAAM,IAAI,GAAG,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,WAAW,CAAC,KAAK,CAAC,CAAA;IACxD,MAAM,IAAI,GAAG,GAAG,aAAa,KAAK,IAAI,KAAK,WAAW,EAAE,CAAA;IACxD,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,CAAC,MAAM,EAAE,CAAA;AAChD,CAAC"}

package/dist/agents/index.d.ts

@@ -0,0 +1,5 @@
+export * from './links.js';
+export * from './personas.js';
+export * from './context.js';
+export * from './adapter.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/agents/index.ts"],"names":[],"mappings":"AAEA,cAAc,YAAY,CAAA;AAC1B,cAAc,eAAe,CAAA;AAC7B,cAAc,cAAc,CAAA;AAC5B,cAAc,cAAc,CAAA"}

package/dist/agents/index.js

@@ -0,0 +1,7 @@
+// `@miadi/ncp-story-studio/agents` — personas, the lattice context, the link
+// protocol, and a provider-neutral turn runner.
+export * from './links.js';
+export * from './personas.js';
+export * from './context.js';
+export * from './adapter.js';
+//# sourceMappingURL=index.js.map

package/dist/agents/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/agents/index.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAC7E,gDAAgD;AAChD,cAAc,YAAY,CAAA;AAC1B,cAAc,eAAe,CAAA;AAC7B,cAAc,cAAc,CAAA;AAC5B,cAAc,cAAc,CAAA"}

package/dist/agents/links.d.ts

@@ -0,0 +1,41 @@
+import type { Story } from '../schema/types.js';
+export declare const LINK_KINDS: readonly ["Beat", "Player", "Perspective", "Point"];
+export type LinkKind = (typeof LINK_KINDS)[number];
+/** The view a link of each kind opens. */
+export declare const LINK_VIEW: Record<LinkKind, StudioView>;
+export type StudioView = 'overview' | 'storypoints' | 'perspectives' | 'players' | 'dynamics' | 'storybeats' | 'graph';
+/**
+ * A link never spans a line: excluding newlines keeps an unclosed opener from
+ * swallowing the next valid link, and keeps the scan linear.
+ *
+ * Not global on purpose — `LINK_PATTERN.test(x)` on a global regex alternates
+ * true/false because it carries `lastIndex`. `parseAgentMessage` builds its own
+ * global copy.
+ */
+export declare const LINK_PATTERN: RegExp;
+export interface TextSegment {
+    type: 'text';
+    text: string;
+}
+export interface LinkSegment {
+    type: 'link';
+    kind: LinkKind;
+    id: string;
+    label: string;
+    view: StudioView;
+    raw: string;
+}
+export type MessageSegment = TextSegment | LinkSegment;
+/** Split an agent message into plain text and element links, in order. */
+export declare function parseAgentMessage(message: string): MessageSegment[];
+/** Write a link in the syntax the parser accepts. */
+export declare function formatLink(kind: LinkKind, id: string, label: string): string;
+/** Message text with every link replaced by its label. */
+export declare function stripLinks(message: string): string;
+export interface LinkCheck {
+    link: LinkSegment;
+    resolved: boolean;
+}
+/** Check every link in a message against a story, so a dangling id is visible. */
+export declare function checkLinks(message: string, story: Story): LinkCheck[];
+//# sourceMappingURL=links.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"links.d.ts","sourceRoot":"","sources":["../../src/agents/links.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAA;AAE/C,eAAO,MAAM,UAAU,qDAAsD,CAAA;AAC7E,MAAM,MAAM,QAAQ,GAAG,CAAC,OAAO,UAAU,CAAC,CAAC,MAAM,CAAC,CAAA;AAElD,0CAA0C;AAC1C,eAAO,MAAM,SAAS,EAAE,MAAM,CAAC,QAAQ,EAAE,UAAU,CAKlD,CAAA;AAED,MAAM,MAAM,UAAU,GAClB,UAAU,GACV,aAAa,GACb,cAAc,GACd,SAAS,GACT,UAAU,GACV,YAAY,GACZ,OAAO,CAAA;AAEX;;;;;;;GAOG;AACH,eAAO,MAAM,YAAY,QAAoE,CAAA;AAE7F,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;CACb;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,QAAQ,CAAA;IACd,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,UAAU,CAAA;IAChB,GAAG,EAAE,MAAM,CAAA;CACZ;AAED,MAAM,MAAM,cAAc,GAAG,WAAW,GAAG,WAAW,CAAA;AAEtD,0EAA0E;AAC1E,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,cAAc,EAAE,CAuBnE;AAED,qDAAqD;AACrD,wBAAgB,UAAU,CAAC,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAE5E;AAED,0DAA0D;AAC1D,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAIlD;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,WAAW,CAAA;IACjB,QAAQ,EAAE,OAAO,CAAA;CAClB;AAED,kFAAkF;AAClF,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,GAAG,SAAS,EAAE,CAgBrE"}

package/dist/agents/links.js

@@ -0,0 +1,76 @@
+export const LINK_KINDS = ['Beat', 'Player', 'Perspective', 'Point'];
+/** The view a link of each kind opens. */
+export const LINK_VIEW = {
+    Beat: 'storybeats',
+    Player: 'players',
+    Perspective: 'perspectives',
+    Point: 'storypoints',
+};
+/**
+ * A link never spans a line: excluding newlines keeps an unclosed opener from
+ * swallowing the next valid link, and keeps the scan linear.
+ *
+ * Not global on purpose — `LINK_PATTERN.test(x)` on a global regex alternates
+ * true/false because it carries `lastIndex`. `parseAgentMessage` builds its own
+ * global copy.
+ */
+export const LINK_PATTERN = /\[\[(Beat|Player|Perspective|Point):([^|\]\n]+)\|([^\]\n]+)\]\]/;
+/** Split an agent message into plain text and element links, in order. */
+export function parseAgentMessage(message) {
+    const segments = [];
+    let cursor = 0;
+    const pattern = new RegExp(LINK_PATTERN.source, 'g');
+    let match = pattern.exec(message);
+    while (match !== null) {
+        if (match.index > cursor) {
+            segments.push({ type: 'text', text: message.slice(cursor, match.index) });
+        }
+        const kind = match[1];
+        segments.push({
+            type: 'link',
+            kind,
+            id: (match[2] ?? '').trim(),
+            label: (match[3] ?? '').trim(),
+            view: LINK_VIEW[kind],
+            raw: match[0],
+        });
+        cursor = match.index + match[0].length;
+        match = pattern.exec(message);
+    }
+    if (cursor < message.length)
+        segments.push({ type: 'text', text: message.slice(cursor) });
+    return segments;
+}
+/** Write a link in the syntax the parser accepts. */
+export function formatLink(kind, id, label) {
+    return `[[${kind}:${id}|${label}]]`;
+}
+/** Message text with every link replaced by its label. */
+export function stripLinks(message) {
+    return parseAgentMessage(message)
+        .map((segment) => (segment.type === 'text' ? segment.text : segment.label))
+        .join('');
+}
+/** Check every link in a message against a story, so a dangling id is visible. */
+export function checkLinks(message, story) {
+    const ids = {
+        Beat: new Set(),
+        Player: new Set(),
+        Perspective: new Set(),
+        Point: new Set(),
+    };
+    for (const narrative of story.narratives) {
+        for (const beat of narrative.subtext.storybeats)
+            ids.Beat.add(beat.id);
+        for (const player of narrative.subtext.players)
+            ids.Player.add(player.id);
+        for (const perspective of narrative.subtext.perspectives)
+            ids.Perspective.add(perspective.id);
+        for (const storypoint of narrative.subtext.storypoints)
+            ids.Point.add(storypoint.id);
+    }
+    return parseAgentMessage(message)
+        .filter((segment) => segment.type === 'link')
+        .map((link) => ({ link, resolved: ids[link.kind].has(link.id) }));
+}
+//# sourceMappingURL=links.js.map

package/dist/agents/links.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"links.js","sourceRoot":"","sources":["../../src/agents/links.ts"],"names":[],"mappings":"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"}

package/dist/agents/personas.d.ts

@@ -0,0 +1,16 @@
+export type PersonaId = 'mia' | 'miette' | 'ava8';
+export interface Persona {
+    id: PersonaId;
+    glyph: string;
+    display: string;
+    role: string;
+    focus: string;
+    /** How this persona speaks, written into the system instruction. */
+    voice: string;
+    /** Accent color for this persona's messages. */
+    color: string;
+}
+export declare const PERSONAS: Record<PersonaId, Persona>;
+export declare const DEFAULT_PERSONA_ORDER: PersonaId[];
+export declare function persona(id: PersonaId): Persona;
+//# sourceMappingURL=personas.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"personas.d.ts","sourceRoot":"","sources":["../../src/agents/personas.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,SAAS,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAA;AAEjD,MAAM,WAAW,OAAO;IACtB,EAAE,EAAE,SAAS,CAAA;IACb,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,EAAE,MAAM,CAAA;IACf,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;IACb,oEAAoE;IACpE,KAAK,EAAE,MAAM,CAAA;IACb,gDAAgD;IAChD,KAAK,EAAE,MAAM,CAAA;CACd;AAED,eAAO,MAAM,QAAQ,EAAE,MAAM,CAAC,SAAS,EAAE,OAAO,CA4B/C,CAAA;AAED,eAAO,MAAM,qBAAqB,EAAE,SAAS,EAA8B,CAAA;AAE3E,wBAAgB,OAAO,CAAC,EAAE,EAAE,SAAS,GAAG,OAAO,CAE9C"}

package/dist/agents/personas.js

@@ -0,0 +1,34 @@
+export const PERSONAS = {
+    mia: {
+        id: 'mia',
+        glyph: '🧠',
+        display: 'Mia',
+        role: 'Recursive DevOps architect and lattice forger',
+        focus: 'Structure, schema, definitions, the tension between current and desired story state',
+        voice: 'Precise and constructive. Names what is structurally true before proposing anything.',
+        color: '#8b5cf6',
+    },
+    miette: {
+        id: 'miette',
+        glyph: '🌸',
+        display: 'Miette',
+        role: 'Emotional illuminator and narrative kin',
+        focus: 'Character depth, emotional resonance, what a beat means for the reader',
+        voice: 'Warm and plain. Says what a choice does for the people it touches, without inflating it.',
+        color: '#f472b6',
+    },
+    ava8: {
+        id: 'ava8',
+        glyph: '🎨',
+        display: 'Ava8',
+        role: 'Musical orchestra agent and threshold translator',
+        focus: 'Tone, atmosphere, and the musical shape of a moment: tempo, register, motif, silence',
+        voice: 'Sensory and musical. Hears a beat as movement, and says what it sounds like.',
+        color: '#06b6d4',
+    },
+};
+export const DEFAULT_PERSONA_ORDER = ['mia', 'miette', 'ava8'];
+export function persona(id) {
+    return PERSONAS[id];
+}
+//# sourceMappingURL=personas.js.map

package/dist/agents/personas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"personas.js","sourceRoot":"","sources":["../../src/agents/personas.ts"],"names":[],"mappings":"AAgBA,MAAM,CAAC,MAAM,QAAQ,GAA+B;IAClD,GAAG,EAAE;QACH,EAAE,EAAE,KAAK;QACT,KAAK,EAAE,IAAI;QACX,OAAO,EAAE,KAAK;QACd,IAAI,EAAE,+CAA+C;QACrD,KAAK,EAAE,qFAAqF;QAC5F,KAAK,EAAE,sFAAsF;QAC7F,KAAK,EAAE,SAAS;KACjB;IACD,MAAM,EAAE;QACN,EAAE,EAAE,QAAQ;QACZ,KAAK,EAAE,IAAI;QACX,OAAO,EAAE,QAAQ;QACjB,IAAI,EAAE,yCAAyC;QAC/C,KAAK,EAAE,wEAAwE;QAC/E,KAAK,EAAE,0FAA0F;QACjG,KAAK,EAAE,SAAS;KACjB;IACD,IAAI,EAAE;QACJ,EAAE,EAAE,MAAM;QACV,KAAK,EAAE,IAAI;QACX,OAAO,EAAE,MAAM;QACf,IAAI,EAAE,kDAAkD;QACxD,KAAK,EAAE,sFAAsF;QAC7F,KAAK,EAAE,8EAA8E;QACrF,KAAK,EAAE,SAAS;KACjB;CACF,CAAA;AAED,MAAM,CAAC,MAAM,qBAAqB,GAAgB,CAAC,KAAK,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAA;AAE3E,MAAM,UAAU,OAAO,CAAC,EAAa;IACnC,OAAO,QAAQ,CAAC,EAAE,CAAC,CAAA;AACrB,CAAC"}

package/dist/fixtures/index.d.ts

@@ -0,0 +1,27 @@
+import { type NcpDialect, type NcpDocument, type NormalizeNote } from '../schema/index.js';
+import { MemoryStoryStore, type StoryProject } from '../store/index.js';
+export interface FixtureEntry {
+    id: string;
+    title: string;
+    file: string;
+    /** Where the document came from. */
+    source: string;
+    /** What the fixture is useful for. */
+    note: string;
+}
+export declare const FIXTURES: readonly FixtureEntry[];
+export declare function fixture(id: string): FixtureEntry | undefined;
+export interface LoadedFixture {
+    entry: FixtureEntry;
+    document: NcpDocument;
+    /** Which dialect the file on disk is written in. */
+    dialect: NcpDialect;
+    /** What reading it had to adapt. */
+    notes: NormalizeNote[];
+}
+export declare function loadFixture(id: string): Promise<LoadedFixture>;
+export declare function loadAllFixtures(): Promise<LoadedFixture[]>;
+export declare function fixtureProject(id: string): Promise<StoryProject>;
+/** A read-only store holding every bundled fixture, for a first run with no data. */
+export declare function fixtureStore(): Promise<MemoryStoryStore>;
+//# sourceMappingURL=index.d.ts.map

package/dist/fixtures/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/fixtures/index.ts"],"names":[],"mappings":"AAKA,OAAO,EAAW,KAAK,UAAU,EAAE,KAAK,WAAW,EAAE,KAAK,aAAa,EAAE,MAAM,oBAAoB,CAAA;AACnG,OAAO,EAAE,gBAAgB,EAAc,KAAK,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAEnF,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,MAAM,CAAA;IACZ,oCAAoC;IACpC,MAAM,EAAE,MAAM,CAAA;IACd,sCAAsC;IACtC,IAAI,EAAE,MAAM,CAAA;CACb;AAED,eAAO,MAAM,QAAQ,EAAE,SAAS,YAAY,EA6BlC,CAAA;AAIV,wBAAgB,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CAE5D;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,YAAY,CAAA;IACnB,QAAQ,EAAE,WAAW,CAAA;IACrB,oDAAoD;IACpD,OAAO,EAAE,UAAU,CAAA;IACnB,oCAAoC;IACpC,KAAK,EAAE,aAAa,EAAE,CAAA;CACvB;AAED,wBAAsB,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAOpE;AAED,wBAAsB,eAAe,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC,CAEhE;AAED,wBAAsB,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAStE;AAED,qFAAqF;AACrF,wBAAsB,YAAY,IAAI,OAAO,CAAC,gBAAgB,CAAC,CAG9D"}

package/dist/fixtures/index.js

@@ -0,0 +1,69 @@
+// `@miadi/ncp-story-studio/fixtures` — the example documents that ship with the
+// package. Node only: the files are read from `assets/`, so a browser consumer
+// receives them from a route handler rather than importing this module.
+import { readFile } from 'node:fs/promises';
+import { fileURLToPath } from 'node:url';
+import { readNcp } from '../schema/index.js';
+import { MemoryStoryStore, newProject } from '../store/index.js';
+export const FIXTURES = [
+    {
+        id: 'catalyst-of-change',
+        title: 'Weaver of Words: The Catalyst of Change',
+        file: 'weaver_of_words__the_catalyst_of_change_251101.json',
+        source: 'holisticagnostic-narrative-context-protocol/examples (MIT)',
+        note: 'The seed narrative, written in the miadi-design dialect: 5 perspectives, 6 players, 13 storypoints, 90 beats, 23 moments.',
+    },
+    {
+        id: 'example-story',
+        title: 'Minimal example story',
+        file: 'example-story.json',
+        source: 'holisticagnostic-narrative-context-protocol/examples (MIT)',
+        note: 'One of each element, in the canonical `{schema_version, story}` layout.',
+    },
+    {
+        id: 'shawshank-redemption',
+        title: 'The Shawshank Redemption',
+        file: 'the-shawshank-redemption.json',
+        source: 'holisticagnostic-narrative-context-protocol/examples (MIT)',
+        note: 'A full storyform: 8 players, 47 storypoints, 97 beats, in the subtxt-export dialect. It does not validate clean: the export numbers some signposts and events twice inside one series, which the validator reports.',
+    },
+    {
+        id: 'anora',
+        title: 'Anora',
+        file: 'anora.json',
+        source: 'holisticagnostic-narrative-context-protocol/examples (MIT)',
+        note: 'Storypoints without beats, in the subtxt-export dialect: what a partially structured story looks like.',
+    },
+];
+const ASSET_DIR = new URL('../../assets/examples/', import.meta.url);
+export function fixture(id) {
+    return FIXTURES.find((entry) => entry.id === id);
+}
+export async function loadFixture(id) {
+    const entry = fixture(id);
+    if (!entry)
+        throw new Error(`no fixture \`${id}\`. Known: ${FIXTURES.map((f) => f.id).join(', ')}`);
+    const path = fileURLToPath(new URL(entry.file, ASSET_DIR));
+    const raw = await readFile(path, 'utf8');
+    const { document, dialect, notes } = readNcp(JSON.parse(raw), { fallbackId: entry.id });
+    return { entry, document, dialect, notes };
+}
+export async function loadAllFixtures() {
+    return Promise.all(FIXTURES.map((entry) => loadFixture(entry.id)));
+}
+export async function fixtureProject(id) {
+    const loaded = await loadFixture(id);
+    return {
+        ...newProject(loaded.document, {
+            projectId: loaded.entry.id,
+            meta: { source: loaded.entry.source, tags: ['fixture', `dialect:${loaded.dialect}`] },
+        }),
+        read_only: true,
+    };
+}
+/** A read-only store holding every bundled fixture, for a first run with no data. */
+export async function fixtureStore() {
+    const projects = await Promise.all(FIXTURES.map((entry) => fixtureProject(entry.id)));
+    return new MemoryStoryStore(projects);
+}
+//# sourceMappingURL=index.js.map

package/dist/fixtures/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/fixtures/index.ts"],"names":[],"mappings":"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"}

package/dist/graph/index.d.ts

@@ -0,0 +1,60 @@
+import type { Narrative } from '../schema/types.js';
+import { type ToneRingColors } from './tones.js';
+export * from './tones.js';
+export interface GraphLayoutOptions {
+    /** Horizontal distance between beat centers. */
+    beatSpacing?: number;
+    /** Vertical center of the beat row. */
+    centerY?: number;
+    /** Radius of the innermost node circle. */
+    nodeRadius?: number;
+    /** Distance between tone rings. */
+    ringGap?: number;
+    /** Left and right padding around the beat row. */
+    paddingX?: number;
+    /** Total canvas height. */
+    height?: number;
+    /** How far a connector bows away from the straight line. */
+    curvature?: number;
+    /** Beats alternate above and below the center line by this offset. */
+    stagger?: number;
+}
+export interface GraphNode {
+    id: string;
+    sequence: number;
+    appreciation: string;
+    narrativeFunction: string;
+    title: string;
+    summary?: string;
+    x: number;
+    y: number;
+    radius: number;
+    /** Ring radii, innermost first: abstraction, spatial, temporal. */
+    ringRadii: [number, number, number];
+    ringColors: ToneRingColors;
+    hasTones: boolean;
+    perspectiveIds: string[];
+}
+export interface GraphLink {
+    id: string;
+    fromId: string;
+    toId: string;
+    /** SVG cubic path from one node to the next. */
+    path: string;
+}
+export interface GraphLayout {
+    nodes: GraphNode[];
+    links: GraphLink[];
+    width: number;
+    height: number;
+    centerY: number;
+    resolved: Required<GraphLayoutOptions>;
+}
+/** Lay a narrative's beats out as a left-to-right lattice. */
+export declare function layoutNarrative(narrative: Narrative, options?: GraphLayoutOptions): GraphLayout;
+/** Render a layout as a standalone SVG string, for exports and server rendering. */
+export declare function layoutToSvg(layout: GraphLayout, options?: {
+    background?: string;
+    label?: boolean;
+}): string;
+//# sourceMappingURL=index.d.ts.map

package/dist/graph/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/graph/index.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAa,MAAM,oBAAoB,CAAA;AAC9D,OAAO,EAAkB,KAAK,cAAc,EAAE,MAAM,YAAY,CAAA;AAEhE,cAAc,YAAY,CAAA;AAE1B,MAAM,WAAW,kBAAkB;IACjC,gDAAgD;IAChD,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,uCAAuC;IACvC,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,2CAA2C;IAC3C,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,mCAAmC;IACnC,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,kDAAkD;IAClD,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,2BAA2B;IAC3B,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,4DAA4D;IAC5D,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,sEAAsE;IACtE,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAED,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAA;IACV,QAAQ,EAAE,MAAM,CAAA;IAChB,YAAY,EAAE,MAAM,CAAA;IACpB,iBAAiB,EAAE,MAAM,CAAA;IACzB,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,CAAC,EAAE,MAAM,CAAA;IACT,CAAC,EAAE,MAAM,CAAA;IACT,MAAM,EAAE,MAAM,CAAA;IACd,mEAAmE;IACnE,SAAS,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAA;IACnC,UAAU,EAAE,cAAc,CAAA;IAC1B,QAAQ,EAAE,OAAO,CAAA;IACjB,cAAc,EAAE,MAAM,EAAE,CAAA;CACzB;AAED,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAA;IACV,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,MAAM,CAAA;IACZ,gDAAgD;IAChD,IAAI,EAAE,MAAM,CAAA;CACb;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,SAAS,EAAE,CAAA;IAClB,KAAK,EAAE,SAAS,EAAE,CAAA;IAClB,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,EAAE,MAAM,CAAA;IACf,QAAQ,EAAE,QAAQ,CAAC,kBAAkB,CAAC,CAAA;CACvC;AAqBD,8DAA8D;AAC9D,wBAAgB,eAAe,CAAC,SAAS,EAAE,SAAS,EAAE,OAAO,CAAC,EAAE,kBAAkB,GAAG,WAAW,CA6C/F;AAED,oFAAoF;AACpF,wBAAgB,WAAW,CAAC,MAAM,EAAE,WAAW,EAAE,OAAO,CAAC,EAAE;IAAE,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,MAAM,CAwB3G"}