@sharpee/plugin-state-machine 0.9.66-beta → 0.9.67-beta

package/effect-executor.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Effect Executor - applies state machine effects to the world model.
+ */
+import { EntityId, ISemanticEvent } from "./src/index";
+import { WorldModel } from "./src/index";
+import { Effect, EntityBindings } from './types';
+export declare function executeEffects(effects: Effect[], world: WorldModel, bindings: EntityBindings, playerId: EntityId, machineId: string): ISemanticEvent[];
+//# sourceMappingURL=effect-executor.d.ts.map

package/effect-executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"effect-executor.d.ts","sourceRoot":"","sources":["../../../../../mnt/c/repotemp/sharpee/packages/plugin-state-machine/src/effect-executor.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AACzD,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAKjD,wBAAgB,cAAc,CAC5B,OAAO,EAAE,MAAM,EAAE,EACjB,KAAK,EAAE,UAAU,EACjB,QAAQ,EAAE,cAAc,EACxB,QAAQ,EAAE,QAAQ,EAClB,SAAS,EAAE,MAAM,GAChB,cAAc,EAAE,CASlB"}

package/effect-executor.js

@@ -0,0 +1,106 @@
+"use strict";
+/**
+ * Effect Executor - applies state machine effects to the world model.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.executeEffects = executeEffects;
+const guard_evaluator_1 = require("./guard-evaluator");
+let eventCounter = 0;
+function executeEffects(effects, world, bindings, playerId, machineId) {
+    const events = [];
+    for (const effect of effects) {
+        const result = executeEffect(effect, world, bindings, playerId, machineId);
+        events.push(...result);
+    }
+    return events;
+}
+function executeEffect(effect, world, bindings, playerId, machineId) {
+    switch (effect.type) {
+        case 'move': {
+            const entityId = (0, guard_evaluator_1.resolveRef)(effect.entityRef, bindings);
+            const destId = (0, guard_evaluator_1.resolveRef)(effect.destinationRef, bindings);
+            world.moveEntity(entityId, destId);
+            return [createEvent(`sm.entity_moved`, machineId, {
+                    entityId,
+                    destination: destId,
+                })];
+        }
+        case 'remove': {
+            const entityId = (0, guard_evaluator_1.resolveRef)(effect.entityRef, bindings);
+            world.removeEntity(entityId);
+            return [createEvent(`sm.entity_removed`, machineId, { entityId })];
+        }
+        case 'set_trait': {
+            const entityId = (0, guard_evaluator_1.resolveRef)(effect.entityRef, bindings);
+            const entity = world.getEntity(entityId);
+            if (entity) {
+                const trait = entity.getTrait(effect.trait);
+                if (trait) {
+                    trait[effect.property] = effect.value;
+                }
+            }
+            return [];
+        }
+        case 'set_state': {
+            world.setStateValue(effect.key, effect.value);
+            return [];
+        }
+        case 'message': {
+            return [createEvent(effect.messageId, machineId, {
+                    ...(effect.params || {}),
+                    source: 'state-machine',
+                })];
+        }
+        case 'emit_event': {
+            const entities = {};
+            if (effect.entities) {
+                for (const [role, ref] of Object.entries(effect.entities)) {
+                    if (ref)
+                        entities[role] = (0, guard_evaluator_1.resolveRef)(ref, bindings);
+                }
+            }
+            return [{
+                    id: `sm-event-${++eventCounter}`,
+                    type: effect.eventType,
+                    timestamp: Date.now(),
+                    entities,
+                    data: effect.data,
+                }];
+        }
+        case 'custom': {
+            const result = effect.execute(world, bindings, playerId);
+            const events = [];
+            if (result.events) {
+                for (const e of result.events) {
+                    events.push({
+                        id: `sm-custom-${++eventCounter}`,
+                        type: e.type,
+                        timestamp: Date.now(),
+                        entities: (e.entities || {}),
+                        data: e.data,
+                    });
+                }
+            }
+            if (result.messages) {
+                for (const m of result.messages) {
+                    events.push(createEvent(m.messageId, machineId, {
+                        ...(m.params || {}),
+                        source: 'state-machine',
+                    }));
+                }
+            }
+            return events;
+        }
+    }
+}
+function createEvent(type, machineId, data) {
+    return {
+        id: `sm-${++eventCounter}`,
+        type,
+        timestamp: Date.now(),
+        entities: {},
+        data,
+        tags: ['state-machine', machineId],
+    };
+}
+//# sourceMappingURL=effect-executor.js.map

package/effect-executor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"effect-executor.js","sourceRoot":"","sources":["../../../../../../../../mnt/c/repotemp/sharpee/packages/plugin-state-machine/src/effect-executor.ts"],"names":[],"mappings":"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"}

package/guard-evaluator.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Guard Evaluator - evaluates guard conditions against world state.
+ */
+import { EntityId } from "./src/index";
+import { WorldModel } from "./src/index";
+import { GuardCondition, EntityBindings } from './types';
+export declare function evaluateGuard(guard: GuardCondition, world: WorldModel, bindings: EntityBindings, playerId: EntityId): boolean;
+export declare function resolveRef(ref: string, bindings: EntityBindings): EntityId;
+//# sourceMappingURL=guard-evaluator.d.ts.map

package/guard-evaluator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"guard-evaluator.d.ts","sourceRoot":"","sources":["../../../../../mnt/c/repotemp/sharpee/packages/plugin-state-machine/src/guard-evaluator.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,EACL,cAAc,EACd,cAAc,EACf,MAAM,SAAS,CAAC;AAEjB,wBAAgB,aAAa,CAC3B,KAAK,EAAE,cAAc,EACrB,KAAK,EAAE,UAAU,EACjB,QAAQ,EAAE,cAAc,EACxB,QAAQ,EAAE,QAAQ,GACjB,OAAO,CAmBT;AAuCD,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,cAAc,GAAG,QAAQ,CAS1E"}

package/guard-evaluator.js

@@ -0,0 +1,58 @@
+"use strict";
+/**
+ * Guard Evaluator - evaluates guard conditions against world state.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.evaluateGuard = evaluateGuard;
+exports.resolveRef = resolveRef;
+function evaluateGuard(guard, world, bindings, playerId) {
+    switch (guard.type) {
+        case 'entity':
+            return evaluateEntityGuard(guard, world, bindings);
+        case 'state':
+            return world.getStateValue(guard.key) === guard.value;
+        case 'location':
+            return evaluateLocationGuard(guard, world, bindings, playerId);
+        case 'inventory':
+            return evaluateInventoryGuard(guard, world, bindings, playerId);
+        case 'and':
+            return guard.conditions.every(c => evaluateGuard(c, world, bindings, playerId));
+        case 'or':
+            return guard.conditions.some(c => evaluateGuard(c, world, bindings, playerId));
+        case 'not':
+            return !guard.conditions.every(c => evaluateGuard(c, world, bindings, playerId));
+        case 'custom':
+            return guard.evaluate(world, bindings, playerId);
+    }
+}
+function evaluateEntityGuard(guard, world, bindings) {
+    const entityId = resolveRef(guard.entityRef, bindings);
+    const entity = world.getEntity(entityId);
+    if (!entity)
+        return false;
+    const trait = entity.getTrait(guard.trait);
+    if (!trait)
+        return false;
+    return trait[guard.property] === guard.value;
+}
+function evaluateLocationGuard(guard, world, bindings, playerId) {
+    const actorId = guard.actorRef ? resolveRef(guard.actorRef, bindings) : playerId;
+    const roomId = resolveRef(guard.roomRef, bindings);
+    return world.getLocation(actorId) === roomId;
+}
+function evaluateInventoryGuard(guard, world, bindings, playerId) {
+    const actorId = guard.actorRef ? resolveRef(guard.actorRef, bindings) : playerId;
+    const entityId = resolveRef(guard.entityRef, bindings);
+    return world.getLocation(entityId) === actorId;
+}
+function resolveRef(ref, bindings) {
+    if (ref.startsWith('$')) {
+        const bound = bindings[ref];
+        if (!bound) {
+            throw new Error(`Unresolved binding: ${ref}`);
+        }
+        return bound;
+    }
+    return ref;
+}
+//# sourceMappingURL=guard-evaluator.js.map

package/guard-evaluator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"guard-evaluator.js","sourceRoot":"","sources":["../../../../../../../../mnt/c/repotemp/sharpee/packages/plugin-state-machine/src/guard-evaluator.ts"],"names":[],"mappings":"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"}

package/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * @sharpee/plugin-state-machine - Declarative state machine plugin (ADR-119, ADR-120)
+ */
+export * from './types';
+export * from './state-machine-plugin';
+export * from './state-machine-runtime';
+export { evaluateGuard, resolveRef } from './guard-evaluator';
+export { executeEffects } from './effect-executor';
+//# sourceMappingURL=index.d.ts.map

package/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../mnt/c/repotemp/sharpee/packages/plugin-state-machine/src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,SAAS,CAAC;AACxB,cAAc,wBAAwB,CAAC;AACvC,cAAc,yBAAyB,CAAC;AACxC,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC9D,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC"}

package/index.js

@@ -0,0 +1,29 @@
+"use strict";
+/**
+ * @sharpee/plugin-state-machine - Declarative state machine plugin (ADR-119, ADR-120)
+ */
+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 });
+exports.executeEffects = exports.resolveRef = exports.evaluateGuard = void 0;
+__exportStar(require("./types"), exports);
+__exportStar(require("./state-machine-plugin"), exports);
+__exportStar(require("./state-machine-runtime"), exports);
+var guard_evaluator_1 = require("./guard-evaluator");
+Object.defineProperty(exports, "evaluateGuard", { enumerable: true, get: function () { return guard_evaluator_1.evaluateGuard; } });
+Object.defineProperty(exports, "resolveRef", { enumerable: true, get: function () { return guard_evaluator_1.resolveRef; } });
+var effect_executor_1 = require("./effect-executor");
+Object.defineProperty(exports, "executeEffects", { enumerable: true, get: function () { return effect_executor_1.executeEffects; } });
+//# sourceMappingURL=index.js.map

package/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../../../mnt/c/repotemp/sharpee/packages/plugin-state-machine/src/index.ts"],"names":[],"mappings":";AAAA;;GAEG;;;;;;;;;;;;;;;;;AAEH,0CAAwB;AACxB,yDAAuC;AACvC,0DAAwC;AACxC,qDAA8D;AAArD,gHAAA,aAAa,OAAA;AAAE,6GAAA,UAAU,OAAA;AAClC,qDAAmD;AAA1C,iHAAA,cAAc,OAAA"}

package/package.json

@@ -1,9 +1,8 @@
 {
   "name": "@sharpee/plugin-state-machine",
-  "version": "0.9.66-beta",
+  "version": "0.9.67-beta",
   "description": "State machine plugin for Sharpee engine - declarative puzzle and narrative orchestration (ADR-119, ADR-120)",
   "main": "./index.js",
-  "module": "dist-npm/index.js",
   "types": "./index.d.ts",
   "exports": {
     ".": {
@@ -12,14 +11,6 @@
       "default": "./index.js"
     }
   },
-  "scripts": {
-    "build": "tsc",
-    "clean": "rimraf dist",
-    "build:npm": "tsc --outDir dist-npm"
-  },
-  "files": [
-    "dist-npm"
-  ],
   "keywords": [
     "interactive-fiction",
     "sharpee",

package/state-machine-plugin.d.ts

@@ -0,0 +1,20 @@
+/**
+ * StateMachinePlugin - Wraps state machine registry as a TurnPlugin (ADR-119, ADR-120)
+ *
+ * Priority 75: Runs after NPCs (100) but before scheduler (50).
+ * Evaluates state machine transitions after each successful player action.
+ */
+import { ISemanticEvent } from "./src/index";
+import { TurnPlugin, TurnPluginContext } from "./src/index";
+import { StateMachineRegistry } from './state-machine-runtime';
+export declare class StateMachinePlugin implements TurnPlugin {
+    id: string;
+    priority: number;
+    private registry;
+    constructor();
+    onAfterAction(ctx: TurnPluginContext): ISemanticEvent[];
+    getState(): unknown;
+    setState(state: unknown): void;
+    getRegistry(): StateMachineRegistry;
+}
+//# sourceMappingURL=state-machine-plugin.d.ts.map

package/state-machine-plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state-machine-plugin.d.ts","sourceRoot":"","sources":["../../../../../mnt/c/repotemp/sharpee/packages/plugin-state-machine/src/state-machine-plugin.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACjE,OAAO,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAG/D,qBAAa,kBAAmB,YAAW,UAAU;IACnD,EAAE,SAAkC;IACpC,QAAQ,SAAM;IACd,OAAO,CAAC,QAAQ,CAAuB;;IAMvC,aAAa,CAAC,GAAG,EAAE,iBAAiB,GAAG,cAAc,EAAE;IAkBvD,QAAQ,IAAI,OAAO;IAInB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI;IAI9B,WAAW,IAAI,oBAAoB;CAGpC"}

package/state-machine-plugin.js

@@ -0,0 +1,45 @@
+"use strict";
+/**
+ * StateMachinePlugin - Wraps state machine registry as a TurnPlugin (ADR-119, ADR-120)
+ *
+ * Priority 75: Runs after NPCs (100) but before scheduler (50).
+ * Evaluates state machine transitions after each successful player action.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StateMachinePlugin = void 0;
+const state_machine_runtime_1 = require("./state-machine-runtime");
+class StateMachinePlugin {
+    id = 'sharpee.plugin.state-machine';
+    priority = 75;
+    registry;
+    constructor() {
+        this.registry = new state_machine_runtime_1.StateMachineRegistry();
+    }
+    onAfterAction(ctx) {
+        const evalCtx = {
+            world: ctx.world,
+            playerId: ctx.playerId,
+            playerLocation: ctx.playerLocation,
+            turn: ctx.turn,
+            actionId: ctx.actionResult?.actionId,
+            actionTargetId: ctx.actionResult?.targetId,
+            actionEvents: ctx.actionEvents?.map(e => ({
+                type: e.type,
+                data: e.data,
+                entities: e.entities,
+            })),
+        };
+        return this.registry.evaluate(evalCtx);
+    }
+    getState() {
+        return this.registry.getState();
+    }
+    setState(state) {
+        this.registry.setState(state);
+    }
+    getRegistry() {
+        return this.registry;
+    }
+}
+exports.StateMachinePlugin = StateMachinePlugin;
+//# sourceMappingURL=state-machine-plugin.js.map

package/state-machine-plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"state-machine-plugin.js","sourceRoot":"","sources":["../../../../../../../../mnt/c/repotemp/sharpee/packages/plugin-state-machine/src/state-machine-plugin.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAIH,mEAA+D;AAG/D,MAAa,kBAAkB;IAC7B,EAAE,GAAG,8BAA8B,CAAC;IACpC,QAAQ,GAAG,EAAE,CAAC;IACN,QAAQ,CAAuB;IAEvC;QACE,IAAI,CAAC,QAAQ,GAAG,IAAI,4CAAoB,EAAE,CAAC;IAC7C,CAAC;IAED,aAAa,CAAC,GAAsB;QAClC,MAAM,OAAO,GAAsB;YACjC,KAAK,EAAE,GAAG,CAAC,KAAK;YAChB,QAAQ,EAAE,GAAG,CAAC,QAAQ;YACtB,cAAc,EAAE,GAAG,CAAC,cAAc;YAClC,IAAI,EAAE,GAAG,CAAC,IAAI;YACd,QAAQ,EAAE,GAAG,CAAC,YAAY,EAAE,QAAQ;YACpC,cAAc,EAAE,GAAG,CAAC,YAAY,EAAE,QAAQ;YAC1C,YAAY,EAAE,GAAG,CAAC,YAAY,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;gBACxC,IAAI,EAAE,CAAC,CAAC,IAAI;gBACZ,IAAI,EAAE,CAAC,CAAC,IAAI;gBACZ,QAAQ,EAAE,CAAC,CAAC,QAAkC;aAC/C,CAAC,CAAC;SACJ,CAAC;QAEF,OAAO,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;IACzC,CAAC;IAED,QAAQ;QACN,OAAO,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,CAAC;IAClC,CAAC;IAED,QAAQ,CAAC,KAAc;QACrB,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,KAAkC,CAAC,CAAC;IAC7D,CAAC;IAED,WAAW;QACT,OAAO,IAAI,CAAC,QAAQ,CAAC;IACvB,CAAC;CACF;AAtCD,gDAsCC"}

package/state-machine-runtime.d.ts

@@ -0,0 +1,21 @@
+/**
+ * State Machine Runtime (ADR-119)
+ *
+ * Manages registered state machines and evaluates transitions each turn.
+ */
+import { ISemanticEvent } from "./src/index";
+import { StateMachineDefinition, EntityBindings, EvaluationContext, StateMachineRegistryState } from './types';
+export declare class StateMachineRegistry {
+    private machines;
+    register(definition: StateMachineDefinition, bindings?: EntityBindings): void;
+    unregister(id: string): void;
+    getMachineState(id: string): string | undefined;
+    getMachineHistory(id: string): string[] | undefined;
+    evaluate(ctx: EvaluationContext): ISemanticEvent[];
+    private findMatchingTransition;
+    private triggerMatches;
+    private executeTransition;
+    getState(): StateMachineRegistryState;
+    setState(state: StateMachineRegistryState): void;
+}
+//# sourceMappingURL=state-machine-runtime.d.ts.map

package/state-machine-runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state-machine-runtime.d.ts","sourceRoot":"","sources":["../../../../../mnt/c/repotemp/sharpee/packages/plugin-state-machine/src/state-machine-runtime.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EACL,sBAAsB,EACtB,cAAc,EACd,iBAAiB,EAIjB,yBAAyB,EAC1B,MAAM,SAAS,CAAC;AAWjB,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,QAAQ,CAAwC;IAExD,QAAQ,CAAC,UAAU,EAAE,sBAAsB,EAAE,QAAQ,GAAE,cAAmB,GAAG,IAAI;IAgBjF,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAI5B,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAI/C,iBAAiB,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS;IAInD,QAAQ,CAAC,GAAG,EAAE,iBAAiB,GAAG,cAAc,EAAE;IAsBlD,OAAO,CAAC,sBAAsB;IAmB9B,OAAO,CAAC,cAAc;IAyCtB,OAAO,CAAC,iBAAiB;IA2DzB,QAAQ,IAAI,yBAAyB;IAYrC,QAAQ,CAAC,KAAK,EAAE,yBAAyB,GAAG,IAAI;CASjD"}

package/state-machine-runtime.js

@@ -0,0 +1,162 @@
+"use strict";
+/**
+ * State Machine Runtime (ADR-119)
+ *
+ * Manages registered state machines and evaluates transitions each turn.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StateMachineRegistry = void 0;
+const guard_evaluator_1 = require("./guard-evaluator");
+const effect_executor_1 = require("./effect-executor");
+class StateMachineRegistry {
+    machines = new Map();
+    register(definition, bindings = {}) {
+        if (this.machines.has(definition.id)) {
+            throw new Error(`State machine already registered: ${definition.id}`);
+        }
+        // Validate initial state exists
+        if (!definition.states[definition.initialState]) {
+            throw new Error(`Initial state '${definition.initialState}' not found in machine '${definition.id}'`);
+        }
+        this.machines.set(definition.id, {
+            definition,
+            bindings: { ...bindings },
+            currentState: definition.initialState,
+            history: [definition.initialState],
+        });
+    }
+    unregister(id) {
+        this.machines.delete(id);
+    }
+    getMachineState(id) {
+        return this.machines.get(id)?.currentState;
+    }
+    getMachineHistory(id) {
+        return this.machines.get(id)?.history;
+    }
+    evaluate(ctx) {
+        const allEvents = [];
+        for (const machine of this.machines.values()) {
+            const stateDef = machine.definition.states[machine.currentState];
+            if (!stateDef || stateDef.terminal || !stateDef.transitions?.length)
+                continue;
+            const transition = this.findMatchingTransition(stateDef.transitions, machine, ctx);
+            if (transition) {
+                const events = this.executeTransition(machine, transition, ctx);
+                allEvents.push(...events);
+            }
+        }
+        return allEvents;
+    }
+    findMatchingTransition(transitions, machine, ctx) {
+        // Sort by priority (higher first), stable sort
+        const sorted = [...transitions].sort((a, b) => (b.priority ?? 0) - (a.priority ?? 0));
+        for (const transition of sorted) {
+            if (!this.triggerMatches(transition.trigger, machine, ctx))
+                continue;
+            if (transition.guard && !(0, guard_evaluator_1.evaluateGuard)(transition.guard, ctx.world, machine.bindings, ctx.playerId))
+                continue;
+            return transition;
+        }
+        return undefined;
+    }
+    triggerMatches(trigger, machine, ctx) {
+        switch (trigger.type) {
+            case 'action': {
+                if (ctx.actionId !== trigger.actionId)
+                    return false;
+                if (trigger.targetEntity) {
+                    const expectedId = trigger.targetEntity.startsWith('$')
+                        ? machine.bindings[trigger.targetEntity]
+                        : trigger.targetEntity;
+                    if (ctx.actionTargetId !== expectedId)
+                        return false;
+                }
+                return true;
+            }
+            case 'event': {
+                if (!ctx.actionEvents)
+                    return false;
+                return ctx.actionEvents.some(event => {
+                    if (event.type !== trigger.eventId)
+                        return false;
+                    if (trigger.filter && event.data) {
+                        const data = event.data;
+                        for (const [key, value] of Object.entries(trigger.filter)) {
+                            // Resolve binding references in filter values
+                            const expected = typeof value === 'string' && value.startsWith('$')
+                                ? machine.bindings[value]
+                                : value;
+                            if (data[key] !== expected)
+                                return false;
+                        }
+                    }
+                    return true;
+                });
+            }
+            case 'condition': {
+                return (0, guard_evaluator_1.evaluateGuard)(trigger.condition, ctx.world, machine.bindings, ctx.playerId);
+            }
+        }
+    }
+    executeTransition(machine, transition, ctx) {
+        const events = [];
+        const currentStateDef = machine.definition.states[machine.currentState];
+        const targetStateDef = machine.definition.states[transition.target];
+        if (!targetStateDef) {
+            throw new Error(`Target state '${transition.target}' not found in machine '${machine.definition.id}'`);
+        }
+        // 1. Execute onExit effects of current state
+        if (currentStateDef?.onExit) {
+            events.push(...(0, effect_executor_1.executeEffects)(currentStateDef.onExit, ctx.world, machine.bindings, ctx.playerId, machine.definition.id));
+        }
+        // 2. Execute transition effects
+        if (transition.effects) {
+            events.push(...(0, effect_executor_1.executeEffects)(transition.effects, ctx.world, machine.bindings, ctx.playerId, machine.definition.id));
+        }
+        // 3. Move to target state
+        machine.currentState = transition.target;
+        machine.history.push(transition.target);
+        // 4. Execute onEnter effects of target state
+        if (targetStateDef.onEnter) {
+            events.push(...(0, effect_executor_1.executeEffects)(targetStateDef.onEnter, ctx.world, machine.bindings, ctx.playerId, machine.definition.id));
+        }
+        // 5. Emit transition event
+        events.push({
+            id: `sm-transition-${Date.now()}`,
+            type: 'sm.transition',
+            timestamp: Date.now(),
+            entities: {},
+            data: {
+                machineId: machine.definition.id,
+                from: machine.history[machine.history.length - 2],
+                to: transition.target,
+            },
+            tags: ['state-machine', machine.definition.id],
+        });
+        return events;
+    }
+    // ─── Serialization ──────────────────────────────────────────────────────
+    getState() {
+        const instances = [];
+        for (const machine of this.machines.values()) {
+            instances.push({
+                id: machine.definition.id,
+                currentState: machine.currentState,
+                history: [...machine.history],
+            });
+        }
+        return { instances };
+    }
+    setState(state) {
+        for (const instanceState of state.instances) {
+            const machine = this.machines.get(instanceState.id);
+            if (machine) {
+                machine.currentState = instanceState.currentState;
+                machine.history = [...instanceState.history];
+            }
+        }
+    }
+}
+exports.StateMachineRegistry = StateMachineRegistry;
+//# sourceMappingURL=state-machine-runtime.js.map

package/state-machine-runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"state-machine-runtime.js","sourceRoot":"","sources":["../../../../../../../../mnt/c/repotemp/sharpee/packages/plugin-state-machine/src/state-machine-runtime.ts"],"names":[],"mappings":"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"}

package/types.d.ts

@@ -0,0 +1,149 @@
+/**
+ * State Machine Types (ADR-119)
+ *
+ * Declarative state machine definitions for puzzle and narrative orchestration.
+ */
+import { EntityId } from "./src/index";
+import { WorldModel } from "./src/index";
+export interface StateMachineDefinition {
+    id: string;
+    description?: string;
+    initialState: string;
+    states: Record<string, StateDefinition>;
+}
+export interface StateDefinition {
+    description?: string;
+    transitions?: TransitionDefinition[];
+    onEnter?: Effect[];
+    onExit?: Effect[];
+    terminal?: boolean;
+}
+export interface TransitionDefinition {
+    target: string;
+    trigger: TransitionTrigger;
+    guard?: GuardCondition;
+    effects?: Effect[];
+    priority?: number;
+}
+export type TransitionTrigger = ActionTrigger | EventTrigger | ConditionTrigger;
+export interface ActionTrigger {
+    type: 'action';
+    actionId: string;
+    targetEntity?: string;
+}
+export interface EventTrigger {
+    type: 'event';
+    eventId: string;
+    filter?: Record<string, unknown>;
+}
+export interface ConditionTrigger {
+    type: 'condition';
+    condition: GuardCondition;
+}
+export type GuardCondition = EntityGuard | StateGuard | LocationGuard | InventoryGuard | CompositeGuard | CustomGuard;
+export interface EntityGuard {
+    type: 'entity';
+    entityRef: string;
+    trait: string;
+    property: string;
+    value: unknown;
+}
+export interface StateGuard {
+    type: 'state';
+    key: string;
+    value: unknown;
+}
+export interface LocationGuard {
+    type: 'location';
+    actorRef?: string;
+    roomRef: string;
+}
+export interface InventoryGuard {
+    type: 'inventory';
+    actorRef?: string;
+    entityRef: string;
+}
+export interface CompositeGuard {
+    type: 'and' | 'or' | 'not';
+    conditions: GuardCondition[];
+}
+export interface CustomGuard {
+    type: 'custom';
+    evaluate: (world: WorldModel, bindings: EntityBindings, playerId: EntityId) => boolean;
+}
+export type Effect = MoveEntityEffect | RemoveEntityEffect | SetTraitEffect | SetStateEffect | MessageEffect | EmitEventEffect | CustomEffect;
+export interface MoveEntityEffect {
+    type: 'move';
+    entityRef: string;
+    destinationRef: string;
+}
+export interface RemoveEntityEffect {
+    type: 'remove';
+    entityRef: string;
+}
+export interface SetTraitEffect {
+    type: 'set_trait';
+    entityRef: string;
+    trait: string;
+    property: string;
+    value: unknown;
+}
+export interface SetStateEffect {
+    type: 'set_state';
+    key: string;
+    value: unknown;
+}
+export interface MessageEffect {
+    type: 'message';
+    messageId: string;
+    params?: Record<string, unknown>;
+}
+export interface EmitEventEffect {
+    type: 'emit_event';
+    eventType: string;
+    entities?: {
+        actor?: string;
+        target?: string;
+        instrument?: string;
+        location?: string;
+    };
+    data?: unknown;
+}
+export interface CustomEffect {
+    type: 'custom';
+    execute: (world: WorldModel, bindings: EntityBindings, playerId: EntityId) => EffectResult;
+}
+export interface EffectResult {
+    events?: Array<{
+        type: string;
+        entities?: Record<string, string>;
+        data?: unknown;
+    }>;
+    messages?: Array<{
+        messageId: string;
+        params?: Record<string, unknown>;
+    }>;
+}
+export type EntityBindings = Record<string, EntityId>;
+export interface StateMachineInstanceState {
+    id: string;
+    currentState: string;
+    history: string[];
+}
+export interface StateMachineRegistryState {
+    instances: StateMachineInstanceState[];
+}
+export interface EvaluationContext {
+    world: WorldModel;
+    playerId: EntityId;
+    playerLocation: EntityId;
+    turn: number;
+    actionId?: string;
+    actionTargetId?: EntityId;
+    actionEvents?: Array<{
+        type: string;
+        data?: unknown;
+        entities?: Record<string, string>;
+    }>;
+}
+//# sourceMappingURL=types.d.ts.map

package/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../mnt/c/repotemp/sharpee/packages/plugin-state-machine/src/types.ts"],"names":[],"mappings":"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"}

package/types.js

@@ -0,0 +1,8 @@
+"use strict";
+/**
+ * State Machine Types (ADR-119)
+ *
+ * Declarative state machine definitions for puzzle and narrative orchestration.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../../../../../mnt/c/repotemp/sharpee/packages/plugin-state-machine/src/types.ts"],"names":[],"mappings":";AAAA;;;;GAIG"}