@sharpee/stdlib 0.9.66-beta → 0.9.69-beta

package/actions/constants.d.ts

@@ -0,0 +1,82 @@
+/**
+ * Standard Interactive Fiction action identifiers
+ *
+ * These are the common verbs/actions that players can perform
+ */
+export declare const ActionIDs: {
+    readonly GOING: "if.action.going";
+    readonly LOOKING: "if.action.looking";
+    readonly EXAMINING: "if.action.examining";
+    readonly TAKING: "if.action.taking";
+    readonly DROPPING: "if.action.dropping";
+    readonly OPENING: "if.action.opening";
+    readonly INVENTORY: "if.action.inventory";
+};
+export declare const IFActions: {
+    readonly GOING: "if.action.going";
+    readonly ENTERING: "if.action.entering";
+    readonly EXITING: "if.action.exiting";
+    readonly CLIMBING: "if.action.climbing";
+    readonly JUMPING: "if.action.jumping";
+    readonly LOOKING: "if.action.looking";
+    readonly EXAMINING: "if.action.examining";
+    readonly SEARCHING: "if.action.searching";
+    readonly LOOKING_UNDER: "if.action.looking_under";
+    readonly LOOKING_BEHIND: "if.action.looking_behind";
+    readonly LISTENING: "if.action.listening";
+    readonly SMELLING: "if.action.smelling";
+    readonly TOUCHING: "if.action.touching";
+    readonly TASTING: "if.action.tasting";
+    readonly TAKING: "if.action.taking";
+    readonly DROPPING: "if.action.dropping";
+    readonly PUTTING: "if.action.putting";
+    readonly INSERTING: "if.action.inserting";
+    readonly REMOVING: "if.action.removing";
+    readonly THROWING: "if.action.throwing";
+    readonly OPENING: "if.action.opening";
+    readonly CLOSING: "if.action.closing";
+    readonly EMPTYING: "if.action.emptying";
+    readonly LOCKING: "if.action.locking";
+    readonly UNLOCKING: "if.action.unlocking";
+    readonly WEARING: "if.action.wearing";
+    readonly TAKING_OFF: "if.action.taking_off";
+    readonly SWITCHING_ON: "if.action.switching_on";
+    readonly SWITCHING_OFF: "if.action.switching_off";
+    readonly PUSHING: "if.action.pushing";
+    readonly PULLING: "if.action.pulling";
+    readonly TURNING: "if.action.turning";
+    readonly SETTING: "if.action.setting";
+    readonly EATING: "if.action.eating";
+    readonly DRINKING: "if.action.drinking";
+    readonly TALKING: "if.action.talking";
+    readonly ASKING: "if.action.asking";
+    readonly TELLING: "if.action.telling";
+    readonly ANSWERING: "if.action.answering";
+    readonly SHOWING: "if.action.showing";
+    readonly GIVING: "if.action.giving";
+    readonly ATTACKING: "if.action.attacking";
+    readonly KISSING: "if.action.kissing";
+    readonly WAVING: "if.action.waving";
+    readonly LOWERING: "if.action.lowering";
+    readonly RAISING: "if.action.raising";
+    readonly CONSULTING: "if.action.consulting";
+    readonly READING: "if.action.reading";
+    readonly INVENTORY: "if.action.inventory";
+    readonly WAITING: "if.action.waiting";
+    readonly SLEEPING: "if.action.sleeping";
+    readonly WAKING: "if.action.waking";
+    readonly SAVING: "if.action.saving";
+    readonly RESTORING: "if.action.restoring";
+    readonly RESTARTING: "if.action.restarting";
+    readonly QUITTING: "if.action.quitting";
+    readonly UNDOING: "if.action.undoing";
+    readonly AGAIN: "if.action.again";
+    readonly SCORING: "if.action.scoring";
+    readonly VERIFYING: "if.action.verifying";
+    readonly VERSION: "if.action.version";
+    readonly HELP: "if.action.help";
+    readonly HINTS: "if.action.hints";
+    readonly ABOUT: "if.action.about";
+};
+export type IFActionType = typeof IFActions[keyof typeof IFActions];
+//# sourceMappingURL=constants.d.ts.map

package/actions/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../../../../mnt/c/repotemp/sharpee/packages/stdlib/src/actions/constants.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,eAAO,MAAM,SAAS;;;;;;;;CAiBZ,CAAC;AAEX,eAAO,MAAM,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA4FZ,CAAC;AAEX,MAAM,MAAM,YAAY,GAAG,OAAO,SAAS,CAAC,MAAM,OAAO,SAAS,CAAC,CAAC"}

package/actions/constants.js

@@ -0,0 +1,104 @@
+"use strict";
+/**
+ * Standard Interactive Fiction action identifiers
+ *
+ * These are the common verbs/actions that players can perform
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.IFActions = exports.ActionIDs = void 0;
+exports.ActionIDs = {
+    // Movement actions
+    GOING: 'if.action.going',
+    // Observation actions
+    LOOKING: 'if.action.looking',
+    EXAMINING: 'if.action.examining',
+    // Object manipulation
+    TAKING: 'if.action.taking',
+    DROPPING: 'if.action.dropping',
+    // Container/supporter actions
+    OPENING: 'if.action.opening',
+    // Meta actions
+    INVENTORY: 'if.action.inventory',
+};
+exports.IFActions = {
+    // Movement actions
+    GOING: 'if.action.going',
+    ENTERING: 'if.action.entering',
+    EXITING: 'if.action.exiting',
+    CLIMBING: 'if.action.climbing',
+    JUMPING: 'if.action.jumping',
+    // Observation actions
+    LOOKING: 'if.action.looking',
+    EXAMINING: 'if.action.examining',
+    SEARCHING: 'if.action.searching',
+    LOOKING_UNDER: 'if.action.looking_under',
+    LOOKING_BEHIND: 'if.action.looking_behind',
+    LISTENING: 'if.action.listening',
+    SMELLING: 'if.action.smelling',
+    TOUCHING: 'if.action.touching',
+    TASTING: 'if.action.tasting',
+    // Object manipulation
+    TAKING: 'if.action.taking',
+    DROPPING: 'if.action.dropping',
+    PUTTING: 'if.action.putting',
+    INSERTING: 'if.action.inserting',
+    REMOVING: 'if.action.removing',
+    THROWING: 'if.action.throwing',
+    // Container/supporter actions
+    OPENING: 'if.action.opening',
+    CLOSING: 'if.action.closing',
+    EMPTYING: 'if.action.emptying',
+    // Lock/unlock actions
+    LOCKING: 'if.action.locking',
+    UNLOCKING: 'if.action.unlocking',
+    // Wearing actions
+    WEARING: 'if.action.wearing',
+    TAKING_OFF: 'if.action.taking_off',
+    // Device actions
+    SWITCHING_ON: 'if.action.switching_on',
+    SWITCHING_OFF: 'if.action.switching_off',
+    PUSHING: 'if.action.pushing',
+    PULLING: 'if.action.pulling',
+    TURNING: 'if.action.turning',
+    SETTING: 'if.action.setting',
+    // Consumption actions
+    EATING: 'if.action.eating',
+    DRINKING: 'if.action.drinking',
+    // Communication actions
+    TALKING: 'if.action.talking',
+    ASKING: 'if.action.asking',
+    TELLING: 'if.action.telling',
+    ANSWERING: 'if.action.answering',
+    SHOWING: 'if.action.showing',
+    GIVING: 'if.action.giving',
+    // Combat/interaction actions
+    ATTACKING: 'if.action.attacking',
+    KISSING: 'if.action.kissing',
+    WAVING: 'if.action.waving',
+    // Capability-dispatch actions (ADR-090)
+    // These dispatch to trait behaviors instead of having fixed semantics
+    LOWERING: 'if.action.lowering',
+    RAISING: 'if.action.raising',
+    // Using actions
+    // USING: 'if.action.using', // Removed - USE is not idiomatic IF
+    CONSULTING: 'if.action.consulting',
+    READING: 'if.action.reading',
+    // Meta actions
+    INVENTORY: 'if.action.inventory',
+    WAITING: 'if.action.waiting',
+    SLEEPING: 'if.action.sleeping',
+    WAKING: 'if.action.waking',
+    SAVING: 'if.action.saving',
+    RESTORING: 'if.action.restoring',
+    RESTARTING: 'if.action.restarting',
+    QUITTING: 'if.action.quitting',
+    UNDOING: 'if.action.undoing',
+    AGAIN: 'if.action.again',
+    SCORING: 'if.action.scoring',
+    VERIFYING: 'if.action.verifying',
+    VERSION: 'if.action.version',
+    HELP: 'if.action.help',
+    HINTS: 'if.action.hints',
+    ABOUT: 'if.action.about',
+};
+//# sourceMappingURL=constants.js.map

package/actions/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../../../../../../../mnt/c/repotemp/sharpee/packages/stdlib/src/actions/constants.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;AAEU,QAAA,SAAS,GAAG;IACvB,mBAAmB;IACnB,KAAK,EAAE,iBAAiB;IAExB,sBAAsB;IACtB,OAAO,EAAE,mBAAmB;IAC5B,SAAS,EAAE,qBAAqB;IAEhC,sBAAsB;IACtB,MAAM,EAAE,kBAAkB;IAC1B,QAAQ,EAAE,oBAAoB;IAE9B,8BAA8B;IAC9B,OAAO,EAAE,mBAAmB;IAE5B,eAAe;IACf,SAAS,EAAE,qBAAqB;CACxB,CAAC;AAEE,QAAA,SAAS,GAAG;IACvB,mBAAmB;IACnB,KAAK,EAAE,iBAAiB;IACxB,QAAQ,EAAE,oBAAoB;IAC9B,OAAO,EAAE,mBAAmB;IAC5B,QAAQ,EAAE,oBAAoB;IAC9B,OAAO,EAAE,mBAAmB;IAE5B,sBAAsB;IACtB,OAAO,EAAE,mBAAmB;IAC5B,SAAS,EAAE,qBAAqB;IAChC,SAAS,EAAE,qBAAqB;IAChC,aAAa,EAAE,yBAAyB;IACxC,cAAc,EAAE,0BAA0B;IAC1C,SAAS,EAAE,qBAAqB;IAChC,QAAQ,EAAE,oBAAoB;IAC9B,QAAQ,EAAE,oBAAoB;IAC9B,OAAO,EAAE,mBAAmB;IAE5B,sBAAsB;IACtB,MAAM,EAAE,kBAAkB;IAC1B,QAAQ,EAAE,oBAAoB;IAC9B,OAAO,EAAE,mBAAmB;IAC5B,SAAS,EAAE,qBAAqB;IAChC,QAAQ,EAAE,oBAAoB;IAC9B,QAAQ,EAAE,oBAAoB;IAE9B,8BAA8B;IAC9B,OAAO,EAAE,mBAAmB;IAC5B,OAAO,EAAE,mBAAmB;IAC5B,QAAQ,EAAE,oBAAoB;IAE9B,sBAAsB;IACtB,OAAO,EAAE,mBAAmB;IAC5B,SAAS,EAAE,qBAAqB;IAEhC,kBAAkB;IAClB,OAAO,EAAE,mBAAmB;IAC5B,UAAU,EAAE,sBAAsB;IAElC,iBAAiB;IACjB,YAAY,EAAE,wBAAwB;IACtC,aAAa,EAAE,yBAAyB;IACxC,OAAO,EAAE,mBAAmB;IAC5B,OAAO,EAAE,mBAAmB;IAC5B,OAAO,EAAE,mBAAmB;IAC5B,OAAO,EAAE,mBAAmB;IAE5B,sBAAsB;IACtB,MAAM,EAAE,kBAAkB;IAC1B,QAAQ,EAAE,oBAAoB;IAE9B,wBAAwB;IACxB,OAAO,EAAE,mBAAmB;IAC5B,MAAM,EAAE,kBAAkB;IAC1B,OAAO,EAAE,mBAAmB;IAC5B,SAAS,EAAE,qBAAqB;IAChC,OAAO,EAAE,mBAAmB;IAC5B,MAAM,EAAE,kBAAkB;IAE1B,6BAA6B;IAC7B,SAAS,EAAE,qBAAqB;IAChC,OAAO,EAAE,mBAAmB;IAC5B,MAAM,EAAE,kBAAkB;IAE1B,wCAAwC;IACxC,sEAAsE;IACtE,QAAQ,EAAE,oBAAoB;IAC9B,OAAO,EAAE,mBAAmB;IAE5B,gBAAgB;IAChB,iEAAiE;IACjE,UAAU,EAAE,sBAAsB;IAClC,OAAO,EAAE,mBAAmB;IAE5B,eAAe;IACf,SAAS,EAAE,qBAAqB;IAChC,OAAO,EAAE,mBAAmB;IAC5B,QAAQ,EAAE,oBAAoB;IAC9B,MAAM,EAAE,kBAAkB;IAC1B,MAAM,EAAE,kBAAkB;IAC1B,SAAS,EAAE,qBAAqB;IAChC,UAAU,EAAE,sBAAsB;IAClC,QAAQ,EAAE,oBAAoB;IAC9B,OAAO,EAAE,mBAAmB;IAC5B,KAAK,EAAE,iBAAiB;IACxB,OAAO,EAAE,mBAAmB;IAC5B,SAAS,EAAE,qBAAqB;IAChC,OAAO,EAAE,mBAAmB;IAC5B,IAAI,EAAE,gBAAgB;IACtB,KAAK,EAAE,iBAAiB;IACxB,KAAK,EAAE,iBAAiB;CAChB,CAAC"}

package/actions/context-adapter.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Context adapter to bridge between stdlib's rich context and if-domain's contracts
+ *
+ * This adapter converts between:
+ * - ValidatedCommand (with parser internals) → CommandInput (simple contract)
+ * - ActionContext (stdlib implementation) → IActionContext (if-domain contract)
+ */
+import { ISemanticEvent } from "../src/index";
+import { CommandInput, IActionContext, IAction } from "../src/index";
+import { IFEntity } from "../src/index";
+import { ValidatedCommand } from '../validation/types';
+import { ActionContext, Action } from './enhanced-types';
+/**
+ * Convert a ValidatedCommand to the simpler CommandInput
+ */
+export declare function toCommandInput(validated: ValidatedCommand): CommandInput;
+/**
+ * Adapter that makes stdlib's ActionContext implement if-domain's IActionContext
+ */
+export declare class ActionContextAdapter implements IActionContext {
+    private context;
+    readonly command: CommandInput;
+    readonly action: IAction;
+    constructor(context: ActionContext, action: Action);
+    get player(): IFEntity;
+    get currentLocation(): IFEntity;
+    canSee(entity: IFEntity): boolean;
+    canReach(entity: IFEntity): boolean;
+    canTake(entity: IFEntity): boolean;
+    isInScope(entity: IFEntity): boolean;
+    getVisible(): IFEntity[];
+    getInScope(): IFEntity[];
+    getEntity(entityId: string): IFEntity | undefined;
+    getEntityLocation(entityId: string): string | undefined;
+    getEntityContents(entityId: string): IFEntity[];
+    getContainingRoom(entityId: string): IFEntity | undefined;
+    getWorldCapability(name: string): any;
+    moveEntity(entityId: string, newLocationId: string): boolean;
+    event(type: string, data: any): ISemanticEvent;
+}
+/**
+ * Create an if-domain compliant context from stdlib context
+ */
+export declare function createDomainContext(context: ActionContext, action: Action): IActionContext;
+//# sourceMappingURL=context-adapter.d.ts.map

package/actions/context-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-adapter.d.ts","sourceRoot":"","sources":["../../../../../../mnt/c/repotemp/sharpee/packages/stdlib/src/actions/context-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EACL,YAAY,EAEZ,cAAc,EACd,OAAO,EAER,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,QAAQ,EAAc,MAAM,sBAAsB,CAAC;AAC5D,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAGzD;;GAEG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,gBAAgB,GAAG,YAAY,CA8BxE;AAED;;GAEG;AACH,qBAAa,oBAAqB,YAAW,cAAc;IAKvD,OAAO,CAAC,OAAO;IAJjB,QAAQ,CAAC,OAAO,EAAE,YAAY,CAAC;IAC/B,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;gBAGf,OAAO,EAAE,aAAa,EAC9B,MAAM,EAAE,MAAM;IAMhB,IAAI,MAAM,IAAI,QAAQ,CAErB;IAED,IAAI,eAAe,IAAI,QAAQ,CAE9B;IAED,MAAM,CAAC,MAAM,EAAE,QAAQ,GAAG,OAAO;IAIjC,QAAQ,CAAC,MAAM,EAAE,QAAQ,GAAG,OAAO;IAInC,OAAO,CAAC,MAAM,EAAE,QAAQ,GAAG,OAAO;IAIlC,SAAS,CAAC,MAAM,EAAE,QAAQ,GAAG,OAAO;IAIpC,UAAU,IAAI,QAAQ,EAAE;IAIxB,UAAU,IAAI,QAAQ,EAAE;IAIxB,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS;IAIjD,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAIvD,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,QAAQ,EAAE;IAI/C,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS;IAIzD,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,GAAG;IAIrC,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,OAAO;IAM5D,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,GAAG,cAAc;CAG/C;AAgDD;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,aAAa,EACtB,MAAM,EAAE,MAAM,GACb,cAAc,CAEhB"}

package/actions/context-adapter.js

@@ -0,0 +1,152 @@
+"use strict";
+/**
+ * Context adapter to bridge between stdlib's rich context and if-domain's contracts
+ *
+ * This adapter converts between:
+ * - ValidatedCommand (with parser internals) → CommandInput (simple contract)
+ * - ActionContext (stdlib implementation) → IActionContext (if-domain contract)
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ActionContextAdapter = void 0;
+exports.toCommandInput = toCommandInput;
+exports.createDomainContext = createDomainContext;
+/**
+ * Convert a ValidatedCommand to the simpler CommandInput
+ */
+function toCommandInput(validated) {
+    const input = {
+        actionId: validated.actionId,
+        inputText: validated.parsed.rawInput
+    };
+    // Convert direct object if present
+    if (validated.directObject) {
+        input.directObject = {
+            entity: validated.directObject.entity,
+            matchedText: validated.directObject.parsed.text,
+            referenceType: 'definite' // TODO: extract from parsed tokens
+        };
+    }
+    // Convert indirect object if present
+    if (validated.indirectObject) {
+        input.indirectObject = {
+            entity: validated.indirectObject.entity,
+            matchedText: validated.indirectObject.parsed.text,
+            referenceType: 'definite' // TODO: extract from parsed tokens
+        };
+    }
+    // Extract preposition if present
+    if (validated.parsed.structure?.preposition) {
+        input.preposition = validated.parsed.structure.preposition.text;
+    }
+    return input;
+}
+/**
+ * Adapter that makes stdlib's ActionContext implement if-domain's IActionContext
+ */
+class ActionContextAdapter {
+    context;
+    command;
+    action;
+    constructor(context, action) {
+        this.context = context;
+        this.command = toCommandInput(context.command);
+        this.action = new ActionAdapter(action);
+    }
+    get player() {
+        return this.context.player;
+    }
+    get currentLocation() {
+        return this.context.currentLocation;
+    }
+    canSee(entity) {
+        return this.context.canSee(entity);
+    }
+    canReach(entity) {
+        return this.context.canReach(entity);
+    }
+    canTake(entity) {
+        return this.context.canTake(entity);
+    }
+    isInScope(entity) {
+        return this.context.isInScope(entity);
+    }
+    getVisible() {
+        return this.context.getVisible();
+    }
+    getInScope() {
+        return this.context.getInScope();
+    }
+    getEntity(entityId) {
+        return this.context.world.getEntity(entityId);
+    }
+    getEntityLocation(entityId) {
+        return this.context.world.getLocation(entityId);
+    }
+    getEntityContents(entityId) {
+        return this.context.world.getContents(entityId);
+    }
+    getContainingRoom(entityId) {
+        return this.context.world.getContainingRoom(entityId);
+    }
+    getWorldCapability(name) {
+        return this.context.world.getCapability(name);
+    }
+    moveEntity(entityId, newLocationId) {
+        // This would need to emit an event, but for now return false
+        // as actions shouldn't directly mutate state
+        return false;
+    }
+    event(type, data) {
+        return this.context.event(type, data);
+    }
+}
+exports.ActionContextAdapter = ActionContextAdapter;
+/**
+ * Adapter that makes stdlib's Action implement if-domain's IAction
+ */
+class ActionAdapter {
+    action;
+    constructor(action) {
+        this.action = action;
+    }
+    get id() {
+        return this.action.id;
+    }
+    validate(context) {
+        // Convert IActionContext back to ActionContext for the stdlib action
+        // This is a bit circular but necessary for the adapter pattern
+        // In practice, we'd pass through the original context
+        return this.action.validate(context);
+    }
+    execute(context) {
+        // Similar conversion for execute
+        const result = this.action.execute(context);
+        // Handle both old pattern (returns events) and new pattern (returns void)
+        if (result === undefined || result === null) {
+            // New pattern: execute returned void, call report if available
+            if ('report' in this.action && typeof this.action.report === 'function') {
+                return this.action.report(context);
+            }
+            // If no report method, return empty array
+            return [];
+        }
+        // Old pattern: execute returned events
+        return result;
+    }
+    get requiredMessages() {
+        return this.action.requiredMessages;
+    }
+    get descriptionMessageId() {
+        return this.action.descriptionMessageId;
+    }
+    get examplesMessageId() {
+        return this.action.examplesMessageId;
+    }
+}
+/**
+ * Create an if-domain compliant context from stdlib context
+ */
+function createDomainContext(context, action) {
+    return new ActionContextAdapter(context, action);
+}
+//# sourceMappingURL=context-adapter.js.map

package/actions/context-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-adapter.js","sourceRoot":"","sources":["../../../../../../../../../mnt/c/repotemp/sharpee/packages/stdlib/src/actions/context-adapter.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;AAkBH,wCA8BC;AAiID,kDAKC;AAvKD;;GAEG;AACH,SAAgB,cAAc,CAAC,SAA2B;IACxD,MAAM,KAAK,GAAiB;QAC1B,QAAQ,EAAE,SAAS,CAAC,QAAQ;QAC5B,SAAS,EAAE,SAAS,CAAC,MAAM,CAAC,QAAQ;KACrC,CAAC;IAEF,mCAAmC;IACnC,IAAI,SAAS,CAAC,YAAY,EAAE,CAAC;QAC3B,KAAK,CAAC,YAAY,GAAG;YACnB,MAAM,EAAE,SAAS,CAAC,YAAY,CAAC,MAAM;YACrC,WAAW,EAAE,SAAS,CAAC,YAAY,CAAC,MAAM,CAAC,IAAI;YAC/C,aAAa,EAAE,UAAU,CAAC,mCAAmC;SAC9D,CAAC;IACJ,CAAC;IAED,qCAAqC;IACrC,IAAI,SAAS,CAAC,cAAc,EAAE,CAAC;QAC7B,KAAK,CAAC,cAAc,GAAG;YACrB,MAAM,EAAE,SAAS,CAAC,cAAc,CAAC,MAAM;YACvC,WAAW,EAAE,SAAS,CAAC,cAAc,CAAC,MAAM,CAAC,IAAI;YACjD,aAAa,EAAE,UAAU,CAAC,mCAAmC;SAC9D,CAAC;IACJ,CAAC;IAED,iCAAiC;IACjC,IAAI,SAAS,CAAC,MAAM,CAAC,SAAS,EAAE,WAAW,EAAE,CAAC;QAC5C,KAAK,CAAC,WAAW,GAAG,SAAS,CAAC,MAAM,CAAC,SAAS,CAAC,WAAW,CAAC,IAAI,CAAC;IAClE,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;GAEG;AACH,MAAa,oBAAoB;IAKrB;IAJD,OAAO,CAAe;IACtB,MAAM,CAAU;IAEzB,YACU,OAAsB,EAC9B,MAAc;QADN,YAAO,GAAP,OAAO,CAAe;QAG9B,IAAI,CAAC,OAAO,GAAG,cAAc,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QAC/C,IAAI,CAAC,MAAM,GAAG,IAAI,aAAa,CAAC,MAAM,CAAC,CAAC;IAC1C,CAAC;IAED,IAAI,MAAM;QACR,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC;IAC7B,CAAC;IAED,IAAI,eAAe;QACjB,OAAO,IAAI,CAAC,OAAO,CAAC,eAAe,CAAC;IACtC,CAAC;IAED,MAAM,CAAC,MAAgB;QACrB,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IACrC,CAAC;IAED,QAAQ,CAAC,MAAgB;QACvB,OAAO,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IACvC,CAAC;IAED,OAAO,CAAC,MAAgB;QACtB,OAAO,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IACtC,CAAC;IAED,SAAS,CAAC,MAAgB;QACxB,OAAO,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IACxC,CAAC;IAED,UAAU;QACR,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC;IACnC,CAAC;IAED,UAAU;QACR,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC;IACnC,CAAC;IAED,SAAS,CAAC,QAAgB;QACxB,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;IAChD,CAAC;IAED,iBAAiB,CAAC,QAAgB;QAChC,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;IAClD,CAAC;IAED,iBAAiB,CAAC,QAAgB;QAChC,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;IAClD,CAAC;IAED,iBAAiB,CAAC,QAAgB;QAChC,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,iBAAiB,CAAC,QAAQ,CAAC,CAAC;IACxD,CAAC;IAED,kBAAkB,CAAC,IAAY;QAC7B,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;IAChD,CAAC;IAED,UAAU,CAAC,QAAgB,EAAE,aAAqB;QAChD,6DAA6D;QAC7D,6CAA6C;QAC7C,OAAO,KAAK,CAAC;IACf,CAAC;IAED,KAAK,CAAC,IAAY,EAAE,IAAS;QAC3B,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IACxC,CAAC;CACF;AAzED,oDAyEC;AAED;;GAEG;AACH,MAAM,aAAa;IACG;IAApB,YAAoB,MAAc;QAAd,WAAM,GAAN,MAAM,CAAQ;IAAG,CAAC;IAEtC,IAAI,EAAE;QACJ,OAAO,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;IACxB,CAAC;IAED,QAAQ,CAAC,OAAuB;QAC9B,qEAAqE;QACrE,+DAA+D;QAC/D,sDAAsD;QACtD,OAAO,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAc,CAAC,CAAC;IAC9C,CAAC;IAED,OAAO,CAAC,OAAuB;QAC7B,iCAAiC;QACjC,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,OAAc,CAAC,CAAC;QACnD,0EAA0E;QAC1E,IAAI,MAAM,KAAK,SAAS,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;YAC5C,+DAA+D;YAC/D,IAAI,QAAQ,IAAI,IAAI,CAAC,MAAM,IAAI,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,KAAK,UAAU,EAAE,CAAC;gBACxE,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,OAAc,CAAC,CAAC;YAC5C,CAAC;YACD,0CAA0C;YAC1C,OAAO,EAAE,CAAC;QACZ,CAAC;QACD,uCAAuC;QACvC,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,IAAI,gBAAgB;QAClB,OAAO,IAAI,CAAC,MAAM,CAAC,gBAAgB,CAAC;IACtC,CAAC;IAED,IAAI,oBAAoB;QACtB,OAAO,IAAI,CAAC,MAAM,CAAC,oBAAoB,CAAC;IAC1C,CAAC;IAED,IAAI,iBAAiB;QACnB,OAAO,IAAI,CAAC,MAAM,CAAC,iBAAiB,CAAC;IACvC,CAAC;CACF;AAED;;GAEG;AACH,SAAgB,mBAAmB,CACjC,OAAsB,EACtB,MAAc;IAEd,OAAO,IAAI,oBAAoB,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;AACnD,CAAC"}

package/actions/context.d.ts

@@ -0,0 +1,95 @@
+/**
+ * Read-only action context implementation
+ *
+ * Provides query methods for actions without allowing state mutations
+ */
+import { IFEntity, WorldModel, ICapabilityData, IValidatedCommand } from "../src/index";
+import { ActionContext, Action, ScopeCheckResult, ImplicitTakeResult } from './enhanced-types';
+import { ISemanticEvent } from "../src/index";
+import { ScopeResolver, ScopeLevel } from '../scope/types';
+/**
+ * @deprecated Use createActionContext from enhanced-context.ts instead
+ * This class is kept for backward compatibility but will be removed in Phase 4
+ */
+export declare class ReadOnlyActionContext implements ActionContext {
+    readonly world: WorldModel;
+    readonly player: IFEntity;
+    readonly currentLocation: IFEntity;
+    readonly command: IValidatedCommand;
+    readonly action: Action;
+    readonly scopeResolver: ScopeResolver;
+    sharedData: Record<string, any>;
+    constructor(world: WorldModel, player: IFEntity, currentLocation: IFEntity, command: IValidatedCommand, action?: Action, scopeResolver?: ScopeResolver);
+    /**
+     * Check if an entity is visible to the player
+     */
+    canSee(entity: IFEntity): boolean;
+    /**
+     * Check if an entity is physically reachable by the player
+     *
+     * An entity is reachable if:
+     * 1. It's in the same location as the player
+     * 2. It's held by the player
+     * 3. It's in an open container in the same location
+     * 4. It's on a supporter in the same location
+     */
+    canReach(entity: IFEntity): boolean;
+    /**
+     * Check if an entity can be taken by the player
+     *
+     * An entity can be taken if:
+     * 1. It's visible
+     * 2. It's reachable
+     * 3. It's not a room
+     * 4. It's not scenery (fixed in place)
+     * 5. It's not already held by the player
+     */
+    canTake(entity: IFEntity): boolean;
+    /**
+     * Check if an entity is in scope for the player
+     */
+    isInScope(entity: IFEntity): boolean;
+    /**
+     * Get all entities visible to the player
+     */
+    getVisible(): IFEntity[];
+    /**
+     * Get all entities in scope for the player
+     */
+    getInScope(): IFEntity[];
+    /**
+     * Get capability data (convenience method)
+     */
+    getCapability(name: string): ICapabilityData | undefined;
+    /**
+     * Event creation method (required by ActionContext interface)
+     * @deprecated This implementation throws an error - use createActionContext instead
+     */
+    event(type: string, data: any): ISemanticEvent;
+    /**
+     * Get the scope level for an entity.
+     * @deprecated This implementation returns basic scope levels - use createActionContext instead
+     */
+    getEntityScope(entity: IFEntity): ScopeLevel;
+    /**
+     * Get the scope level for an entity in a command slot.
+     * @deprecated This implementation returns basic scope levels - use createActionContext instead
+     */
+    getSlotScope(slot: string): ScopeLevel;
+    /**
+     * Check if an entity meets a required scope level.
+     * @deprecated This implementation is basic - use createActionContext instead
+     */
+    requireScope(entity: IFEntity, required: ScopeLevel): ScopeCheckResult;
+    /**
+     * Check if a command slot entity meets a required scope level.
+     * @deprecated This implementation is basic - use createActionContext instead
+     */
+    requireSlotScope(slot: string, required: ScopeLevel): ScopeCheckResult;
+    /**
+     * Check if an entity is carried, attempting implicit take if needed.
+     * @deprecated This implementation throws an error - use createActionContext instead
+     */
+    requireCarriedOrImplicitTake(_entity: IFEntity): ImplicitTakeResult;
+}
+//# sourceMappingURL=context.d.ts.map

package/actions/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../../../../../mnt/c/repotemp/sharpee/packages/stdlib/src/actions/context.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAChG,OAAO,EAAE,aAAa,EAAE,MAAM,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAC/F,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAE3D;;;GAGG;AACH,qBAAa,qBAAsB,YAAW,aAAa;aAMvC,KAAK,EAAE,UAAU;aACjB,MAAM,EAAE,QAAQ;aAChB,eAAe,EAAE,QAAQ;aACzB,OAAO,EAAE,iBAAiB;IAR5C,SAAgB,MAAM,EAAE,MAAM,CAAC;IAC/B,SAAgB,aAAa,EAAE,aAAa,CAAC;IACtC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAM;gBAG1B,KAAK,EAAE,UAAU,EACjB,MAAM,EAAE,QAAQ,EAChB,eAAe,EAAE,QAAQ,EACzB,OAAO,EAAE,iBAAiB,EAC1C,MAAM,CAAC,EAAE,MAAM,EACf,aAAa,CAAC,EAAE,aAAa;IAW/B;;OAEG;IACH,MAAM,CAAC,MAAM,EAAE,QAAQ,GAAG,OAAO;IAIjC;;;;;;;;OAQG;IACH,QAAQ,CAAC,MAAM,EAAE,QAAQ,GAAG,OAAO;IAmDnC;;;;;;;;;OASG;IACH,OAAO,CAAC,MAAM,EAAE,QAAQ,GAAG,OAAO;IA8BlC;;OAEG;IACH,SAAS,CAAC,MAAM,EAAE,QAAQ,GAAG,OAAO;IAKpC;;OAEG;IACH,UAAU,IAAI,QAAQ,EAAE;IAIxB;;OAEG;IACH,UAAU,IAAI,QAAQ,EAAE;IAIxB;;OAEG;IACH,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS;IAIxD;;;OAGG;IACH,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,GAAG,cAAc;IAQ9C;;;OAGG;IACH,cAAc,CAAC,MAAM,EAAE,QAAQ,GAAG,UAAU;IAuB5C;;;OAGG;IACH,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU;IAmBtC;;;OAGG;IACH,YAAY,CAAC,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,UAAU,GAAG,gBAAgB;IA8BtE;;;OAGG;IACH,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,UAAU,GAAG,gBAAgB;IA0BtE;;;OAGG;IACH,4BAA4B,CAAC,OAAO,EAAE,QAAQ,GAAG,kBAAkB;CAGpE"}