@sharpee/if-services 0.9.65-beta → 0.9.66-beta

package/package.json

@@ -1,25 +1,15 @@
 {
   "name": "@sharpee/if-services",
-  "version": "0.9.65-beta",
+  "version": "0.9.66-beta",
   "description": "Runtime service interfaces for Sharpee Interactive Fiction Platform",
-  "main": "./dist-npm/index.js",
-  "types": "./dist-npm/index.d.ts",
+  "main": "./index.js",
+  "types": "./index.d.ts",
   "scripts": {
     "build": "tsc",
     "clean": "rimraf dist",
     "test": "jest",
     "build:npm": "tsc --outDir dist-npm"
   },
-  "dependencies": {
-    "@sharpee/core": "workspace:*",
-    "@sharpee/if-domain": "workspace:*",
-    "@sharpee/world-model": "workspace:*"
-  },
-  "devDependencies": {
-    "@types/node": "^20.11.19",
-    "rimraf": "^5.0.5",
-    "typescript": "^5.3.3"
-  },
   "files": [
     "dist-npm"
   ],
@@ -37,8 +27,9 @@
   },
   "exports": {
     ".": {
-      "types": "./dist-npm/index.d.ts",
-      "require": "./dist-npm/index.js"
+      "types": "./index.d.ts",
+      "require": "./index.js",
+      "default": "./index.js"
     }
   }
 }

package/dist-npm/index.d.ts

@@ -1,8 +0,0 @@
-/**
- * @sharpee/if-services - Runtime service interfaces for Sharpee Interactive Fiction Platform
- *
- * This package contains interfaces for runtime services that need access to
- * the world model, separating them from the pure domain package.
- */
-export * from './perception-service';
-//# sourceMappingURL=index.d.ts.map

package/dist-npm/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,cAAc,sBAAsB,CAAC"}

package/dist-npm/index.js

@@ -1,25 +0,0 @@
-"use strict";
-/**
- * @sharpee/if-services - Runtime service interfaces for Sharpee Interactive Fiction Platform
- *
- * This package contains interfaces for runtime services that need access to
- * the world model, separating them from the pure domain package.
- */
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __exportStar = (this && this.__exportStar) || function(m, exports) {
-    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-// Perception service interfaces
-__exportStar(require("./perception-service"), exports);
-//# sourceMappingURL=index.js.map

package/dist-npm/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/index.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;;;;;;;;;;;;;;AAEH,gCAAgC;AAChC,uDAAqC"}

package/dist-npm/perception-service.d.ts

@@ -1,68 +0,0 @@
-/**
- * Perception service interface for Interactive Fiction
- *
- * Perception services filter events based on what the player can perceive.
- * They sit between action execution and the text service, transforming
- * events that describe things the player cannot perceive (due to darkness,
- * blindness, etc.) into appropriate alternative events.
- *
- * @see ADR-069 Perception-Based Event Filtering
- */
-import type { ISemanticEvent } from "../../core/dist-npm/src/index";
-import type { IFEntity, IWorldModel } from "../../world-model/dist-npm/src/index";
-/**
- * Sense types for perception checks
- */
-export type Sense = 'sight' | 'hearing' | 'smell' | 'touch';
-/**
- * Reasons why perception might be blocked
- */
-export type PerceptionBlockReason = 'darkness' | 'blindness' | 'blindfolded' | 'unknown';
-/**
- * Data for a perception-blocked event
- */
-export interface PerceptionBlockedData {
-    /** The original event type that was blocked */
-    originalType: string;
-    /** Why perception was blocked */
-    reason: PerceptionBlockReason;
-    /** Which sense was blocked */
-    sense: Sense;
-    /** Original event data (for debugging/logging) */
-    originalData?: unknown;
-}
-/**
- * Service interface for filtering events based on player perception.
- *
- * The perception service determines what the player can perceive based on:
- * - Environmental factors (darkness, noise, etc.)
- * - Actor state (blindness, deafness, etc.)
- * - Equipment (blindfold, earplugs, etc.)
- *
- * Events that describe things the player cannot perceive are transformed
- * or removed before being sent to the text service.
- *
- * @see ADR-069 Perception-Based Event Filtering
- */
-export interface IPerceptionService {
-    /**
-     * Filter events based on what the actor can perceive.
-     *
-     * @param events - Raw events from action execution
-     * @param actor - The perceiving actor (usually the player)
-     * @param world - The world model for checking environment state
-     * @returns Filtered/transformed events based on perception
-     */
-    filterEvents(events: ISemanticEvent[], actor: IFEntity, world: IWorldModel): ISemanticEvent[];
-    /**
-     * Check if an actor can perceive using a specific sense.
-     *
-     * @param actor - The perceiving actor
-     * @param location - The location being perceived
-     * @param world - The world model
-     * @param sense - Which sense to check (defaults to 'sight')
-     * @returns true if the actor can perceive, false otherwise
-     */
-    canPerceive(actor: IFEntity, location: IFEntity, world: IWorldModel, sense: Sense): boolean;
-}
-//# sourceMappingURL=perception-service.d.ts.map

package/dist-npm/perception-service.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"perception-service.d.ts","sourceRoot":"","sources":["../../../../src/perception-service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAElE;;GAEG;AACH,MAAM,MAAM,KAAK,GAAG,OAAO,GAAG,SAAS,GAAG,OAAO,GAAG,OAAO,CAAC;AAE5D;;GAEG;AACH,MAAM,MAAM,qBAAqB,GAC7B,UAAU,GACV,WAAW,GACX,aAAa,GACb,SAAS,CAAC;AAEd;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,+CAA+C;IAC/C,YAAY,EAAE,MAAM,CAAC;IACrB,iCAAiC;IACjC,MAAM,EAAE,qBAAqB,CAAC;IAC9B,8BAA8B;IAC9B,KAAK,EAAE,KAAK,CAAC;IACb,kDAAkD;IAClD,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,kBAAkB;IACjC;;;;;;;OAOG;IACH,YAAY,CACV,MAAM,EAAE,cAAc,EAAE,EACxB,KAAK,EAAE,QAAQ,EACf,KAAK,EAAE,WAAW,GACjB,cAAc,EAAE,CAAC;IAEpB;;;;;;;;OAQG;IACH,WAAW,CACT,KAAK,EAAE,QAAQ,EACf,QAAQ,EAAE,QAAQ,EAClB,KAAK,EAAE,WAAW,EAClB,KAAK,EAAE,KAAK,GACX,OAAO,CAAC;CACZ"}

package/dist-npm/perception-service.js

@@ -1,13 +0,0 @@
-"use strict";
-/**
- * Perception service interface for Interactive Fiction
- *
- * Perception services filter events based on what the player can perceive.
- * They sit between action execution and the text service, transforming
- * events that describe things the player cannot perceive (due to darkness,
- * blindness, etc.) into appropriate alternative events.
- *
- * @see ADR-069 Perception-Based Event Filtering
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-//# sourceMappingURL=perception-service.js.map

package/dist-npm/perception-service.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"perception-service.js","sourceRoot":"","sources":["../../../../src/perception-service.ts"],"names":[],"mappings":";AAAA;;;;;;;;;GASG"}

package/dist-npm/text-service.d.ts

@@ -1,137 +0,0 @@
-/**
- * Text service interface for Interactive Fiction
- *
- * Text services are responsible for generating output after each turn.
- * They have access to the game context and can query events, entities,
- * and spatial relationships to build appropriate output.
- */
-import type { ISemanticEvent } from "../../core/dist-npm/src/index";
-import type { LanguageProvider } from "../../if-domain/dist-npm/src/index";
-import type { WorldModel, IFEntity } from "../../world-model/dist-npm/src/index";
-/**
- * Game context provided to text service
- */
-export interface TextServiceContext {
-    /**
-     * Current turn number
-     */
-    currentTurn: number;
-    /**
-     * Get events for the current turn
-     */
-    getCurrentTurnEvents(): ISemanticEvent[];
-    /**
-     * Get events by type for the current turn
-     */
-    getEventsByType(type: string): ISemanticEvent[];
-    /**
-     * Get all events (full history)
-     */
-    getAllEvents(): ISemanticEvent[];
-    /**
-     * Access to world model for entity queries
-     */
-    world: WorldModel;
-    /**
-     * Get the player entity
-     */
-    getPlayer(): IFEntity;
-    /**
-     * Get entities in a location
-     */
-    getContents(locationId: string): IFEntity[];
-    /**
-     * Get location of an entity
-     */
-    getLocation(entityId: string): string | null;
-    /**
-     * Get platform events for the current turn (optional)
-     * These are debug/system events from parser, world model, etc.
-     */
-    getPlatformEvents?(): ISemanticEvent[];
-}
-/**
- * Output format for different client types
- */
-export type TextOutput = string | TextOutputJSON | TextOutputChanneled;
-/**
- * JSON output for web/rich clients
- */
-export interface TextOutputJSON {
-    type: 'json';
-    main: string;
-    metadata?: {
-        turn: number;
-        location?: string;
-        score?: number;
-        moves?: number;
-    };
-    sections?: {
-        room?: string;
-        inventory?: string[];
-        exits?: string[];
-        objects?: string[];
-    };
-    styling?: {
-        roomName?: string;
-        important?: string[];
-    };
-}
-/**
- * Multi-channel output
- */
-export interface TextOutputChanneled {
-    type: 'channeled';
-    channels: Map<string, string>;
-}
-/**
- * Text service interface
- */
-export interface TextService {
-    /**
-     * Initialize with context
-     */
-    initialize(context: TextServiceContext): void;
-    /**
-     * Process the current turn and generate output
-     * @returns The formatted output
-     */
-    processTurn(): TextOutput;
-    /**
-     * Set the language provider for template resolution
-     * @param provider The language provider
-     */
-    setLanguageProvider(provider: LanguageProvider): void;
-    /**
-     * Get the current language provider
-     * @returns The language provider or null if not set
-     */
-    getLanguageProvider(): LanguageProvider | null;
-    /**
-     * Set output format preference
-     * @param format The desired output format
-     */
-    setOutputFormat?(format: 'text' | 'json' | 'channeled'): void;
-}
-/**
- * Text service configuration
- */
-export interface TextServiceConfig {
-    /**
-     * Output format (defaults to 'text')
-     */
-    outputFormat?: 'text' | 'json' | 'channeled';
-    /**
-     * Whether to include debug information in output
-     */
-    debug?: boolean;
-    /**
-     * Custom event processors by event type
-     */
-    processors?: Record<string, (event: ISemanticEvent, context: TextServiceContext) => string | null>;
-    /**
-     * Channels to use for channeled output
-     */
-    channels?: string[];
-}
-//# sourceMappingURL=text-service.d.ts.map

package/dist-npm/text-service.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"text-service.d.ts","sourceRoot":"","sources":["../src/text-service.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAEjE;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC;;OAEG;IACH,WAAW,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,oBAAoB,IAAI,cAAc,EAAE,CAAC;IAEzC;;OAEG;IACH,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,EAAE,CAAC;IAEhD;;OAEG;IACH,YAAY,IAAI,cAAc,EAAE,CAAC;IAEjC;;OAEG;IACH,KAAK,EAAE,UAAU,CAAC;IAElB;;OAEG;IACH,SAAS,IAAI,QAAQ,CAAC;IAEtB;;OAEG;IACH,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,QAAQ,EAAE,CAAC;IAE5C;;OAEG;IACH,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IAE7C;;;OAGG;IACH,iBAAiB,CAAC,IAAI,cAAc,EAAE,CAAC;CACxC;AAED;;GAEG;AACH,MAAM,MAAM,UAAU,GAClB,MAAM,GACN,cAAc,GACd,mBAAmB,CAAC;AAExB;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE;QACT,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC;IACF,QAAQ,CAAC,EAAE;QACT,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;QACrB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;QACjB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;KACpB,CAAC;IACF,OAAO,CAAC,EAAE;QACR,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;KACtB,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,WAAW,CAAC;IAClB,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC/B;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B;;OAEG;IACH,UAAU,CAAC,OAAO,EAAE,kBAAkB,GAAG,IAAI,CAAC;IAE9C;;;OAGG;IACH,WAAW,IAAI,UAAU,CAAC;IAE1B;;;OAGG;IACH,mBAAmB,CAAC,QAAQ,EAAE,gBAAgB,GAAG,IAAI,CAAC;IAEtD;;;OAGG;IACH,mBAAmB,IAAI,gBAAgB,GAAG,IAAI,CAAC;IAE/C;;;OAGG;IACH,eAAe,CAAC,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,WAAW,GAAG,IAAI,CAAC;CAC/D;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,WAAW,CAAC;IAE7C;;OAEG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;IAEhB;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,cAAc,EAAE,OAAO,EAAE,kBAAkB,KAAK,MAAM,GAAG,IAAI,CAAC,CAAC;IAEnG;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB"}

package/dist-npm/text-service.js

@@ -1,10 +0,0 @@
-"use strict";
-/**
- * Text service interface for Interactive Fiction
- *
- * Text services are responsible for generating output after each turn.
- * They have access to the game context and can query events, entities,
- * and spatial relationships to build appropriate output.
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-//# sourceMappingURL=text-service.js.map

package/dist-npm/text-service.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"text-service.js","sourceRoot":"","sources":["../src/text-service.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG"}