@sharpee/engine 0.9.111 → 1.0.0

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("../../../text-blocks/index.js");
+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 "../../../text-blocks/index";
+import type { ISemanticEvent } from "../../../core/index";
+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("../../../text-blocks/index.js");
+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 "../../../text-blocks/index";
+import type { ISemanticEvent } from "../../../core/index";
+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 "../../../text-blocks/index";
+import type { ISemanticEvent } from "../../../core/index";
+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"}

package/prose-pipeline/handlers/generic.js

@@ -0,0 +1,67 @@
+"use strict";
+/**
+ * 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)
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.handleGameMessage = handleGameMessage;
+exports.handleGenericEvent = handleGenericEvent;
+const text_blocks_1 = require("../../../text-blocks/index.js");
+const assemble_1 = require("../assemble");
+/**
+ * Handle `game.message` events.
+ */
+function handleGameMessage(event, context) {
+    const data = event.data;
+    if (data.messageId && context.languageProvider) {
+        const message = context.languageProvider.getMessage(data.messageId, data.params);
+        if (message && message !== data.messageId) {
+            return (0, assemble_1.createBlocks)(text_blocks_1.BLOCK_KEYS.GAME_MESSAGE, message);
+        }
+    }
+    const text = data.text ?? data.message;
+    if (text) {
+        return (0, assemble_1.createBlocks)(text_blocks_1.BLOCK_KEYS.GAME_MESSAGE, text);
+    }
+    return [];
+}
+/**
+ * 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
+ */
+function handleGenericEvent(event, context) {
+    const data = event.data;
+    if (!data) {
+        return [];
+    }
+    if (data.message || data.text) {
+        const text = data.message ?? data.text ?? '';
+        if (text) {
+            return (0, assemble_1.createBlocks)(text_blocks_1.BLOCK_KEYS.ACTION_RESULT, text);
+        }
+    }
+    if (context.languageProvider) {
+        const message = context.languageProvider.getMessage(event.type, data);
+        if (message && message !== event.type) {
+            return (0, assemble_1.createBlocks)(text_blocks_1.BLOCK_KEYS.ACTION_RESULT, message);
+        }
+        if (data.messageId) {
+            const msgFromId = context.languageProvider.getMessage(data.messageId, data);
+            if (msgFromId && msgFromId !== data.messageId) {
+                return (0, assemble_1.createBlocks)(text_blocks_1.BLOCK_KEYS.ACTION_RESULT, msgFromId);
+            }
+        }
+    }
+    return [];
+}
+//# sourceMappingURL=generic.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"generic.js","sourceRoot":"","sources":["../../../../../../../../repos/sharpee/packages/engine/src/prose-pipeline/handlers/generic.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;GAUG;;AAkBH,8CAsBC;AASD,gDAoCC;AAlFD,sDAAkD;AAGlD,0CAA2C;AAS3C;;GAEG;AACH,SAAgB,iBAAiB,CAC/B,KAAqB,EACrB,OAAuB;IAEvB,MAAM,IAAI,GAAG,KAAK,CAAC,IAAuB,CAAC;IAE3C,IAAI,IAAI,CAAC,SAAS,IAAI,OAAO,CAAC,gBAAgB,EAAE,CAAC;QAC/C,MAAM,OAAO,GAAG,OAAO,CAAC,gBAAgB,CAAC,UAAU,CACjD,IAAI,CAAC,SAAS,EACd,IAAI,CAAC,MAAM,CACZ,CAAC;QACF,IAAI,OAAO,IAAI,OAAO,KAAK,IAAI,CAAC,SAAS,EAAE,CAAC;YAC1C,OAAO,IAAA,uBAAY,EAAC,wBAAU,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;QACxD,CAAC;IACH,CAAC;IAED,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,OAAO,CAAC;IACvC,IAAI,IAAI,EAAE,CAAC;QACT,OAAO,IAAA,uBAAY,EAAC,wBAAU,CAAC,YAAY,EAAE,IAAI,CAAC,CAAC;IACrD,CAAC;IAED,OAAO,EAAE,CAAC;AACZ,CAAC;AAED;;;;;;GAMG;AACH,SAAgB,kBAAkB,CAChC,KAAqB,EACrB,OAAuB;IAEvB,MAAM,IAAI,GAAG,KAAK,CAAC,IAAwB,CAAC;IAE5C,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,IAAI,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;QAC9B,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,IAAI,IAAI,EAAE,CAAC;QAC7C,IAAI,IAAI,EAAE,CAAC;YACT,OAAO,IAAA,uBAAY,EAAC,wBAAU,CAAC,aAAa,EAAE,IAAI,CAAC,CAAC;QACtD,CAAC;IACH,CAAC;IAED,IAAI,OAAO,CAAC,gBAAgB,EAAE,CAAC;QAC7B,MAAM,OAAO,GAAG,OAAO,CAAC,gBAAgB,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QAEtE,IAAI,OAAO,IAAI,OAAO,KAAK,KAAK,CAAC,IAAI,EAAE,CAAC;YACtC,OAAO,IAAA,uBAAY,EAAC,wBAAU,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC;QACzD,CAAC;QAED,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACnB,MAAM,SAAS,GAAG,OAAO,CAAC,gBAAgB,CAAC,UAAU,CACnD,IAAI,CAAC,SAAS,EACd,IAAI,CACL,CAAC;YACF,IAAI,SAAS,IAAI,SAAS,KAAK,IAAI,CAAC,SAAS,EAAE,CAAC;gBAC9C,OAAO,IAAA,uBAAY,EAAC,wBAAU,CAAC,aAAa,EAAE,SAAS,CAAC,CAAC;YAC3D,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,EAAE,CAAC;AACZ,CAAC"}

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

@@ -0,0 +1,21 @@
+/**
+ * Help event handler — `if.event.help_displayed`.
+ *
+ * Produces the canonical "HOW TO PLAY INTERACTIVE FICTION" block.
+ * Content based on the PR-IF "How to Play" reference card.
+ *
+ * Public interface: `handleHelpDisplayed`. 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 "../../../text-blocks/index";
+import type { ISemanticEvent } from "../../../core/index";
+import type { HandlerContext } from './types';
+/**
+ * Handle `if.event.help_displayed` to produce the help text block.
+ */
+export declare function handleHelpDisplayed(_event: ISemanticEvent, _context: HandlerContext): ITextBlock[];
+//# sourceMappingURL=help.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"help.d.ts","sourceRoot":"","sources":["../../../../../../../repos/sharpee/packages/engine/src/prose-pipeline/handlers/help.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAgD9C;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,cAAc,EACtB,QAAQ,EAAE,cAAc,GACvB,UAAU,EAAE,CAEd"}

package/prose-pipeline/handlers/help.js

@@ -0,0 +1,68 @@
+"use strict";
+/**
+ * Help event handler — `if.event.help_displayed`.
+ *
+ * Produces the canonical "HOW TO PLAY INTERACTIVE FICTION" block.
+ * Content based on the PR-IF "How to Play" reference card.
+ *
+ * Public interface: `handleHelpDisplayed`. 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)
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.handleHelpDisplayed = handleHelpDisplayed;
+const assemble_1 = require("../assemble");
+const HELP_TEXT = `HOW TO PLAY INTERACTIVE FICTION
+
+Interactive fiction is a conversation between you and the game. You type commands; the game describes what happens.
+
+MOVING AROUND
+  Type a direction to move: NORTH (N), SOUTH (S), EAST (E), WEST (W),
+  NORTHEAST (NE), NORTHWEST (NW), SOUTHEAST (SE), SOUTHWEST (SW),
+  UP (U), DOWN (D), IN, OUT, ENTER, EXIT.
+
+LOOKING AND EXAMINING
+  LOOK (L) - Describe your surroundings.
+  EXAMINE (X) something - Look closely at an object.
+
+INTERACTING WITH OBJECTS
+  TAKE (GET) something - Pick it up.
+  DROP something - Put it down.
+  OPEN / CLOSE something - Open or close a door, container, etc.
+  PUT something IN / ON something - Place an object in a container or on a surface.
+  LOCK / UNLOCK something WITH something - Lock or unlock with a key.
+  TURN ON / TURN OFF something - Operate a switch or device.
+  WEAR / TAKE OFF something - Put on or remove clothing.
+  EAT / DRINK something - Consume food or drink.
+  READ something - Read text on an object.
+  SEARCH something - Search a container or area.
+  LOOK UNDER / LOOK BEHIND something - Check hidden spots.
+
+TALKING TO CHARACTERS
+  TALK TO someone - Start a conversation.
+  ASK someone ABOUT something - Ask about a topic.
+  TELL someone ABOUT something - Tell them something.
+  GIVE something TO someone - Hand over an item.
+  SHOW something TO someone - Display an item.
+
+OTHER COMMANDS
+  INVENTORY (I) - List what you're carrying.
+  WAIT (Z) - Let time pass.
+  AGAIN (G) - Repeat your last command.
+  SCORE - Check your progress.
+  SAVE / RESTORE - Save or load your game.
+  UNDO - Take back your last move.
+  QUIT - End the game.
+  ABOUT - Information about this game.
+
+When in doubt, EXAMINE everything.`;
+/**
+ * Handle `if.event.help_displayed` to produce the help text block.
+ */
+function handleHelpDisplayed(_event, _context) {
+    return (0, assemble_1.createBlocks)('help.text', HELP_TEXT);
+}
+//# sourceMappingURL=help.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"help.js","sourceRoot":"","sources":["../../../../../../../../repos/sharpee/packages/engine/src/prose-pipeline/handlers/help.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;GAYG;;AAuDH,kDAKC;AAvDD,0CAA2C;AAE3C,MAAM,SAAS,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;mCA2CiB,CAAC;AAEpC;;GAEG;AACH,SAAgB,mBAAmB,CACjC,MAAsB,EACtB,QAAwB;IAExB,OAAO,IAAA,uBAAY,EAAC,WAAW,EAAE,SAAS,CAAC,CAAC;AAC9C,CAAC"}

package/prose-pipeline/handlers/implicit-take.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Implicit-take handler — `if.event.implicit_take`.
+ *
+ * Produces the "(first taking the X)" line that prefaces an action
+ * the parser auto-promoted (e.g. "READ BOOK" when the player isn't
+ * holding the book yet).
+ *
+ * Public interface: `handleImplicitTake`. 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 "../../../text-blocks/index";
+import type { ISemanticEvent } from "../../../core/index";
+import type { HandlerContext } from './types';
+export declare function handleImplicitTake(event: ISemanticEvent, _context: HandlerContext): ITextBlock[];
+//# sourceMappingURL=implicit-take.d.ts.map

package/prose-pipeline/handlers/implicit-take.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"implicit-take.d.ts","sourceRoot":"","sources":["../../../../../../../repos/sharpee/packages/engine/src/prose-pipeline/handlers/implicit-take.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;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;AAO9C,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,cAAc,EACrB,QAAQ,EAAE,cAAc,GACvB,UAAU,EAAE,CAId"}

package/prose-pipeline/handlers/implicit-take.js

@@ -0,0 +1,26 @@
+"use strict";
+/**
+ * Implicit-take handler — `if.event.implicit_take`.
+ *
+ * Produces the "(first taking the X)" line that prefaces an action
+ * the parser auto-promoted (e.g. "READ BOOK" when the player isn't
+ * holding the book yet).
+ *
+ * Public interface: `handleImplicitTake`. 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.handleImplicitTake = handleImplicitTake;
+const text_blocks_1 = require("../../../text-blocks/index.js");
+const assemble_1 = require("../assemble");
+function handleImplicitTake(event, _context) {
+    const data = event.data;
+    const itemName = data?.itemName || 'something';
+    return [(0, assemble_1.createBlock)(text_blocks_1.BLOCK_KEYS.ACTION_RESULT, `(first taking the ${itemName})`)];
+}
+//# sourceMappingURL=implicit-take.js.map

package/prose-pipeline/handlers/implicit-take.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"implicit-take.js","sourceRoot":"","sources":["../../../../../../../../repos/sharpee/packages/engine/src/prose-pipeline/handlers/implicit-take.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;GAcG;;AAYH,gDAOC;AAhBD,sDAAkD;AAGlD,0CAA0C;AAM1C,SAAgB,kBAAkB,CAChC,KAAqB,EACrB,QAAwB;IAExB,MAAM,IAAI,GAAG,KAAK,CAAC,IAAwB,CAAC;IAC5C,MAAM,QAAQ,GAAG,IAAI,EAAE,QAAQ,IAAI,WAAW,CAAC;IAC/C,OAAO,CAAC,IAAA,sBAAW,EAAC,wBAAU,CAAC,aAAa,EAAE,qBAAqB,QAAQ,GAAG,CAAC,CAAC,CAAC;AACnF,CAAC"}

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

@@ -0,0 +1,24 @@
+/**
+ * Prose pipeline handlers — internal barrel.
+ *
+ * Public interface: re-exports every handler family the pipeline
+ * dispatches to, plus the shared `HandlerContext` / `EventHandler`
+ * types. Used by the pipeline class (sub-phase 1.5).
+ *
+ * Owner context: `@sharpee/engine` — internal prose pipeline.
+ *
+ * @see ADR-174 §Engine-internal prose pipeline
+ */
+export type { EventHandler, HandlerContext, ChainableEventData, GenericEventData, } from './types';
+export { handleRoomDescription } from './room';
+export { handleRevealed } from './revealed';
+export { handleGameMessage, handleGenericEvent } from './generic';
+export { handleGameStarted } from './game';
+export { handleHelpDisplayed } from './help';
+export { handleAboutDisplayed } from './about';
+export { handleAudibilityHeard } from './audibility';
+export { tryProcessDomainEventMessage } from './domain-message';
+export { handleImplicitTake } from './implicit-take';
+export { handleCommandFailed } from './command-failed';
+export { handleClientQuery } from './client-query';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../../repos/sharpee/packages/engine/src/prose-pipeline/handlers/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,YAAY,EACV,YAAY,EACZ,cAAc,EACd,kBAAkB,EAClB,gBAAgB,GACjB,MAAM,SAAS,CAAC;AAGjB,OAAO,EAAE,qBAAqB,EAAE,MAAM,QAAQ,CAAC;AAC/C,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAClE,OAAO,EAAE,iBAAiB,EAAE,MAAM,QAAQ,CAAC;AAC3C,OAAO,EAAE,mBAAmB,EAAE,MAAM,QAAQ,CAAC;AAC7C,OAAO,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAC;AAC/C,OAAO,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAGrD,OAAO,EAAE,4BAA4B,EAAE,MAAM,kBAAkB,CAAC;AAChE,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC"}

package/prose-pipeline/handlers/index.js

@@ -0,0 +1,40 @@
+"use strict";
+/**
+ * Prose pipeline handlers — internal barrel.
+ *
+ * Public interface: re-exports every handler family the pipeline
+ * dispatches to, plus the shared `HandlerContext` / `EventHandler`
+ * types. 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.handleClientQuery = exports.handleCommandFailed = exports.handleImplicitTake = exports.tryProcessDomainEventMessage = exports.handleAudibilityHeard = exports.handleAboutDisplayed = exports.handleHelpDisplayed = exports.handleGameStarted = exports.handleGenericEvent = exports.handleGameMessage = exports.handleRevealed = exports.handleRoomDescription = void 0;
+// Type-keyed handlers (former text-service handlers/*.ts).
+var room_1 = require("./room");
+Object.defineProperty(exports, "handleRoomDescription", { enumerable: true, get: function () { return room_1.handleRoomDescription; } });
+var revealed_1 = require("./revealed");
+Object.defineProperty(exports, "handleRevealed", { enumerable: true, get: function () { return revealed_1.handleRevealed; } });
+var generic_1 = require("./generic");
+Object.defineProperty(exports, "handleGameMessage", { enumerable: true, get: function () { return generic_1.handleGameMessage; } });
+Object.defineProperty(exports, "handleGenericEvent", { enumerable: true, get: function () { return generic_1.handleGenericEvent; } });
+var game_1 = require("./game");
+Object.defineProperty(exports, "handleGameStarted", { enumerable: true, get: function () { return game_1.handleGameStarted; } });
+var help_1 = require("./help");
+Object.defineProperty(exports, "handleHelpDisplayed", { enumerable: true, get: function () { return help_1.handleHelpDisplayed; } });
+var about_1 = require("./about");
+Object.defineProperty(exports, "handleAboutDisplayed", { enumerable: true, get: function () { return about_1.handleAboutDisplayed; } });
+var audibility_1 = require("./audibility");
+Object.defineProperty(exports, "handleAudibilityHeard", { enumerable: true, get: function () { return audibility_1.handleAudibilityHeard; } });
+// Inline handlers extracted from text-service.ts in this sub-phase.
+var domain_message_1 = require("./domain-message");
+Object.defineProperty(exports, "tryProcessDomainEventMessage", { enumerable: true, get: function () { return domain_message_1.tryProcessDomainEventMessage; } });
+var implicit_take_1 = require("./implicit-take");
+Object.defineProperty(exports, "handleImplicitTake", { enumerable: true, get: function () { return implicit_take_1.handleImplicitTake; } });
+var command_failed_1 = require("./command-failed");
+Object.defineProperty(exports, "handleCommandFailed", { enumerable: true, get: function () { return command_failed_1.handleCommandFailed; } });
+var client_query_1 = require("./client-query");
+Object.defineProperty(exports, "handleClientQuery", { enumerable: true, get: function () { return client_query_1.handleClientQuery; } });
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../../../repos/sharpee/packages/engine/src/prose-pipeline/handlers/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;GAUG;;;AASH,2DAA2D;AAC3D,+BAA+C;AAAtC,6GAAA,qBAAqB,OAAA;AAC9B,uCAA4C;AAAnC,0GAAA,cAAc,OAAA;AACvB,qCAAkE;AAAzD,4GAAA,iBAAiB,OAAA;AAAE,6GAAA,kBAAkB,OAAA;AAC9C,+BAA2C;AAAlC,yGAAA,iBAAiB,OAAA;AAC1B,+BAA6C;AAApC,2GAAA,mBAAmB,OAAA;AAC5B,iCAA+C;AAAtC,6GAAA,oBAAoB,OAAA;AAC7B,2CAAqD;AAA5C,mHAAA,qBAAqB,OAAA;AAE9B,oEAAoE;AACpE,mDAAgE;AAAvD,8HAAA,4BAA4B,OAAA;AACrC,iDAAqD;AAA5C,mHAAA,kBAAkB,OAAA;AAC3B,mDAAuD;AAA9C,qHAAA,mBAAmB,OAAA;AAC5B,+CAAmD;AAA1C,iHAAA,iBAAiB,OAAA"}

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

@@ -0,0 +1,24 @@
+/**
+ * Revealed event handler.
+ *
+ * Handles `if.event.revealed` — fired when items become visible inside
+ * a container. Pulls a direct message/text payload first, then tries
+ * the language provider keyed on event type, then falls back to a
+ * built-in "Inside the {container} you see {items}." formatter.
+ *
+ * Public interface: `handleRevealed`. Used by the pipeline's
+ * event-type dispatch.
+ *
+ * Owner context: `@sharpee/engine` — internal prose pipeline.
+ *
+ * @see ADR-094 Event Chaining
+ * @see ADR-174 §Engine-internal prose pipeline (port from text-service)
+ */
+import type { ITextBlock } from "../../../text-blocks/index";
+import type { ISemanticEvent } from "../../../core/index";
+import type { HandlerContext } from './types';
+/**
+ * Handle `if.event.revealed` events.
+ */
+export declare function handleRevealed(event: ISemanticEvent, context: HandlerContext): ITextBlock[];
+//# sourceMappingURL=revealed.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"revealed.d.ts","sourceRoot":"","sources":["../../../../../../../repos/sharpee/packages/engine/src/prose-pipeline/handlers/revealed.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAEvD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,KAAK,EAAE,cAAc,EAAsB,MAAM,SAAS,CAAC;AAelE;;GAEG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,cAAc,EACrB,OAAO,EAAE,cAAc,GACtB,UAAU,EAAE,CAkCd"}