@sharpee/engine 0.9.113 → 1.0.8

package/prose-pipeline/handlers/audibility.js

@@ -0,0 +1,79 @@
+"use strict";
+/**
+ * Audibility event handler — ADR-172 Phase 7a, ported to engine prose
+ * pipeline per ADR-174.
+ *
+ * Handles `sound.audibility.heard`. Converts each `IAudibilityEvent`
+ * (per-listener perception of a propagated sound, produced by the
+ * engine's sound dispatcher in Phase 6) into a single text block via
+ * the `sound.heard.<kind>.<tier>` template family registered in the
+ * active language pack (lang-en-us ships defaults; stories override
+ * per kind).
+ *
+ * Naming discipline:
+ *   - `audio`      — Web Audio playback (ADR-169 `AudioManager`).
+ *   - `sound`      — the media-cue channel id (`media.sound.play`,
+ *                    ADR-163).
+ *   - `audibility` — ADR-172 perception of propagated sound, this
+ *                    handler.
+ *
+ * Public interface: `handleAudibilityHeard`.
+ *
+ * Owner context: `@sharpee/engine` — internal prose pipeline.
+ *
+ * Listener filtering: in single-user scope today the player is the
+ * only entity carrying `ListenerTrait` automatically, so every
+ * audibility event delivered here is for the player. The dispatcher
+ * already writes the listener id into `event.entities.target`; when
+ * L2's NPC-listener work lands, this handler will need to filter
+ * `event.entities.target === playerId` before rendering.
+ *
+ * @see ADR-172 — Spatial Sound Propagation §Channel routing
+ * @see ADR-174 §Engine-internal prose pipeline (port from text-service)
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.handleAudibilityHeard = handleAudibilityHeard;
+const text_blocks_1 = require("@sharpee/text-blocks");
+const assemble_1 = require("../assemble");
+const AUDIBILITY_TEMPLATE_PREFIX = 'sound.heard';
+/**
+ * Handle a `sound.audibility.heard` event.
+ *
+ * Resolves `sound.heard.<kind>.<tier>` from the language provider,
+ * falling back to `sound.heard.default.<tier>` when the kind-specific
+ * template is not registered. Returns one `ITextBlock` per event, or
+ * `[]` when the event is malformed, the tier is `silent`, or no
+ * template resolves.
+ */
+function handleAudibilityHeard(event, context) {
+    const provider = context.languageProvider;
+    if (!provider)
+        return [];
+    const data = event.data;
+    if (!data || typeof data !== 'object')
+        return [];
+    if (!data.kind || !data.audibilityTier)
+        return [];
+    // Defense-in-depth: the dispatcher already filters `silent`, but
+    // never render it if one slips through.
+    if (data.audibilityTier === 'silent')
+        return [];
+    const params = {
+        kind: data.kind,
+    };
+    if (data.content?.messageId) {
+        const innerParams = data.content.params;
+        params.content = provider.getMessage(data.content.messageId, innerParams);
+    }
+    const kindId = `${AUDIBILITY_TEMPLATE_PREFIX}.${data.kind}.${data.audibilityTier}`;
+    let message = provider.getMessage(kindId, params);
+    if (!message || message === kindId) {
+        const fallbackId = `${AUDIBILITY_TEMPLATE_PREFIX}.default.${data.audibilityTier}`;
+        message = provider.getMessage(fallbackId, params);
+        if (!message || message === fallbackId) {
+            return [];
+        }
+    }
+    return (0, assemble_1.createBlocks)(text_blocks_1.BLOCK_KEYS.ACTION_RESULT, message);
+}
+//# sourceMappingURL=audibility.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"audibility.js","sourceRoot":"","sources":["../../../../../../../../repos/sharpee/packages/engine/src/prose-pipeline/handlers/audibility.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;;AAoBH,sDAoCC;AArDD,sDAAkD;AAIlD,0CAA2C;AAE3C,MAAM,0BAA0B,GAAG,aAAa,CAAC;AAEjD;;;;;;;;GAQG;AACH,SAAgB,qBAAqB,CACnC,KAAqB,EACrB,OAAuB;IAEvB,MAAM,QAAQ,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAC1C,IAAI,CAAC,QAAQ;QAAE,OAAO,EAAE,CAAC;IAEzB,MAAM,IAAI,GAAG,KAAK,CAAC,IAAoC,CAAC;IACxD,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ;QAAE,OAAO,EAAE,CAAC;IACjD,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,cAAc;QAAE,OAAO,EAAE,CAAC;IAElD,iEAAiE;IACjE,wCAAwC;IACxC,IAAK,IAAI,CAAC,cAAyB,KAAK,QAAQ;QAAE,OAAO,EAAE,CAAC;IAE5D,MAAM,MAAM,GAA4B;QACtC,IAAI,EAAE,IAAI,CAAC,IAAI;KAChB,CAAC;IACF,IAAI,IAAI,CAAC,OAAO,EAAE,SAAS,EAAE,CAAC;QAC5B,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,MAEpB,CAAC;QACd,MAAM,CAAC,OAAO,GAAG,QAAQ,CAAC,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;IAC5E,CAAC;IAED,MAAM,MAAM,GAAG,GAAG,0BAA0B,IAAI,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC;IACnF,IAAI,OAAO,GAAG,QAAQ,CAAC,UAAU,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClD,IAAI,CAAC,OAAO,IAAI,OAAO,KAAK,MAAM,EAAE,CAAC;QACnC,MAAM,UAAU,GAAG,GAAG,0BAA0B,YAAY,IAAI,CAAC,cAAc,EAAE,CAAC;QAClF,OAAO,GAAG,QAAQ,CAAC,UAAU,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;QAClD,IAAI,CAAC,OAAO,IAAI,OAAO,KAAK,UAAU,EAAE,CAAC;YACvC,OAAO,EAAE,CAAC;QACZ,CAAC;IACH,CAAC;IAED,OAAO,IAAA,uBAAY,EAAC,wBAAU,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC;AACzD,CAAC"}

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

@@ -0,0 +1,44 @@
+/**
+ * Shared banner-block builder.
+ *
+ * Emits the opening banner as a sequence of semantically-classed
+ * blocks. Used by both `handleGameStarted` and `handleAboutDisplayed`
+ * so the banner shown at game-start and via the ABOUT command are
+ * structurally identical.
+ *
+ * Pieces (in order):
+ *
+ *  1. `game-title`         — title
+ *  2. `story-version`      — `Story v{version}` + optional build date
+ *  3. `platform-version`   — `Sharpee v{engineVersion}` (if provided)
+ *  4. `sub-title`          — description (if provided)
+ *  5. `author-list[]`      — `credits` if provided, else single
+ *                            `By {author}` line if `author` is set
+ *  6. `banner-spacer`      — empty `<p>` for visual separation
+ *  7. story-tail           — appended via `createBlocks` from
+ *                            `game.banner.story-tail` if the language
+ *                            provider has that template
+ *
+ * Owner context: `@sharpee/engine` — internal prose pipeline.
+ */
+import type { ITextBlock } from '@sharpee/text-blocks';
+import type { HandlerContext } from './types';
+/**
+ * Subset of story metadata used by the banner builder.
+ * Both `handleGameStarted` (`event.data.story`) and
+ * `handleAboutDisplayed` (`event.data.params`) project into this shape.
+ */
+export interface BannerStoryInfo {
+    title?: string;
+    version?: string;
+    buildDate?: string;
+    description?: string;
+    author?: string;
+    credits?: string[];
+}
+/**
+ * Build the structured banner blocks for a `key` (typically
+ * `'game.banner'` from `game.started` or `'about.text'` from ABOUT).
+ */
+export declare function buildBannerBlocks(key: string, story: BannerStoryInfo | undefined, engineVersion: string | undefined, context: HandlerContext): ITextBlock[];
+//# sourceMappingURL=banner.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"banner.d.ts","sourceRoot":"","sources":["../../../../../../../../repos/sharpee/packages/engine/src/prose-pipeline/handlers/banner.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAEvD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAI9C;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,eAAe,GAAG,SAAS,EAClC,aAAa,EAAE,MAAM,GAAG,SAAS,EACjC,OAAO,EAAE,cAAc,GACtB,UAAU,EAAE,CAmDd"}

package/prose-pipeline/handlers/banner.js

@@ -0,0 +1,88 @@
+"use strict";
+/**
+ * Shared banner-block builder.
+ *
+ * Emits the opening banner as a sequence of semantically-classed
+ * blocks. Used by both `handleGameStarted` and `handleAboutDisplayed`
+ * so the banner shown at game-start and via the ABOUT command are
+ * structurally identical.
+ *
+ * Pieces (in order):
+ *
+ *  1. `game-title`         — title
+ *  2. `story-version`      — `Story v{version}` + optional build date
+ *  3. `platform-version`   — `Sharpee v{engineVersion}` (if provided)
+ *  4. `sub-title`          — description (if provided)
+ *  5. `author-list[]`      — `credits` if provided, else single
+ *                            `By {author}` line if `author` is set
+ *  6. `banner-spacer`      — empty `<p>` for visual separation
+ *  7. story-tail           — appended via `createBlocks` from
+ *                            `game.banner.story-tail` if the language
+ *                            provider has that template
+ *
+ * Owner context: `@sharpee/engine` — internal prose pipeline.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildBannerBlocks = buildBannerBlocks;
+const assemble_1 = require("../assemble");
+const STORY_TAIL_MESSAGE_ID = 'game.banner.story-tail';
+/**
+ * Build the structured banner blocks for a `key` (typically
+ * `'game.banner'` from `game.started` or `'about.text'` from ABOUT).
+ */
+function buildBannerBlocks(key, story, engineVersion, context) {
+    if (!story)
+        return [];
+    const blocks = [];
+    if (story.title) {
+        blocks.push((0, assemble_1.createBlock)(key, story.title, { className: 'game-title' }));
+    }
+    if (story.version) {
+        const buildDate = formatBuildDate(story.buildDate);
+        const versionText = buildDate
+            ? `Story v${story.version} (built ${buildDate})`
+            : `Story v${story.version}`;
+        blocks.push((0, assemble_1.createBlock)(key, versionText, { className: 'story-version' }));
+    }
+    if (engineVersion) {
+        blocks.push((0, assemble_1.createBlock)(key, `Sharpee v${engineVersion}`, {
+            className: 'platform-version',
+        }));
+    }
+    if (story.description) {
+        blocks.push((0, assemble_1.createBlock)(key, story.description, { className: 'sub-title' }));
+    }
+    const creditLines = story.credits && story.credits.length > 0
+        ? story.credits
+        : story.author
+            ? [`By ${story.author}`]
+            : [];
+    for (const line of creditLines) {
+        blocks.push((0, assemble_1.createBlock)(key, line, { className: 'author-list' }));
+    }
+    if (blocks.length > 0) {
+        blocks.push((0, assemble_1.createBlock)(key, '', { className: 'banner-spacer' }));
+    }
+    const tail = context.languageProvider?.getMessage(STORY_TAIL_MESSAGE_ID, {});
+    if (tail && tail !== STORY_TAIL_MESSAGE_ID) {
+        blocks.push(...(0, assemble_1.createBlocks)(key, tail));
+    }
+    return blocks;
+}
+/**
+ * Format an ISO build date as `YYYY-MM-DD` for the version line.
+ * Returns the original string if it doesn't parse cleanly, or empty
+ * when missing.
+ */
+function formatBuildDate(buildDate) {
+    if (!buildDate)
+        return '';
+    try {
+        const iso = new Date(buildDate).toISOString();
+        return iso.split('T')[0];
+    }
+    catch {
+        return buildDate;
+    }
+}
+//# sourceMappingURL=banner.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"banner.js","sourceRoot":"","sources":["../../../../../../../../repos/sharpee/packages/engine/src/prose-pipeline/handlers/banner.ts"],"names":[],"mappings":"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"}

package/prose-pipeline/handlers/client-query.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Client-query handler — `client.query`.
+ *
+ * Today only the `disambiguation` source is rendered. The handler
+ * formats a candidate list as natural English ("the X or the Y" /
+ * "the X, the Y, or the Z") and resolves the
+ * `core.disambiguation_prompt` template with the resulting `options`
+ * string.
+ *
+ * Public interface: `handleClientQuery`. Used by the pipeline's
+ * event-type dispatch.
+ *
+ * Owner context: `@sharpee/engine` — internal prose pipeline.
+ *
+ * @see ADR-174 §Engine-internal prose pipeline (extracted from
+ *   text-service.ts inline)
+ */
+import type { ITextBlock } from '@sharpee/text-blocks';
+import type { ISemanticEvent } from '@sharpee/core';
+import type { HandlerContext } from './types';
+export declare function handleClientQuery(event: ISemanticEvent, context: HandlerContext): ITextBlock[];
+//# sourceMappingURL=client-query.d.ts.map

package/prose-pipeline/handlers/client-query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client-query.d.ts","sourceRoot":"","sources":["../../../../../../../../repos/sharpee/packages/engine/src/prose-pipeline/handlers/client-query.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAEvD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAU9C,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,cAAc,EACrB,OAAO,EAAE,cAAc,GACtB,UAAU,EAAE,CAgBd"}

package/prose-pipeline/handlers/client-query.js

@@ -0,0 +1,55 @@
+"use strict";
+/**
+ * Client-query handler — `client.query`.
+ *
+ * Today only the `disambiguation` source is rendered. The handler
+ * formats a candidate list as natural English ("the X or the Y" /
+ * "the X, the Y, or the Z") and resolves the
+ * `core.disambiguation_prompt` template with the resulting `options`
+ * string.
+ *
+ * Public interface: `handleClientQuery`. Used by the pipeline's
+ * event-type dispatch.
+ *
+ * Owner context: `@sharpee/engine` — internal prose pipeline.
+ *
+ * @see ADR-174 §Engine-internal prose pipeline (extracted from
+ *   text-service.ts inline)
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.handleClientQuery = handleClientQuery;
+const text_blocks_1 = require("@sharpee/text-blocks");
+const assemble_1 = require("../assemble");
+function handleClientQuery(event, context) {
+    const data = event.data;
+    if (data?.source !== 'disambiguation') {
+        return [];
+    }
+    const candidateNames = (data.candidates || []).map((c) => c.name);
+    const options = formatCandidateList(candidateNames);
+    const message = context.languageProvider?.getMessage('core.disambiguation_prompt', {
+        options,
+    }) ?? `Which do you mean: ${options}?`;
+    return (0, assemble_1.createBlocks)(text_blocks_1.BLOCK_KEYS.ERROR, message);
+}
+/**
+ * Format a list of candidate names as natural English.
+ *
+ * Examples:
+ *   ["red ball", "blue ball"]            → "the red ball or the blue ball"
+ *   ["sword", "axe", "knife"]            → "the sword, the axe, or the knife"
+ */
+function formatCandidateList(names) {
+    if (names.length === 0)
+        return '';
+    if (names.length === 1)
+        return `the ${names[0]}`;
+    const withArticles = names.map((n) => `the ${n}`);
+    if (withArticles.length === 2) {
+        return `${withArticles[0]} or ${withArticles[1]}`;
+    }
+    // Oxford-comma style: "the X, the Y, or the Z"
+    const last = withArticles.pop();
+    return `${withArticles.join(', ')}, or ${last}`;
+}
+//# sourceMappingURL=client-query.js.map

package/prose-pipeline/handlers/client-query.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client-query.js","sourceRoot":"","sources":["../../../../../../../../repos/sharpee/packages/engine/src/prose-pipeline/handlers/client-query.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;GAgBG;;AAeH,8CAmBC;AA/BD,sDAAkD;AAGlD,0CAA2C;AAS3C,SAAgB,iBAAiB,CAC/B,KAAqB,EACrB,OAAuB;IAEvB,MAAM,IAAI,GAAG,KAAK,CAAC,IAAuB,CAAC;IAE3C,IAAI,IAAI,EAAE,MAAM,KAAK,gBAAgB,EAAE,CAAC;QACtC,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,cAAc,GAAG,CAAC,IAAI,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IAClE,MAAM,OAAO,GAAG,mBAAmB,CAAC,cAAc,CAAC,CAAC;IAEpD,MAAM,OAAO,GACX,OAAO,CAAC,gBAAgB,EAAE,UAAU,CAAC,4BAA4B,EAAE;QACjE,OAAO;KACR,CAAC,IAAI,sBAAsB,OAAO,GAAG,CAAC;IAEzC,OAAO,IAAA,uBAAY,EAAC,wBAAU,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;AACjD,CAAC;AAED;;;;;;GAMG;AACH,SAAS,mBAAmB,CAAC,KAAe;IAC1C,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAClC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,OAAO,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;IAEjD,MAAM,YAAY,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IAElD,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC9B,OAAO,GAAG,YAAY,CAAC,CAAC,CAAC,OAAO,YAAY,CAAC,CAAC,CAAC,EAAE,CAAC;IACpD,CAAC;IAED,+CAA+C;IAC/C,MAAM,IAAI,GAAG,YAAY,CAAC,GAAG,EAAE,CAAC;IAChC,OAAO,GAAG,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,IAAI,EAAE,CAAC;AAClD,CAAC"}

package/prose-pipeline/handlers/command-failed.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Command-failed handler — `command.failed`.
+ *
+ * Maps parser / entity-resolution failure reasons to user-facing
+ * error prose. Recognized reason fragments:
+ *   - `ENTITY_NOT_FOUND` / `modifiers_not_matched` →
+ *     `core.entity_not_found` (default: "I don't see that here.")
+ *   - `NO_MATCH` / `parse` →
+ *     `core.command_not_understood` (default: "I don't understand that.")
+ * Anything else → `core.command_failed` (same default).
+ *
+ * Public interface: `handleCommandFailed`. Used by the pipeline's
+ * event-type dispatch.
+ *
+ * Owner context: `@sharpee/engine` — internal prose pipeline.
+ *
+ * @see ADR-174 §Engine-internal prose pipeline (extracted from
+ *   text-service.ts inline)
+ */
+import type { ITextBlock } from '@sharpee/text-blocks';
+import type { ISemanticEvent } from '@sharpee/core';
+import type { HandlerContext } from './types';
+export declare function handleCommandFailed(event: ISemanticEvent, context: HandlerContext): ITextBlock[];
+//# sourceMappingURL=command-failed.d.ts.map

package/prose-pipeline/handlers/command-failed.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-failed.d.ts","sourceRoot":"","sources":["../../../../../../../../repos/sharpee/packages/engine/src/prose-pipeline/handlers/command-failed.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAEvD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAQ9C,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,cAAc,EACrB,OAAO,EAAE,cAAc,GACtB,UAAU,EAAE,CA6Bd"}

package/prose-pipeline/handlers/command-failed.js

@@ -0,0 +1,46 @@
+"use strict";
+/**
+ * Command-failed handler — `command.failed`.
+ *
+ * Maps parser / entity-resolution failure reasons to user-facing
+ * error prose. Recognized reason fragments:
+ *   - `ENTITY_NOT_FOUND` / `modifiers_not_matched` →
+ *     `core.entity_not_found` (default: "I don't see that here.")
+ *   - `NO_MATCH` / `parse` →
+ *     `core.command_not_understood` (default: "I don't understand that.")
+ * Anything else → `core.command_failed` (same default).
+ *
+ * Public interface: `handleCommandFailed`. Used by the pipeline's
+ * event-type dispatch.
+ *
+ * Owner context: `@sharpee/engine` — internal prose pipeline.
+ *
+ * @see ADR-174 §Engine-internal prose pipeline (extracted from
+ *   text-service.ts inline)
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.handleCommandFailed = handleCommandFailed;
+const text_blocks_1 = require("@sharpee/text-blocks");
+const assemble_1 = require("../assemble");
+function handleCommandFailed(event, context) {
+    const data = event.data;
+    const provider = context.languageProvider;
+    if (data?.reason) {
+        if (data.reason.includes('ENTITY_NOT_FOUND') ||
+            data.reason.includes('modifiers_not_matched')) {
+            const message = provider?.getMessage('core.entity_not_found') ??
+                "I don't see that here.";
+            return (0, assemble_1.createBlocks)(text_blocks_1.BLOCK_KEYS.ERROR, message);
+        }
+        // AMBIGUOUS_ENTITY now uses client.query event, not command.failed.
+        if (data.reason.includes('NO_MATCH') || data.reason.includes('parse')) {
+            const message = provider?.getMessage('core.command_not_understood') ??
+                "I don't understand that.";
+            return (0, assemble_1.createBlocks)(text_blocks_1.BLOCK_KEYS.ERROR, message);
+        }
+    }
+    const message = provider?.getMessage('core.command_failed') ??
+        "I don't understand that.";
+    return (0, assemble_1.createBlocks)(text_blocks_1.BLOCK_KEYS.ERROR, message);
+}
+//# sourceMappingURL=command-failed.js.map

package/prose-pipeline/handlers/command-failed.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-failed.js","sourceRoot":"","sources":["../../../../../../../../repos/sharpee/packages/engine/src/prose-pipeline/handlers/command-failed.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;GAkBG;;AAaH,kDAgCC;AA1CD,sDAAkD;AAGlD,0CAA2C;AAO3C,SAAgB,mBAAmB,CACjC,KAAqB,EACrB,OAAuB;IAEvB,MAAM,IAAI,GAAG,KAAK,CAAC,IAAyB,CAAC;IAC7C,MAAM,QAAQ,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAE1C,IAAI,IAAI,EAAE,MAAM,EAAE,CAAC;QACjB,IACE,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,kBAAkB,CAAC;YACxC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,uBAAuB,CAAC,EAC7C,CAAC;YACD,MAAM,OAAO,GACX,QAAQ,EAAE,UAAU,CAAC,uBAAuB,CAAC;gBAC7C,wBAAwB,CAAC;YAC3B,OAAO,IAAA,uBAAY,EAAC,wBAAU,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;QACjD,CAAC;QAED,oEAAoE;QAEpE,IAAI,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;YACtE,MAAM,OAAO,GACX,QAAQ,EAAE,UAAU,CAAC,6BAA6B,CAAC;gBACnD,0BAA0B,CAAC;YAC7B,OAAO,IAAA,uBAAY,EAAC,wBAAU,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;QACjD,CAAC;IACH,CAAC;IAED,MAAM,OAAO,GACX,QAAQ,EAAE,UAAU,CAAC,qBAAqB,CAAC;QAC3C,0BAA0B,CAAC;IAC7B,OAAO,IAAA,uBAAY,EAAC,wBAAU,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;AACjD,CAAC"}

package/prose-pipeline/handlers/domain-message.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Domain message handler — `event.data.messageId` resolution path.
+ *
+ * Handles any event whose data carries a `messageId`, regardless of
+ * event type (per ADR-097). All stdlib actions use this pattern;
+ * story actions emitting `action.success` / `action.blocked` events
+ * also flow through here.
+ *
+ * Public interface: `tryProcessDomainEventMessage`. The pipeline
+ * consults this first; on null, it falls through to the type-keyed
+ * handlers (room, revealed, generic, etc.).
+ *
+ * Owner context: `@sharpee/engine` — internal prose pipeline.
+ *
+ * @see ADR-097 Domain Events with messageId
+ * @see ADR-174 §Engine-internal prose pipeline (extracted from
+ *   text-service.ts inline)
+ */
+import type { ITextBlock } from '@sharpee/text-blocks';
+import type { ISemanticEvent } from '@sharpee/core';
+import type { HandlerContext } from './types';
+/**
+ * Process domain events that carry messageId directly (ADR-097).
+ *
+ * @returns Text blocks if event has messageId. Returns null when the
+ *   event has no messageId (caller falls through to type-keyed
+ *   handlers). Falls back to inline `data.message` / `data.text`
+ *   when the messageId fails to resolve.
+ */
+export declare function tryProcessDomainEventMessage(event: ISemanticEvent, context: HandlerContext): ITextBlock[] | null;
+//# sourceMappingURL=domain-message.d.ts.map

package/prose-pipeline/handlers/domain-message.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"domain-message.d.ts","sourceRoot":"","sources":["../../../../../../../../repos/sharpee/packages/engine/src/prose-pipeline/handlers/domain-message.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAEvD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAU9C;;;;;;;GAOG;AACH,wBAAgB,4BAA4B,CAC1C,KAAK,EAAE,cAAc,EACrB,OAAO,EAAE,cAAc,GACtB,UAAU,EAAE,GAAG,IAAI,CA4CrB"}

package/prose-pipeline/handlers/domain-message.js

@@ -0,0 +1,66 @@
+"use strict";
+/**
+ * Domain message handler — `event.data.messageId` resolution path.
+ *
+ * Handles any event whose data carries a `messageId`, regardless of
+ * event type (per ADR-097). All stdlib actions use this pattern;
+ * story actions emitting `action.success` / `action.blocked` events
+ * also flow through here.
+ *
+ * Public interface: `tryProcessDomainEventMessage`. The pipeline
+ * consults this first; on null, it falls through to the type-keyed
+ * handlers (room, revealed, generic, etc.).
+ *
+ * Owner context: `@sharpee/engine` — internal prose pipeline.
+ *
+ * @see ADR-097 Domain Events with messageId
+ * @see ADR-174 §Engine-internal prose pipeline (extracted from
+ *   text-service.ts inline)
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.tryProcessDomainEventMessage = tryProcessDomainEventMessage;
+const text_blocks_1 = require("@sharpee/text-blocks");
+const assemble_1 = require("../assemble");
+/**
+ * Process domain events that carry messageId directly (ADR-097).
+ *
+ * @returns Text blocks if event has messageId. Returns null when the
+ *   event has no messageId (caller falls through to type-keyed
+ *   handlers). Falls back to inline `data.message` / `data.text`
+ *   when the messageId fails to resolve.
+ */
+function tryProcessDomainEventMessage(event, context) {
+    const data = event.data;
+    if (!data?.messageId) {
+        return null;
+    }
+    // Skip client.query — it needs specialized handling (disambiguation
+    // builds options from candidates).
+    if (event.type === 'client.query') {
+        return null;
+    }
+    if (!context.languageProvider) {
+        return null;
+    }
+    const message = context.languageProvider.getMessage(data.messageId, data.params);
+    // If the messageId echoes (not registered) or resolves to empty,
+    // fall back to inline text. Many events carry both a messageId and
+    // pre-rendered text (melee combat, GDT, etc.).
+    if (message === data.messageId || !message) {
+        const fallback = data.message ?? data.text;
+        if (typeof fallback === 'string' && fallback) {
+            return (0, assemble_1.createBlocks)(text_blocks_1.BLOCK_KEYS.ACTION_RESULT, fallback);
+        }
+        // No inline text — skip silently rather than showing an error.
+        // Domain events (if.event.*) carry messageId for semantic
+        // association, not for text rendering. Actual prose comes from
+        // game.message events.
+        return null;
+    }
+    // Block key chosen by event-type semantics.
+    const blockKey = event.type.includes('blocked') || event.type.includes('failure')
+        ? text_blocks_1.BLOCK_KEYS.ACTION_BLOCKED
+        : text_blocks_1.BLOCK_KEYS.ACTION_RESULT;
+    return (0, assemble_1.createBlocks)(blockKey, message);
+}
+//# sourceMappingURL=domain-message.js.map

package/prose-pipeline/handlers/domain-message.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"domain-message.js","sourceRoot":"","sources":["../../../../../../../../repos/sharpee/packages/engine/src/prose-pipeline/handlers/domain-message.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;GAiBG;;AAuBH,oEA+CC;AAnED,sDAAkD;AAGlD,0CAA2C;AAS3C;;;;;;;GAOG;AACH,SAAgB,4BAA4B,CAC1C,KAAqB,EACrB,OAAuB;IAEvB,MAAM,IAAI,GAAG,KAAK,CAAC,IAAqC,CAAC;IAEzD,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,CAAC;QACrB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,oEAAoE;IACpE,mCAAmC;IACnC,IAAI,KAAK,CAAC,IAAI,KAAK,cAAc,EAAE,CAAC;QAClC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,CAAC,OAAO,CAAC,gBAAgB,EAAE,CAAC;QAC9B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,OAAO,GAAG,OAAO,CAAC,gBAAgB,CAAC,UAAU,CACjD,IAAI,CAAC,SAAS,EACd,IAAI,CAAC,MAAM,CACZ,CAAC;IAEF,iEAAiE;IACjE,mEAAmE;IACnE,+CAA+C;IAC/C,IAAI,OAAO,KAAK,IAAI,CAAC,SAAS,IAAI,CAAC,OAAO,EAAE,CAAC;QAC3C,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,IAAI,CAAC;QAC3C,IAAI,OAAO,QAAQ,KAAK,QAAQ,IAAI,QAAQ,EAAE,CAAC;YAC7C,OAAO,IAAA,uBAAY,EAAC,wBAAU,CAAC,aAAa,EAAE,QAAQ,CAAC,CAAC;QAC1D,CAAC;QACD,+DAA+D;QAC/D,0DAA0D;QAC1D,+DAA+D;QAC/D,uBAAuB;QACvB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,4CAA4C;IAC5C,MAAM,QAAQ,GACZ,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC;QAC9D,CAAC,CAAC,wBAAU,CAAC,cAAc;QAC3B,CAAC,CAAC,wBAAU,CAAC,aAAa,CAAC;IAE/B,OAAO,IAAA,uBAAY,EAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;AACzC,CAAC"}

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

@@ -0,0 +1,31 @@
+/**
+ * Game lifecycle event handler — `game.started`.
+ *
+ * Emits the opening banner via the shared `buildBannerBlocks` helper:
+ * one semantically-classed block per piece (`game-title`,
+ * `story-version`, `platform-version`, `sub-title`, `author-list[]`,
+ * `banner-spacer`), then any story-defined `game.banner.story-tail`
+ * template appended through `createBlocks`.
+ *
+ * Public interface: `handleGameStarted`. Used by the pipeline's
+ * event-type dispatch.
+ *
+ * Owner context: `@sharpee/engine` — internal prose pipeline.
+ *
+ * @see ADR-097 IGameEvent Deprecation
+ * @see ADR-174 §Engine-internal prose pipeline (port from text-service)
+ */
+import type { ITextBlock } from '@sharpee/text-blocks';
+import type { ISemanticEvent } from '@sharpee/core';
+import type { HandlerContext } from './types';
+/**
+ * Handle the `game.started` event to produce the opening banner.
+ *
+ * Stories customize by:
+ *  - Setting `StoryConfig.credits` for distinct author-list lines.
+ *  - Setting `StoryConfig.description` for the sub-title.
+ *  - Registering a `game.banner.story-tail` language template for any
+ *    trailing content (instructions, taglines, etc.).
+ */
+export declare function handleGameStarted(event: ISemanticEvent, context: HandlerContext): ITextBlock[];
+//# sourceMappingURL=game.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"game.d.ts","sourceRoot":"","sources":["../../../../../../../../repos/sharpee/packages/engine/src/prose-pipeline/handlers/game.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,KAAK,EAAE,cAAc,EAA4B,MAAM,eAAe,CAAC;AAC9E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAG9C;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,cAAc,EACrB,OAAO,EAAE,cAAc,GACtB,UAAU,EAAE,CAQd"}

package/prose-pipeline/handlers/game.js

@@ -0,0 +1,35 @@
+"use strict";
+/**
+ * Game lifecycle event handler — `game.started`.
+ *
+ * Emits the opening banner via the shared `buildBannerBlocks` helper:
+ * one semantically-classed block per piece (`game-title`,
+ * `story-version`, `platform-version`, `sub-title`, `author-list[]`,
+ * `banner-spacer`), then any story-defined `game.banner.story-tail`
+ * template appended through `createBlocks`.
+ *
+ * Public interface: `handleGameStarted`. Used by the pipeline's
+ * event-type dispatch.
+ *
+ * Owner context: `@sharpee/engine` — internal prose pipeline.
+ *
+ * @see ADR-097 IGameEvent Deprecation
+ * @see ADR-174 §Engine-internal prose pipeline (port from text-service)
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.handleGameStarted = handleGameStarted;
+const banner_1 = require("./banner");
+/**
+ * Handle the `game.started` event to produce the opening banner.
+ *
+ * Stories customize by:
+ *  - Setting `StoryConfig.credits` for distinct author-list lines.
+ *  - Setting `StoryConfig.description` for the sub-title.
+ *  - Registering a `game.banner.story-tail` language template for any
+ *    trailing content (instructions, taglines, etc.).
+ */
+function handleGameStarted(event, context) {
+    const data = event.data;
+    return (0, banner_1.buildBannerBlocks)('game.banner', data?.story, data?.engineVersion, context);
+}
+//# sourceMappingURL=game.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"game.js","sourceRoot":"","sources":["../../../../../../../../repos/sharpee/packages/engine/src/prose-pipeline/handlers/game.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;GAgBG;;AAgBH,8CAWC;AAtBD,qCAA6C;AAE7C;;;;;;;;GAQG;AACH,SAAgB,iBAAiB,CAC/B,KAAqB,EACrB,OAAuB;IAEvB,MAAM,IAAI,GAAG,KAAK,CAAC,IAAgC,CAAC;IACpD,OAAO,IAAA,0BAAiB,EACtB,aAAa,EACb,IAAI,EAAE,KAAK,EACX,IAAI,EAAE,aAAa,EACnB,OAAO,CACR,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,27 @@
+/**
+ * Generic event handlers — game.message and the catch-all generic
+ * fallback for unknown event types.
+ *
+ * Public interface: `handleGameMessage`, `handleGenericEvent`. Used
+ * by the pipeline's event-type dispatch.
+ *
+ * Owner context: `@sharpee/engine` — internal prose pipeline.
+ *
+ * @see ADR-174 §Engine-internal prose pipeline (port from text-service)
+ */
+import type { ITextBlock } from '@sharpee/text-blocks';
+import type { ISemanticEvent } from '@sharpee/core';
+import type { HandlerContext } from './types';
+/**
+ * Handle `game.message` events.
+ */
+export declare function handleGameMessage(event: ISemanticEvent, context: HandlerContext): ITextBlock[];
+/**
+ * Handle generic / unknown events using `event.type` as the template key.
+ *
+ * Story-defined events follow the simple pattern:
+ *   - event.type is the template key
+ *   - event.data is the template params
+ */
+export declare function handleGenericEvent(event: ISemanticEvent, context: HandlerContext): ITextBlock[];
+//# sourceMappingURL=generic.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"generic.d.ts","sourceRoot":"","sources":["../../../../../../../../repos/sharpee/packages/engine/src/prose-pipeline/handlers/generic.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAEvD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,KAAK,EAAE,cAAc,EAAoB,MAAM,SAAS,CAAC;AAUhE;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,cAAc,EACrB,OAAO,EAAE,cAAc,GACtB,UAAU,EAAE,CAmBd;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,cAAc,EACrB,OAAO,EAAE,cAAc,GACtB,UAAU,EAAE,CAiCd"}