@sharpee/stdlib 0.9.60-beta

package/dist/scope/types.d.ts

@@ -0,0 +1,242 @@
+/**
+ * Core types for the scope system
+ */
+import { IFEntity } from '@sharpee/world-model';
+/**
+ * Levels of scope indicating how an entity can be perceived.
+ *
+ * Ordered from least accessible (UNAWARE=0) to most accessible (CARRIED=4).
+ * Higher values imply all lower levels are also satisfied.
+ * Use numeric comparisons: if (entityScope >= requiredScope) { ... }
+ *
+ * For actions that check scope, use ActionContext.requireScope() which
+ * returns appropriate error messages for scope failures.
+ */
+export declare enum ScopeLevel {
+    /** Entity not known to player at all */
+    UNAWARE = 0,
+    /** Player knows entity exists (can think about, ask about, remember) */
+    AWARE = 1,
+    /** Can see with eyes (examine, look at, read) */
+    VISIBLE = 2,
+    /** Can physically touch/manipulate (take, push, open, touch) */
+    REACHABLE = 3,
+    /** In actor's inventory - always accessible (drop, eat, wear, insert) */
+    CARRIED = 4
+}
+/**
+ * @deprecated Use ScopeLevel instead. These string values are for backwards compatibility.
+ */
+export declare const ScopeLevelStrings: {
+    readonly CARRIED: "carried";
+    readonly REACHABLE: "reachable";
+    readonly VISIBLE: "visible";
+    readonly AUDIBLE: "audible";
+    readonly DETECTABLE: "detectable";
+    readonly OUT_OF_SCOPE: "out_of_scope";
+};
+/**
+ * Types of sensory perception
+ */
+export declare enum SenseType {
+    /** Visual perception - blocked by opaque barriers, needs light */
+    SIGHT = "sight",
+    /** Auditory perception - travels through some barriers */
+    HEARING = "hearing",
+    /** Olfactory perception - needs air path */
+    SMELL = "smell",
+    /** Tactile perception - requires physical contact */
+    TOUCH = "touch",
+    /** Supernatural/psychic perception - game-specific */
+    VIBE = "vibe"
+}
+/**
+ * Determines what entities are in scope for an actor
+ */
+export interface ScopeResolver {
+    /**
+     * Get the highest level of scope for a target entity
+     */
+    getScope(actor: IFEntity, target: IFEntity): ScopeLevel;
+    /**
+     * Check if actor can see the target
+     */
+    canSee(actor: IFEntity, target: IFEntity): boolean;
+    /**
+     * Check if actor can physically reach the target
+     */
+    canReach(actor: IFEntity, target: IFEntity): boolean;
+    /**
+     * Check if actor can hear the target or sounds from it
+     */
+    canHear(actor: IFEntity, target: IFEntity): boolean;
+    /**
+     * Check if actor can smell the target
+     */
+    canSmell(actor: IFEntity, target: IFEntity): boolean;
+    /**
+     * Get all entities visible to the actor
+     */
+    getVisible(actor: IFEntity): IFEntity[];
+    /**
+     * Get all entities reachable by the actor
+     */
+    getReachable(actor: IFEntity): IFEntity[];
+    /**
+     * Get all entities the actor can hear
+     */
+    getAudible(actor: IFEntity): IFEntity[];
+}
+/**
+ * Tracks what actors know about based on what they've witnessed
+ */
+export interface WitnessSystem {
+    /**
+     * Record who can witness a state change
+     */
+    recordWitnesses(change: StateChange): WitnessRecord;
+    /**
+     * Update actor knowledge based on what was witnessed
+     */
+    updateKnowledge(record: WitnessRecord): void;
+    /**
+     * Get what an actor knows about
+     */
+    getKnownEntities(actorId: string): EntityKnowledge[];
+    /**
+     * Check if an actor has discovered an entity
+     */
+    hasDiscovered(actorId: string, entityId: string): boolean;
+    /**
+     * Get what an actor knows about a specific entity
+     */
+    getKnowledge(actorId: string, entityId: string): EntityKnowledge | undefined;
+}
+/**
+ * Represents a change in world state that can be witnessed
+ */
+export interface StateChange {
+    type: 'move' | 'create' | 'destroy' | 'modify' | 'action';
+    entityId: string;
+    actorId?: string;
+    timestamp: number;
+    from?: string;
+    to?: string;
+    property?: string;
+    oldValue?: any;
+    newValue?: any;
+    action?: string;
+    target?: string;
+}
+/**
+ * Record of who witnessed what and how
+ */
+export interface WitnessRecord {
+    change: StateChange;
+    witnesses: Map<string, WitnessDetail>;
+}
+/**
+ * Details about how an actor witnessed something
+ */
+export interface WitnessDetail {
+    actorId: string;
+    sense: SenseType;
+    level: WitnessLevel;
+    confidence: 'certain' | 'likely' | 'unsure';
+}
+/**
+ * Level of detail in witnessing
+ */
+export declare enum WitnessLevel {
+    /** Saw/heard/sensed everything clearly */
+    FULL = "full",
+    /** Saw/heard/sensed some but not all details */
+    PARTIAL = "partial",
+    /** Caught a glimpse or hint */
+    PERIPHERAL = "peripheral",
+    /** Deduced from evidence rather than direct perception */
+    INFERRED = "inferred"
+}
+/**
+ * What an actor knows about an entity
+ */
+export interface EntityKnowledge {
+    entityId: string;
+    exists: boolean;
+    lastSeen?: number;
+    lastKnownLocation?: string;
+    visualProperties?: Map<string, any>;
+    lastHeard?: number;
+    heardFrom?: string;
+    lastSmelled?: number;
+    scentStrength?: 'faint' | 'moderate' | 'strong';
+    discoveredAt: number;
+    discoveredBy: SenseType;
+    movementHistory?: MovementRecord[];
+}
+/**
+ * Record of witnessed movement
+ */
+export interface MovementRecord {
+    from: string;
+    to: string;
+    witnessedAt: number;
+    witnessedBy: SenseType;
+    confidence: 'certain' | 'likely' | 'unsure';
+}
+/**
+ * Witness event types - all data, no narrative text
+ */
+export interface WitnessActionEvent {
+    type: 'if.witness.action';
+    data: {
+        witnessId: string;
+        sense: SenseType;
+        level: WitnessLevel;
+        action: string;
+        actorId: string;
+        targetId?: string;
+        fromLocation?: string;
+        toLocation?: string;
+        timestamp: number;
+    };
+}
+export interface WitnessMovementEvent {
+    type: 'if.witness.movement';
+    data: {
+        witnessId: string;
+        sense: SenseType;
+        level: WitnessLevel;
+        entityId: string | 'unknown';
+        fromLocation: string;
+        toLocation: string;
+        direction?: string;
+        timestamp: number;
+    };
+}
+export interface WitnessSoundEvent {
+    type: 'if.witness.sound';
+    data: {
+        witnessId: string;
+        sense: SenseType;
+        soundType: string;
+        intensity: 'faint' | 'moderate' | 'loud';
+        fromDirection?: string;
+        estimatedLocation?: string;
+        timestamp: number;
+    };
+}
+export interface WitnessScentEvent {
+    type: 'if.witness.scent';
+    data: {
+        witnessId: string;
+        sense: SenseType;
+        scentType: string;
+        intensity: 'faint' | 'moderate' | 'strong';
+        fromDirection?: string;
+        characteristics?: string[];
+        timestamp: number;
+    };
+}
+export type WitnessEvent = WitnessActionEvent | WitnessMovementEvent | WitnessSoundEvent | WitnessScentEvent;
+//# sourceMappingURL=types.d.ts.map

package/dist/scope/types.d.ts.map

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

package/dist/scope/types.js

@@ -0,0 +1,71 @@
+"use strict";
+/**
+ * Core types for the scope system
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WitnessLevel = exports.SenseType = exports.ScopeLevelStrings = exports.ScopeLevel = void 0;
+/**
+ * Levels of scope indicating how an entity can be perceived.
+ *
+ * Ordered from least accessible (UNAWARE=0) to most accessible (CARRIED=4).
+ * Higher values imply all lower levels are also satisfied.
+ * Use numeric comparisons: if (entityScope >= requiredScope) { ... }
+ *
+ * For actions that check scope, use ActionContext.requireScope() which
+ * returns appropriate error messages for scope failures.
+ */
+var ScopeLevel;
+(function (ScopeLevel) {
+    /** Entity not known to player at all */
+    ScopeLevel[ScopeLevel["UNAWARE"] = 0] = "UNAWARE";
+    /** Player knows entity exists (can think about, ask about, remember) */
+    ScopeLevel[ScopeLevel["AWARE"] = 1] = "AWARE";
+    /** Can see with eyes (examine, look at, read) */
+    ScopeLevel[ScopeLevel["VISIBLE"] = 2] = "VISIBLE";
+    /** Can physically touch/manipulate (take, push, open, touch) */
+    ScopeLevel[ScopeLevel["REACHABLE"] = 3] = "REACHABLE";
+    /** In actor's inventory - always accessible (drop, eat, wear, insert) */
+    ScopeLevel[ScopeLevel["CARRIED"] = 4] = "CARRIED";
+})(ScopeLevel || (exports.ScopeLevel = ScopeLevel = {}));
+/**
+ * @deprecated Use ScopeLevel instead. These string values are for backwards compatibility.
+ */
+exports.ScopeLevelStrings = {
+    CARRIED: 'carried',
+    REACHABLE: 'reachable',
+    VISIBLE: 'visible',
+    AUDIBLE: 'audible',
+    DETECTABLE: 'detectable',
+    OUT_OF_SCOPE: 'out_of_scope'
+};
+/**
+ * Types of sensory perception
+ */
+var SenseType;
+(function (SenseType) {
+    /** Visual perception - blocked by opaque barriers, needs light */
+    SenseType["SIGHT"] = "sight";
+    /** Auditory perception - travels through some barriers */
+    SenseType["HEARING"] = "hearing";
+    /** Olfactory perception - needs air path */
+    SenseType["SMELL"] = "smell";
+    /** Tactile perception - requires physical contact */
+    SenseType["TOUCH"] = "touch";
+    /** Supernatural/psychic perception - game-specific */
+    SenseType["VIBE"] = "vibe";
+})(SenseType || (exports.SenseType = SenseType = {}));
+/**
+ * Level of detail in witnessing
+ */
+var WitnessLevel;
+(function (WitnessLevel) {
+    /** Saw/heard/sensed everything clearly */
+    WitnessLevel["FULL"] = "full";
+    /** Saw/heard/sensed some but not all details */
+    WitnessLevel["PARTIAL"] = "partial";
+    /** Caught a glimpse or hint */
+    WitnessLevel["PERIPHERAL"] = "peripheral";
+    /** Deduced from evidence rather than direct perception */
+    WitnessLevel["INFERRED"] = "inferred";
+})(WitnessLevel || (exports.WitnessLevel = WitnessLevel = {}));
+//# sourceMappingURL=types.js.map

package/dist/scope/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/scope/types.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAIH;;;;;;;;;GASG;AACH,IAAY,UAeX;AAfD,WAAY,UAAU;IACpB,wCAAwC;IACxC,iDAAW,CAAA;IAEX,wEAAwE;IACxE,6CAAS,CAAA;IAET,iDAAiD;IACjD,iDAAW,CAAA;IAEX,gEAAgE;IAChE,qDAAa,CAAA;IAEb,yEAAyE;IACzE,iDAAW,CAAA;AACb,CAAC,EAfW,UAAU,0BAAV,UAAU,QAerB;AAED;;GAEG;AACU,QAAA,iBAAiB,GAAG;IAC/B,OAAO,EAAE,SAAS;IAClB,SAAS,EAAE,WAAW;IACtB,OAAO,EAAE,SAAS;IAClB,OAAO,EAAE,SAAS;IAClB,UAAU,EAAE,YAAY;IACxB,YAAY,EAAE,cAAc;CACpB,CAAC;AAEX;;GAEG;AACH,IAAY,SAeX;AAfD,WAAY,SAAS;IACnB,kEAAkE;IAClE,4BAAe,CAAA;IAEf,0DAA0D;IAC1D,gCAAmB,CAAA;IAEnB,4CAA4C;IAC5C,4BAAe,CAAA;IAEf,qDAAqD;IACrD,4BAAe,CAAA;IAEf,sDAAsD;IACtD,0BAAa,CAAA;AACf,CAAC,EAfW,SAAS,yBAAT,SAAS,QAepB;AAsHD;;GAEG;AACH,IAAY,YAYX;AAZD,WAAY,YAAY;IACtB,0CAA0C;IAC1C,6BAAa,CAAA;IAEb,gDAAgD;IAChD,mCAAmB,CAAA;IAEnB,+BAA+B;IAC/B,yCAAyB,CAAA;IAEzB,0DAA0D;IAC1D,qCAAqB,CAAA;AACvB,CAAC,EAZW,YAAY,4BAAZ,YAAY,QAYvB"}

package/dist/scope/witness-system.d.ts

@@ -0,0 +1,83 @@
+/**
+ * Witness system implementation
+ *
+ * Tracks what actors know about based on what they've witnessed.
+ * Works with the scope system to determine who can perceive changes
+ * and updates their knowledge accordingly.
+ */
+import { WorldModel } from '@sharpee/world-model';
+import { WitnessSystem, StateChange, WitnessRecord, EntityKnowledge, ScopeResolver } from './types';
+/**
+ * Standard implementation of the witness system
+ */
+export declare class StandardWitnessSystem implements WitnessSystem {
+    private world;
+    private scopeResolver;
+    private knowledge;
+    constructor(world: WorldModel, scopeResolver: ScopeResolver);
+    /**
+     * Record who can witness a state change
+     */
+    recordWitnesses(change: StateChange): WitnessRecord;
+    /**
+     * Update actor knowledge based on what was witnessed
+     */
+    updateKnowledge(record: WitnessRecord): void;
+    /**
+     * Get what an actor knows about
+     */
+    getKnownEntities(actorId: string): EntityKnowledge[];
+    /**
+     * Check if an actor has discovered an entity
+     */
+    hasDiscovered(actorId: string, entityId: string): boolean;
+    /**
+     * Get what an actor knows about a specific entity
+     */
+    getKnowledge(actorId: string, entityId: string): EntityKnowledge | undefined;
+    /**
+     * Determine if and how an actor can witness a change
+     */
+    private canWitnessChange;
+    /**
+     * Determine the level of detail in witnessing
+     */
+    private determineWitnessLevel;
+    /**
+     * Update knowledge from witnessed movement
+     */
+    private updateMovementKnowledge;
+    /**
+     * Update knowledge from witnessed creation/discovery
+     */
+    private updateDiscoveryKnowledge;
+    /**
+     * Update knowledge from witnessed destruction
+     */
+    private updateDestructionKnowledge;
+    /**
+     * Update knowledge from witnessed modification
+     */
+    private updateModificationKnowledge;
+    /**
+     * Update knowledge from witnessed action
+     */
+    private updateActionKnowledge;
+    /**
+     * Create initial knowledge entry for an entity
+     */
+    private createInitialKnowledge;
+    /**
+     * Update sense-specific timestamps
+     */
+    private updateSenseTimestamps;
+    /**
+     * Emit appropriate witness event based on change type
+     */
+    private emitWitnessEvent;
+    /**
+     * Calculate direction of movement
+     */
+    private getDirection;
+}
+//# sourceMappingURL=witness-system.d.ts.map

package/dist/scope/witness-system.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"witness-system.d.ts","sourceRoot":"","sources":["../../src/scope/witness-system.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAY,UAAU,EAAa,MAAM,sBAAsB,CAAC;AAEvE,OAAO,EACL,aAAa,EACb,WAAW,EACX,aAAa,EAGb,eAAe,EAIf,aAAa,EACd,MAAM,SAAS,CAAC;AAEjB;;GAEG;AACH,qBAAa,qBAAsB,YAAW,aAAa;IAIvD,OAAO,CAAC,KAAK;IACb,OAAO,CAAC,aAAa;IAJvB,OAAO,CAAC,SAAS,CAAwD;gBAG/D,KAAK,EAAE,UAAU,EACjB,aAAa,EAAE,aAAa;IAGtC;;OAEG;IACH,eAAe,CAAC,MAAM,EAAE,WAAW,GAAG,aAAa;IAwBnD;;OAEG;IACH,eAAe,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI;IAgC5C;;OAEG;IACH,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,eAAe,EAAE;IAOpD;;OAEG;IACH,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO;IAQzD;;OAEG;IACH,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS;IAO5E;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAmCxB;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAc7B;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAuC/B;;OAEG;IACH,OAAO,CAAC,wBAAwB;IAYhC;;OAEG;IACH,OAAO,CAAC,0BAA0B;IAUlC;;OAEG;IACH,OAAO,CAAC,2BAA2B;IAoBnC;;OAEG;IACH,OAAO,CAAC,qBAAqB;IA0B7B;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAS9B;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAe7B;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAqDxB;;OAEG;IACH,OAAO,CAAC,YAAY;CAKrB"}