@sharpee/engine 0.9.113 → 1.0.0

package/prose-pipeline/handlers/room.js

@@ -0,0 +1,78 @@
+"use strict";
+/**
+ * Room description event handler.
+ *
+ * Handles `if.event.room.description` (canonical form) and
+ * `if.event.room_description` (legacy alternate). Resolves the
+ * room name and description through the language provider when a
+ * message id is present (ADR-107 dual-mode), falling back to literal
+ * text otherwise.
+ *
+ * Public interface: `handleRoomDescription`. Used by the pipeline's
+ * event-type dispatch.
+ *
+ * Owner context: `@sharpee/engine` — internal prose pipeline.
+ *
+ * @see ADR-107 — Dual-mode literal/messageId handling
+ * @see ADR-174 §Engine-internal prose pipeline (port from text-service)
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.handleRoomDescription = handleRoomDescription;
+const text_blocks_1 = require("../../../text-blocks/index.js");
+const assemble_1 = require("../assemble");
+/**
+ * Handle room description events.
+ */
+function handleRoomDescription(event, context) {
+    const data = event.data;
+    const blocks = [];
+    // Room name (if verbose).
+    if (data.verbose) {
+        let name;
+        // ADR-107: message ID takes precedence.
+        const nameId = data.roomNameId ?? data.room?.nameId;
+        if (nameId && context.languageProvider) {
+            const resolved = context.languageProvider.getMessage(nameId, {});
+            if (resolved && resolved !== nameId) {
+                name = resolved;
+            }
+        }
+        if (!name) {
+            name = data.room?.name ?? data.roomName;
+        }
+        if (name) {
+            const resolvedName = (0, assemble_1.extractValue)(name);
+            if (resolvedName) {
+                blocks.push((0, assemble_1.createBlock)(text_blocks_1.BLOCK_KEYS.ROOM_NAME, `[room:${resolvedName}]`));
+            }
+        }
+    }
+    // Room description.
+    let description;
+    const descriptionId = data.roomDescriptionId ?? data.room?.descriptionId;
+    if (descriptionId && context.languageProvider) {
+        const resolved = context.languageProvider.getMessage(descriptionId, {});
+        if (resolved && resolved !== descriptionId) {
+            description = resolved;
+        }
+    }
+    if (!description) {
+        description = data.room?.description ?? data.roomDescription;
+    }
+    if (description) {
+        const resolvedDesc = (0, assemble_1.extractValue)(description);
+        if (resolvedDesc) {
+            const descBlocks = (0, assemble_1.createBlocks)(text_blocks_1.BLOCK_KEYS.ROOM_DESCRIPTION, resolvedDesc);
+            // When the room name was emitted in this packet, the description's
+            // first block continues the room "heading" visually — mark it tight
+            // so the renderer collapses the inter-paragraph margin and the
+            // description sits flush under the bold room name.
+            if (descBlocks.length > 0 && blocks.length > 0) {
+                descBlocks[0] = { ...descBlocks[0], tight: true };
+            }
+            blocks.push(...descBlocks);
+        }
+    }
+    return blocks;
+}
+//# sourceMappingURL=room.js.map

package/prose-pipeline/handlers/room.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"room.js","sourceRoot":"","sources":["../../../../../../../../repos/sharpee/packages/engine/src/prose-pipeline/handlers/room.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;GAgBG;;AAkCH,sDAiEC;AAhGD,sDAAkD;AAGlD,0CAAsE;AAyBtE;;GAEG;AACH,SAAgB,qBAAqB,CACnC,KAAqB,EACrB,OAAuB;IAEvB,MAAM,IAAI,GAAG,KAAK,CAAC,IAA2B,CAAC;IAC/C,MAAM,MAAM,GAAiB,EAAE,CAAC;IAEhC,0BAA0B;IAC1B,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;QACjB,IAAI,IAAwB,CAAC;QAE7B,wCAAwC;QACxC,MAAM,MAAM,GAAG,IAAI,CAAC,UAAU,IAAI,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC;QACpD,IAAI,MAAM,IAAI,OAAO,CAAC,gBAAgB,EAAE,CAAC;YACvC,MAAM,QAAQ,GAAG,OAAO,CAAC,gBAAgB,CAAC,UAAU,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;YACjE,IAAI,QAAQ,IAAI,QAAQ,KAAK,MAAM,EAAE,CAAC;gBACpC,IAAI,GAAG,QAAQ,CAAC;YAClB,CAAC;QACH,CAAC;QAED,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,IAAI,GAAG,IAAI,CAAC,IAAI,EAAE,IAAI,IAAI,IAAI,CAAC,QAAQ,CAAC;QAC1C,CAAC;QAED,IAAI,IAAI,EAAE,CAAC;YACT,MAAM,YAAY,GAAG,IAAA,uBAAY,EAAC,IAAI,CAAC,CAAC;YACxC,IAAI,YAAY,EAAE,CAAC;gBACjB,MAAM,CAAC,IAAI,CACT,IAAA,sBAAW,EAAC,wBAAU,CAAC,SAAS,EAAE,SAAS,YAAY,GAAG,CAAC,CAC5D,CAAC;YACJ,CAAC;QACH,CAAC;IACH,CAAC;IAED,oBAAoB;IACpB,IAAI,WAA+B,CAAC;IAEpC,MAAM,aAAa,GAAG,IAAI,CAAC,iBAAiB,IAAI,IAAI,CAAC,IAAI,EAAE,aAAa,CAAC;IACzE,IAAI,aAAa,IAAI,OAAO,CAAC,gBAAgB,EAAE,CAAC;QAC9C,MAAM,QAAQ,GAAG,OAAO,CAAC,gBAAgB,CAAC,UAAU,CAAC,aAAa,EAAE,EAAE,CAAC,CAAC;QACxE,IAAI,QAAQ,IAAI,QAAQ,KAAK,aAAa,EAAE,CAAC;YAC3C,WAAW,GAAG,QAAQ,CAAC;QACzB,CAAC;IACH,CAAC;IAED,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,WAAW,GAAG,IAAI,CAAC,IAAI,EAAE,WAAW,IAAI,IAAI,CAAC,eAAe,CAAC;IAC/D,CAAC;IAED,IAAI,WAAW,EAAE,CAAC;QAChB,MAAM,YAAY,GAAG,IAAA,uBAAY,EAAC,WAAW,CAAC,CAAC;QAC/C,IAAI,YAAY,EAAE,CAAC;YACjB,MAAM,UAAU,GAAG,IAAA,uBAAY,EAAC,wBAAU,CAAC,gBAAgB,EAAE,YAAY,CAAC,CAAC;YAC3E,mEAAmE;YACnE,oEAAoE;YACpE,+DAA+D;YAC/D,mDAAmD;YACnD,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC/C,UAAU,CAAC,CAAC,CAAC,GAAG,EAAE,GAAG,UAAU,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;YACpD,CAAC;YACD,MAAM,CAAC,IAAI,CAAC,GAAG,UAAU,CAAC,CAAC;QAC7B,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/prose-pipeline/handlers/types.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Handler types for the engine prose pipeline.
+ *
+ * Public interface: `HandlerContext`, `EventHandler`,
+ * `ChainableEventData`, `GenericEventData`. Used by handler families
+ * and the pipeline class.
+ *
+ * Owner context: `@sharpee/engine` — internal prose pipeline.
+ *
+ * @see ADR-174 §Engine-internal prose pipeline
+ * @see ADR-094 (chain metadata semantics, preserved)
+ */
+import type { ITextBlock } from "../../../text-blocks/index";
+import type { LanguageProvider } from "../../../if-domain/index";
+import type { ISemanticEvent } from "../../../core/index";
+/**
+ * Context passed to event handlers.
+ */
+export interface HandlerContext {
+    /** Language provider for template resolution. */
+    languageProvider?: LanguageProvider;
+}
+/**
+ * Event handler function signature.
+ *
+ * Handlers receive an event and context, return zero or more TextBlocks.
+ */
+export type EventHandler = (event: ISemanticEvent, context: HandlerContext) => ITextBlock[];
+/**
+ * Common event data with chain metadata (ADR-094).
+ */
+export interface ChainableEventData {
+    _transactionId?: string;
+    _chainDepth?: number;
+    _chainedFrom?: string;
+    _chainSourceId?: string;
+}
+/**
+ * Generic event data with message fields.
+ */
+export interface GenericEventData extends ChainableEventData {
+    message?: string;
+    messageId?: string;
+    text?: string;
+    [key: string]: unknown;
+}
+//# sourceMappingURL=types.d.ts.map

package/prose-pipeline/handlers/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../../../repos/sharpee/packages/engine/src/prose-pipeline/handlers/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAEpD;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,iDAAiD;IACjD,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;CACrC;AAED;;;;GAIG;AACH,MAAM,MAAM,YAAY,GAAG,CACzB,KAAK,EAAE,cAAc,EACrB,OAAO,EAAE,cAAc,KACpB,UAAU,EAAE,CAAC;AAElB;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAiB,SAAQ,kBAAkB;IAC1D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB"}

package/prose-pipeline/handlers/types.js

@@ -0,0 +1,15 @@
+"use strict";
+/**
+ * Handler types for the engine prose pipeline.
+ *
+ * Public interface: `HandlerContext`, `EventHandler`,
+ * `ChainableEventData`, `GenericEventData`. Used by handler families
+ * and the pipeline class.
+ *
+ * Owner context: `@sharpee/engine` — internal prose pipeline.
+ *
+ * @see ADR-174 §Engine-internal prose pipeline
+ * @see ADR-094 (chain metadata semantics, preserved)
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/prose-pipeline/handlers/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../../../../../repos/sharpee/packages/engine/src/prose-pipeline/handlers/types.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;GAWG"}

package/prose-pipeline/index.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Prose pipeline — internal barrel for the engine package.
+ *
+ * Public interface: `ProsePipeline`, `createProsePipeline`,
+ * `ITextService`. Plus the decoration primitives and stage utilities
+ * the pipeline class composes.
+ *
+ * Owner context: `@sharpee/engine` — internal prose pipeline.
+ *
+ * @see ADR-174 §Engine-internal prose pipeline
+ */
+export { ProsePipeline, createProsePipeline } from './pipeline';
+export type { ITextService } from './types';
+export { parseDecorations, resolveClassName, PLATFORM_VOCABULARY, PLATFORM_VOCABULARY_NAMES, type PlatformVocabularyName, type IDecoration, type TextContent, } from './decorations';
+export { filterEvents } from './stages/filter';
+export { sortEventsForProse, getChainMetadata, } from './stages/sort';
+export { createBlock, createBlocks, extractValue } from './assemble';
+export type { EventHandler, HandlerContext, ChainableEventData, GenericEventData, } from './handlers/types';
+export { handleRoomDescription, handleRevealed, handleGameMessage, handleGenericEvent, handleGameStarted, handleHelpDisplayed, handleAboutDisplayed, handleAudibilityHeard, tryProcessDomainEventMessage, handleImplicitTake, handleCommandFailed, handleClientQuery, } from './handlers';
+//# sourceMappingURL=index.d.ts.map

package/prose-pipeline/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../repos/sharpee/packages/engine/src/prose-pipeline/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAGhE,YAAY,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAK5C,OAAO,EACL,gBAAgB,EAChB,gBAAgB,EAChB,mBAAmB,EACnB,yBAAyB,EACzB,KAAK,sBAAsB,EAC3B,KAAK,WAAW,EAChB,KAAK,WAAW,GACjB,MAAM,eAAe,CAAC;AAGvB,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EACL,kBAAkB,EAClB,gBAAgB,GACjB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAGrE,YAAY,EACV,YAAY,EACZ,cAAc,EACd,kBAAkB,EAClB,gBAAgB,GACjB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,qBAAqB,EACrB,cAAc,EACd,iBAAiB,EACjB,kBAAkB,EAClB,iBAAiB,EACjB,mBAAmB,EACnB,oBAAoB,EACpB,qBAAqB,EACrB,4BAA4B,EAC5B,kBAAkB,EAClB,mBAAmB,EACnB,iBAAiB,GAClB,MAAM,YAAY,CAAC"}

package/prose-pipeline/index.js

@@ -0,0 +1,50 @@
+"use strict";
+/**
+ * Prose pipeline — internal barrel for the engine package.
+ *
+ * Public interface: `ProsePipeline`, `createProsePipeline`,
+ * `ITextService`. Plus the decoration primitives and stage utilities
+ * the pipeline class composes.
+ *
+ * Owner context: `@sharpee/engine` — internal prose pipeline.
+ *
+ * @see ADR-174 §Engine-internal prose pipeline
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.handleClientQuery = exports.handleCommandFailed = exports.handleImplicitTake = exports.tryProcessDomainEventMessage = exports.handleAudibilityHeard = exports.handleAboutDisplayed = exports.handleHelpDisplayed = exports.handleGameStarted = exports.handleGenericEvent = exports.handleGameMessage = exports.handleRevealed = exports.handleRoomDescription = exports.extractValue = exports.createBlocks = exports.createBlock = exports.getChainMetadata = exports.sortEventsForProse = exports.filterEvents = exports.PLATFORM_VOCABULARY_NAMES = exports.PLATFORM_VOCABULARY = exports.resolveClassName = exports.parseDecorations = exports.createProsePipeline = exports.ProsePipeline = void 0;
+// Pipeline class and factory.
+var pipeline_1 = require("./pipeline");
+Object.defineProperty(exports, "ProsePipeline", { enumerable: true, get: function () { return pipeline_1.ProsePipeline; } });
+Object.defineProperty(exports, "createProsePipeline", { enumerable: true, get: function () { return pipeline_1.createProsePipeline; } });
+// Decoration primitives (re-exported for convenience to engine code
+// outside the prose-pipeline subdirectory; the canonical types live
+// in `@sharpee/text-blocks`).
+var decorations_1 = require("./decorations");
+Object.defineProperty(exports, "parseDecorations", { enumerable: true, get: function () { return decorations_1.parseDecorations; } });
+Object.defineProperty(exports, "resolveClassName", { enumerable: true, get: function () { return decorations_1.resolveClassName; } });
+Object.defineProperty(exports, "PLATFORM_VOCABULARY", { enumerable: true, get: function () { return decorations_1.PLATFORM_VOCABULARY; } });
+Object.defineProperty(exports, "PLATFORM_VOCABULARY_NAMES", { enumerable: true, get: function () { return decorations_1.PLATFORM_VOCABULARY_NAMES; } });
+// Stage utilities (handy in tests).
+var filter_1 = require("./stages/filter");
+Object.defineProperty(exports, "filterEvents", { enumerable: true, get: function () { return filter_1.filterEvents; } });
+var sort_1 = require("./stages/sort");
+Object.defineProperty(exports, "sortEventsForProse", { enumerable: true, get: function () { return sort_1.sortEventsForProse; } });
+Object.defineProperty(exports, "getChainMetadata", { enumerable: true, get: function () { return sort_1.getChainMetadata; } });
+var assemble_1 = require("./assemble");
+Object.defineProperty(exports, "createBlock", { enumerable: true, get: function () { return assemble_1.createBlock; } });
+Object.defineProperty(exports, "createBlocks", { enumerable: true, get: function () { return assemble_1.createBlocks; } });
+Object.defineProperty(exports, "extractValue", { enumerable: true, get: function () { return assemble_1.extractValue; } });
+var handlers_1 = require("./handlers");
+Object.defineProperty(exports, "handleRoomDescription", { enumerable: true, get: function () { return handlers_1.handleRoomDescription; } });
+Object.defineProperty(exports, "handleRevealed", { enumerable: true, get: function () { return handlers_1.handleRevealed; } });
+Object.defineProperty(exports, "handleGameMessage", { enumerable: true, get: function () { return handlers_1.handleGameMessage; } });
+Object.defineProperty(exports, "handleGenericEvent", { enumerable: true, get: function () { return handlers_1.handleGenericEvent; } });
+Object.defineProperty(exports, "handleGameStarted", { enumerable: true, get: function () { return handlers_1.handleGameStarted; } });
+Object.defineProperty(exports, "handleHelpDisplayed", { enumerable: true, get: function () { return handlers_1.handleHelpDisplayed; } });
+Object.defineProperty(exports, "handleAboutDisplayed", { enumerable: true, get: function () { return handlers_1.handleAboutDisplayed; } });
+Object.defineProperty(exports, "handleAudibilityHeard", { enumerable: true, get: function () { return handlers_1.handleAudibilityHeard; } });
+Object.defineProperty(exports, "tryProcessDomainEventMessage", { enumerable: true, get: function () { return handlers_1.tryProcessDomainEventMessage; } });
+Object.defineProperty(exports, "handleImplicitTake", { enumerable: true, get: function () { return handlers_1.handleImplicitTake; } });
+Object.defineProperty(exports, "handleCommandFailed", { enumerable: true, get: function () { return handlers_1.handleCommandFailed; } });
+Object.defineProperty(exports, "handleClientQuery", { enumerable: true, get: function () { return handlers_1.handleClientQuery; } });
+//# sourceMappingURL=index.js.map

package/prose-pipeline/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../../repos/sharpee/packages/engine/src/prose-pipeline/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;GAUG;;;AAEH,8BAA8B;AAC9B,uCAAgE;AAAvD,yGAAA,aAAa,OAAA;AAAE,+GAAA,mBAAmB,OAAA;AAK3C,oEAAoE;AACpE,oEAAoE;AACpE,8BAA8B;AAC9B,6CAQuB;AAPrB,+GAAA,gBAAgB,OAAA;AAChB,+GAAA,gBAAgB,OAAA;AAChB,kHAAA,mBAAmB,OAAA;AACnB,wHAAA,yBAAyB,OAAA;AAM3B,oCAAoC;AACpC,0CAA+C;AAAtC,sGAAA,YAAY,OAAA;AACrB,sCAGuB;AAFrB,0GAAA,kBAAkB,OAAA;AAClB,wGAAA,gBAAgB,OAAA;AAElB,uCAAqE;AAA5D,uGAAA,WAAW,OAAA;AAAE,wGAAA,YAAY,OAAA;AAAE,wGAAA,YAAY,OAAA;AAShD,uCAaoB;AAZlB,iHAAA,qBAAqB,OAAA;AACrB,0GAAA,cAAc,OAAA;AACd,6GAAA,iBAAiB,OAAA;AACjB,8GAAA,kBAAkB,OAAA;AAClB,6GAAA,iBAAiB,OAAA;AACjB,+GAAA,mBAAmB,OAAA;AACnB,gHAAA,oBAAoB,OAAA;AACpB,iHAAA,qBAAqB,OAAA;AACrB,wHAAA,4BAA4B,OAAA;AAC5B,8GAAA,kBAAkB,OAAA;AAClB,+GAAA,mBAAmB,OAAA;AACnB,6GAAA,iBAAiB,OAAA"}

package/prose-pipeline/pipeline.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Prose pipeline — orchestrates the per-turn event → block translation.
+ *
+ * Pipeline stages (from `processTurn`):
+ *  1. Filter — drop `system.*` and `platform.*` events.
+ *  2. Sort   — apply ADR-094 chain-metadata ordering.
+ *  3. Route  — try the messageId path first (ADR-097), then dispatch
+ *              by event type to a handler family.
+ *  4. Assemble — handlers themselves call `createBlock`, so by the
+ *                time blocks return here they already carry parsed
+ *                bracket decorations and final `className`s.
+ *
+ * Public interface: `class ProsePipeline implements ITextService`.
+ * Engine constructs one instance during `setStory()` and calls
+ * `processTurn` per turn (same three call sites as the retiring
+ * `TextService`).
+ *
+ * Owner context: `@sharpee/engine` — internal prose pipeline.
+ *
+ * @see ADR-174 §Internal interfaces
+ * @see ADR-094 Event Chaining (sort stage)
+ * @see ADR-097 Domain Events with messageId (domain-message handler)
+ */
+import type { ITextBlock } from "../../text-blocks/index";
+import type { LanguageProvider } from "../../if-domain/index";
+import type { ISemanticEvent } from "../../core/index";
+import type { ITextService } from './types';
+/**
+ * Engine-internal prose pipeline.
+ *
+ * Stateless transformer: events in, blocks out. Constructed once per
+ * `setStory()` call with the active language provider; called per
+ * turn by `GameEngine.executeTurn`, `GameEngine.restartGame`, and
+ * the meta-command path (same three sites the retired
+ * `TextService.processTurn` had).
+ */
+export declare class ProsePipeline implements ITextService {
+    private readonly languageProvider;
+    constructor(languageProvider: LanguageProvider);
+    processTurn(events: ISemanticEvent[]): ITextBlock[];
+    /**
+     * Route an event to its handler family.
+     *
+     * Order: try the ADR-097 messageId path first (catches every stdlib
+     * domain event); then fall through to type-keyed handlers; finally
+     * the catch-all generic handler.
+     */
+    private routeToHandler;
+}
+/**
+ * Construct a `ProsePipeline` for the given language provider.
+ *
+ * Mirrors the `createTextService` factory the retired text-service
+ * package exposed; callers can swap one for the other without
+ * changing call shapes.
+ */
+export declare function createProsePipeline(languageProvider: LanguageProvider): ITextService;
+//# sourceMappingURL=pipeline.d.ts.map

package/prose-pipeline/pipeline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline.d.ts","sourceRoot":"","sources":["../../../../../../repos/sharpee/packages/engine/src/prose-pipeline/pipeline.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAqBpD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAE5C;;;;;;;;GAQG;AACH,qBAAa,aAAc,YAAW,YAAY;IAChD,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAmB;gBAExC,gBAAgB,EAAE,gBAAgB;IAS9C,WAAW,CAAC,MAAM,EAAE,cAAc,EAAE,GAAG,UAAU,EAAE;IAgBnD;;;;;;OAMG;IACH,OAAO,CAAC,cAAc;CA6CvB;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CACjC,gBAAgB,EAAE,gBAAgB,GACjC,YAAY,CAEd"}

package/prose-pipeline/pipeline.js

@@ -0,0 +1,120 @@
+"use strict";
+/**
+ * Prose pipeline — orchestrates the per-turn event → block translation.
+ *
+ * Pipeline stages (from `processTurn`):
+ *  1. Filter — drop `system.*` and `platform.*` events.
+ *  2. Sort   — apply ADR-094 chain-metadata ordering.
+ *  3. Route  — try the messageId path first (ADR-097), then dispatch
+ *              by event type to a handler family.
+ *  4. Assemble — handlers themselves call `createBlock`, so by the
+ *                time blocks return here they already carry parsed
+ *                bracket decorations and final `className`s.
+ *
+ * Public interface: `class ProsePipeline implements ITextService`.
+ * Engine constructs one instance during `setStory()` and calls
+ * `processTurn` per turn (same three call sites as the retiring
+ * `TextService`).
+ *
+ * Owner context: `@sharpee/engine` — internal prose pipeline.
+ *
+ * @see ADR-174 §Internal interfaces
+ * @see ADR-094 Event Chaining (sort stage)
+ * @see ADR-097 Domain Events with messageId (domain-message handler)
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ProsePipeline = void 0;
+exports.createProsePipeline = createProsePipeline;
+const filter_1 = require("./stages/filter");
+const sort_1 = require("./stages/sort");
+const room_1 = require("./handlers/room");
+const revealed_1 = require("./handlers/revealed");
+const generic_1 = require("./handlers/generic");
+const game_1 = require("./handlers/game");
+const help_1 = require("./handlers/help");
+const about_1 = require("./handlers/about");
+const audibility_1 = require("./handlers/audibility");
+const domain_message_1 = require("./handlers/domain-message");
+const implicit_take_1 = require("./handlers/implicit-take");
+const command_failed_1 = require("./handlers/command-failed");
+const client_query_1 = require("./handlers/client-query");
+/**
+ * Engine-internal prose pipeline.
+ *
+ * Stateless transformer: events in, blocks out. Constructed once per
+ * `setStory()` call with the active language provider; called per
+ * turn by `GameEngine.executeTurn`, `GameEngine.restartGame`, and
+ * the meta-command path (same three sites the retired
+ * `TextService.processTurn` had).
+ */
+class ProsePipeline {
+    languageProvider;
+    constructor(languageProvider) {
+        if (!languageProvider) {
+            throw new Error('ProsePipeline requires a LanguageProvider; got null/undefined.');
+        }
+        this.languageProvider = languageProvider;
+    }
+    processTurn(events) {
+        const filtered = (0, filter_1.filterEvents)(events);
+        const sorted = (0, sort_1.sortEventsForProse)(filtered);
+        const context = {
+            languageProvider: this.languageProvider,
+        };
+        const blocks = [];
+        for (const event of sorted) {
+            blocks.push(...this.routeToHandler(event, context));
+        }
+        return blocks;
+    }
+    /**
+     * Route an event to its handler family.
+     *
+     * Order: try the ADR-097 messageId path first (catches every stdlib
+     * domain event); then fall through to type-keyed handlers; finally
+     * the catch-all generic handler.
+     */
+    routeToHandler(event, context) {
+        const messageIdResult = (0, domain_message_1.tryProcessDomainEventMessage)(event, context);
+        if (messageIdResult) {
+            return messageIdResult;
+        }
+        switch (event.type) {
+            case 'game.started':
+                return (0, game_1.handleGameStarted)(event, context);
+            case 'if.event.room_description':
+            case 'if.event.room.description':
+                return (0, room_1.handleRoomDescription)(event, context);
+            case 'game.message':
+                return (0, generic_1.handleGameMessage)(event, context);
+            case 'if.event.revealed':
+                return (0, revealed_1.handleRevealed)(event, context);
+            case 'if.event.help_displayed':
+                return (0, help_1.handleHelpDisplayed)(event, context);
+            case 'if.event.about_displayed':
+                return (0, about_1.handleAboutDisplayed)(event, context);
+            case 'sound.audibility.heard':
+                return (0, audibility_1.handleAudibilityHeard)(event, context);
+            case 'if.event.implicit_take':
+                return (0, implicit_take_1.handleImplicitTake)(event, context);
+            case 'command.failed':
+                return (0, command_failed_1.handleCommandFailed)(event, context);
+            case 'client.query':
+                return (0, client_query_1.handleClientQuery)(event, context);
+            default:
+                return (0, generic_1.handleGenericEvent)(event, context);
+        }
+    }
+}
+exports.ProsePipeline = ProsePipeline;
+/**
+ * Construct a `ProsePipeline` for the given language provider.
+ *
+ * Mirrors the `createTextService` factory the retired text-service
+ * package exposed; callers can swap one for the other without
+ * changing call shapes.
+ */
+function createProsePipeline(languageProvider) {
+    return new ProsePipeline(languageProvider);
+}
+//# sourceMappingURL=pipeline.js.map

package/prose-pipeline/pipeline.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline.js","sourceRoot":"","sources":["../../../../../../../repos/sharpee/packages/engine/src/prose-pipeline/pipeline.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;;;AA6HH,kDAIC;AA3HD,4CAA+C;AAC/C,wCAAmD;AAGnD,0CAAwD;AACxD,kDAAqD;AACrD,gDAG4B;AAC5B,0CAAoD;AACpD,0CAAsD;AACtD,4CAAwD;AACxD,sDAA8D;AAC9D,8DAAyE;AACzE,4DAA8D;AAC9D,8DAAgE;AAChE,0DAA4D;AAI5D;;;;;;;;GAQG;AACH,MAAa,aAAa;IACP,gBAAgB,CAAmB;IAEpD,YAAY,gBAAkC;QAC5C,IAAI,CAAC,gBAAgB,EAAE,CAAC;YACtB,MAAM,IAAI,KAAK,CACb,gEAAgE,CACjE,CAAC;QACJ,CAAC;QACD,IAAI,CAAC,gBAAgB,GAAG,gBAAgB,CAAC;IAC3C,CAAC;IAED,WAAW,CAAC,MAAwB;QAClC,MAAM,QAAQ,GAAG,IAAA,qBAAY,EAAC,MAAM,CAAC,CAAC;QACtC,MAAM,MAAM,GAAG,IAAA,yBAAkB,EAAC,QAAQ,CAAC,CAAC;QAE5C,MAAM,OAAO,GAAmB;YAC9B,gBAAgB,EAAE,IAAI,CAAC,gBAAgB;SACxC,CAAC;QAEF,MAAM,MAAM,GAAiB,EAAE,CAAC;QAChC,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YAC3B,MAAM,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,cAAc,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC;QACtD,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;;;;;OAMG;IACK,cAAc,CACpB,KAAqB,EACrB,OAAuB;QAEvB,MAAM,eAAe,GAAG,IAAA,6CAA4B,EAAC,KAAK,EAAE,OAAO,CAAC,CAAC;QACrE,IAAI,eAAe,EAAE,CAAC;YACpB,OAAO,eAAe,CAAC;QACzB,CAAC;QAED,QAAQ,KAAK,CAAC,IAAI,EAAE,CAAC;YACnB,KAAK,cAAc;gBACjB,OAAO,IAAA,wBAAiB,EAAC,KAAK,EAAE,OAAO,CAAC,CAAC;YAE3C,KAAK,2BAA2B,CAAC;YACjC,KAAK,2BAA2B;gBAC9B,OAAO,IAAA,4BAAqB,EAAC,KAAK,EAAE,OAAO,CAAC,CAAC;YAE/C,KAAK,cAAc;gBACjB,OAAO,IAAA,2BAAiB,EAAC,KAAK,EAAE,OAAO,CAAC,CAAC;YAE3C,KAAK,mBAAmB;gBACtB,OAAO,IAAA,yBAAc,EAAC,KAAK,EAAE,OAAO,CAAC,CAAC;YAExC,KAAK,yBAAyB;gBAC5B,OAAO,IAAA,0BAAmB,EAAC,KAAK,EAAE,OAAO,CAAC,CAAC;YAE7C,KAAK,0BAA0B;gBAC7B,OAAO,IAAA,4BAAoB,EAAC,KAAK,EAAE,OAAO,CAAC,CAAC;YAE9C,KAAK,wBAAwB;gBAC3B,OAAO,IAAA,kCAAqB,EAAC,KAAK,EAAE,OAAO,CAAC,CAAC;YAE/C,KAAK,wBAAwB;gBAC3B,OAAO,IAAA,kCAAkB,EAAC,KAAK,EAAE,OAAO,CAAC,CAAC;YAE5C,KAAK,gBAAgB;gBACnB,OAAO,IAAA,oCAAmB,EAAC,KAAK,EAAE,OAAO,CAAC,CAAC;YAE7C,KAAK,cAAc;gBACjB,OAAO,IAAA,gCAAiB,EAAC,KAAK,EAAE,OAAO,CAAC,CAAC;YAE3C;gBACE,OAAO,IAAA,4BAAkB,EAAC,KAAK,EAAE,OAAO,CAAC,CAAC;QAC9C,CAAC;IACH,CAAC;CACF;AAhFD,sCAgFC;AAED;;;;;;GAMG;AACH,SAAgB,mBAAmB,CACjC,gBAAkC;IAElC,OAAO,IAAI,aAAa,CAAC,gBAAgB,CAAC,CAAC;AAC7C,CAAC"}

package/prose-pipeline/stages/filter.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Event filtering stage — drops events that should not produce
+ * text output (system.* and platform.*).
+ *
+ * Public interface: `filterEvents`. Used internally by the prose
+ * pipeline as the first per-turn stage.
+ *
+ * Owner context: `@sharpee/engine` — internal prose pipeline.
+ *
+ * @see ADR-174 §Engine-internal prose pipeline
+ * @see ADR-096 (preserved): the filter responsibility ports unchanged
+ *   from `@sharpee/text-service`.
+ */
+import type { ISemanticEvent } from "../../../core/index";
+/**
+ * Filter events that should produce text output.
+ *
+ * Drops:
+ *  - `system.*` — internal turn-cycle bookkeeping the player never sees.
+ *  - `platform.*` — save/restore/quit/restart requests and completions.
+ *
+ * Pass-through for everything else (domain events, action results,
+ * lifecycle events, sound, etc.) — they reach the handlers stage.
+ */
+export declare function filterEvents(events: ISemanticEvent[]): ISemanticEvent[];
+//# sourceMappingURL=filter.d.ts.map

package/prose-pipeline/stages/filter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"filter.d.ts","sourceRoot":"","sources":["../../../../../../../repos/sharpee/packages/engine/src/prose-pipeline/stages/filter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAEpD;;;;;;;;;GASG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,cAAc,EAAE,GAAG,cAAc,EAAE,CAUvE"}

package/prose-pipeline/stages/filter.js

@@ -0,0 +1,38 @@
+"use strict";
+/**
+ * Event filtering stage — drops events that should not produce
+ * text output (system.* and platform.*).
+ *
+ * Public interface: `filterEvents`. Used internally by the prose
+ * pipeline as the first per-turn stage.
+ *
+ * Owner context: `@sharpee/engine` — internal prose pipeline.
+ *
+ * @see ADR-174 §Engine-internal prose pipeline
+ * @see ADR-096 (preserved): the filter responsibility ports unchanged
+ *   from `@sharpee/text-service`.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.filterEvents = filterEvents;
+/**
+ * Filter events that should produce text output.
+ *
+ * Drops:
+ *  - `system.*` — internal turn-cycle bookkeeping the player never sees.
+ *  - `platform.*` — save/restore/quit/restart requests and completions.
+ *
+ * Pass-through for everything else (domain events, action results,
+ * lifecycle events, sound, etc.) — they reach the handlers stage.
+ */
+function filterEvents(events) {
+    return events.filter((event) => {
+        if (event.type.startsWith('system.')) {
+            return false;
+        }
+        if (event.type.startsWith('platform.')) {
+            return false;
+        }
+        return true;
+    });
+}
+//# sourceMappingURL=filter.js.map

package/prose-pipeline/stages/filter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"filter.js","sourceRoot":"","sources":["../../../../../../../../repos/sharpee/packages/engine/src/prose-pipeline/stages/filter.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;GAYG;;AAcH,oCAUC;AApBD;;;;;;;;;GASG;AACH,SAAgB,YAAY,CAAC,MAAwB;IACnD,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE;QAC7B,IAAI,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;YACrC,OAAO,KAAK,CAAC;QACf,CAAC;QACD,IAAI,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;YACvC,OAAO,KAAK,CAAC;QACf,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC,CAAC,CAAC;AACL,CAAC"}

package/prose-pipeline/stages/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Prose pipeline stages — internal barrel.
+ *
+ * Public interface: re-exports `filterEvents`, `sortEventsForProse`,
+ * and `getChainMetadata`. Used by the pipeline class (sub-phase 1.5).
+ *
+ * Owner context: `@sharpee/engine` — internal prose pipeline.
+ *
+ * @see ADR-174 §Engine-internal prose pipeline
+ */
+export { filterEvents } from './filter';
+export { sortEventsForProse, getChainMetadata } from './sort';
+//# sourceMappingURL=index.d.ts.map

package/prose-pipeline/stages/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../../repos/sharpee/packages/engine/src/prose-pipeline/stages/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AACxC,OAAO,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,QAAQ,CAAC"}

package/prose-pipeline/stages/index.js

@@ -0,0 +1,19 @@
+"use strict";
+/**
+ * Prose pipeline stages — internal barrel.
+ *
+ * Public interface: re-exports `filterEvents`, `sortEventsForProse`,
+ * and `getChainMetadata`. Used by the pipeline class (sub-phase 1.5).
+ *
+ * Owner context: `@sharpee/engine` — internal prose pipeline.
+ *
+ * @see ADR-174 §Engine-internal prose pipeline
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getChainMetadata = exports.sortEventsForProse = exports.filterEvents = void 0;
+var filter_1 = require("./filter");
+Object.defineProperty(exports, "filterEvents", { enumerable: true, get: function () { return filter_1.filterEvents; } });
+var sort_1 = require("./sort");
+Object.defineProperty(exports, "sortEventsForProse", { enumerable: true, get: function () { return sort_1.sortEventsForProse; } });
+Object.defineProperty(exports, "getChainMetadata", { enumerable: true, get: function () { return sort_1.getChainMetadata; } });
+//# sourceMappingURL=index.js.map

package/prose-pipeline/stages/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../../../repos/sharpee/packages/engine/src/prose-pipeline/stages/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;GASG;;;AAEH,mCAAwC;AAA/B,sGAAA,YAAY,OAAA;AACrB,+BAA8D;AAArD,0GAAA,kBAAkB,OAAA;AAAE,wGAAA,gBAAgB,OAAA"}

package/prose-pipeline/stages/sort.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Event sorting stage — orders events within a turn for correct prose
+ * sequence: lifecycle first, then per-transaction implicit-take →
+ * room-description → action.* → others, finally by chain depth.
+ *
+ * Public interface: `sortEventsForProse`, `getChainMetadata`. Used
+ * internally by the prose pipeline as the second per-turn stage,
+ * after filtering.
+ *
+ * Owner context: `@sharpee/engine` — internal prose pipeline.
+ *
+ * @see ADR-094 Event Chaining (preserved; the sort responsibility
+ *   ports from `@sharpee/text-service`)
+ * @see ADR-174 §Engine-internal prose pipeline
+ */
+import type { ISemanticEvent } from "../../../core/index";
+/**
+ * Event data with chain metadata (ADR-094).
+ */
+interface ChainMetadata {
+    _transactionId?: string;
+    _chainDepth?: number;
+    _chainedFrom?: string;
+    _chainSourceId?: string;
+}
+/**
+ * Sort events for correct prose order within transactions.
+ *
+ * Stable sort — preserves cross-transaction order while applying
+ * within-transaction rules.
+ */
+export declare function sortEventsForProse(events: ISemanticEvent[]): ISemanticEvent[];
+/**
+ * Extract chain metadata from event data.
+ */
+export declare function getChainMetadata(event: ISemanticEvent): ChainMetadata;
+export {};
+//# sourceMappingURL=sort.d.ts.map

package/prose-pipeline/stages/sort.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sort.d.ts","sourceRoot":"","sources":["../../../../../../../repos/sharpee/packages/engine/src/prose-pipeline/stages/sort.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAEpD;;GAEG;AACH,UAAU,aAAa;IACrB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAUD;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,cAAc,EAAE,GAAG,cAAc,EAAE,CAgD7E;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,cAAc,GAAG,aAAa,CAQrE"}