@sharpee/character 0.9.106 → 0.9.107

package/goals/builder.js

@@ -0,0 +1,193 @@
+"use strict";
+/**
+ * Goal builder API (ADR-145 layer 5)
+ *
+ * Fluent builder for defining NPC goals with activation conditions,
+ * pursuit modes, behavior sequences, and interruption rules.
+ * Returns from CharacterBuilder.goal(id) and compiles to GoalDef
+ * stored in CompiledCharacter.goalDefs.
+ *
+ * Public interface: GoalBuilder.
+ * Owner context: @sharpee/character / goals
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GoalBuilder = void 0;
+/**
+ * Fluent builder for a single goal definition.
+ *
+ * Usage:
+ * ```
+ * builder.goal('eliminate-player')
+ *   .activatesWhen('knows murder discovered', 'has weapon')
+ *   .priority('critical')
+ *   .mode('prepared')
+ *   .pursues([
+ *     { type: 'moveTo', target: 'study' },
+ *     { type: 'acquire', target: 'knife' },
+ *   ])
+ *   .actsWhen('alone with player')
+ *   .act('colonel-attacks-player')
+ *   .onInterrupt('colonel-retreats')
+ *   .resumeOnClear(true)
+ *   .done()
+ * ```
+ */
+class GoalBuilder {
+    _id;
+    _parent;
+    _finalize;
+    _activatesWhen = [];
+    _interruptedBy = [];
+    _priority = 'medium';
+    _mode = 'sequential';
+    _steps = [];
+    _actsWhen = [];
+    _actMessageId;
+    _onInterrupt;
+    _resumeOnClear = false;
+    /**
+     * Create a new goal builder.
+     *
+     * @param id - Unique goal identifier
+     * @param parent - Parent builder to return to on .done()
+     * @param finalize - Callback to register the compiled GoalDef
+     */
+    constructor(id, parent, finalize) {
+        this._id = id;
+        this._parent = parent;
+        this._finalize = finalize;
+    }
+    /**
+     * Set predicate conditions that activate this goal.
+     *
+     * @param predicates - Predicate names (all must be true)
+     * @returns this for chaining
+     */
+    activatesWhen(...predicates) {
+        this._activatesWhen.push(...predicates);
+        return this;
+    }
+    /**
+     * Set goal priority.
+     *
+     * @param priority - Priority word
+     * @returns this for chaining
+     */
+    priority(priority) {
+        this._priority = priority;
+        return this;
+    }
+    /**
+     * Set pursuit mode.
+     *
+     * @param mode - How the NPC pursues the goal
+     * @returns this for chaining
+     */
+    mode(mode) {
+        this._mode = mode;
+        return this;
+    }
+    /**
+     * Set the behavior sequence (for sequential and prepared modes).
+     *
+     * @param steps - Array of goal steps
+     * @returns this for chaining
+     */
+    pursues(steps) {
+        this._steps = [...steps];
+        return this;
+    }
+    /**
+     * Set conditions for the final act (opportunistic/prepared modes).
+     *
+     * @param predicates - Predicate names (all must be true)
+     * @returns this for chaining
+     */
+    actsWhen(...predicates) {
+        this._actsWhen.push(...predicates);
+        return this;
+    }
+    /**
+     * Set the message ID for the final act.
+     *
+     * @param messageId - Message ID
+     * @returns this for chaining
+     */
+    act(messageId) {
+        this._actMessageId = messageId;
+        return this;
+    }
+    /**
+     * Set predicate conditions that interrupt (suspend) this goal.
+     *
+     * @param predicates - Predicate names
+     * @returns this for chaining
+     */
+    interruptedBy(...predicates) {
+        this._interruptedBy.push(...predicates);
+        return this;
+    }
+    /**
+     * Set the message ID when the goal is interrupted.
+     *
+     * @param messageId - Message ID
+     * @returns this for chaining
+     */
+    onInterrupt(messageId) {
+        this._onInterrupt = messageId;
+        return this;
+    }
+    /**
+     * Set whether the goal resumes from where it left off after interruption.
+     *
+     * @param resume - Whether to resume
+     * @returns this for chaining
+     */
+    resumeOnClear(resume) {
+        this._resumeOnClear = resume;
+        return this;
+    }
+    /**
+     * Finalize this goal definition and return the parent builder.
+     *
+     * @returns The parent builder
+     */
+    done() {
+        this._finalize(this._buildDef());
+        return this._parent;
+    }
+    /**
+     * Compile the parent builder, auto-finalizing this goal.
+     * Allows calling .compile() directly from a goal chain without .done().
+     *
+     * @returns Compiled character data (delegates to parent's compile())
+     */
+    compile() {
+        const parent = this.done();
+        return parent.compile();
+    }
+    /** @internal Build the GoalDef without finalizing. */
+    _buildDef() {
+        const def = {
+            id: this._id,
+            activatesWhen: [...this._activatesWhen],
+            priority: this._priority,
+            mode: this._mode,
+        };
+        if (this._steps.length > 0)
+            def.steps = [...this._steps];
+        if (this._interruptedBy.length > 0)
+            def.interruptedBy = [...this._interruptedBy];
+        if (this._actsWhen.length > 0)
+            def.actsWhen = [...this._actsWhen];
+        if (this._actMessageId !== undefined)
+            def.actMessageId = this._actMessageId;
+        if (this._onInterrupt !== undefined)
+            def.onInterrupt = this._onInterrupt;
+        if (this._resumeOnClear)
+            def.resumeOnClear = true;
+        return def;
+    }
+}
+exports.GoalBuilder = GoalBuilder;
+//# sourceMappingURL=builder.js.map

package/goals/builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"builder.js","sourceRoot":"","sources":["../../../../../../../repos/sharpee/packages/character/src/goals/builder.ts"],"names":[],"mappings":"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"}

package/goals/goal-activation.d.ts

@@ -0,0 +1,99 @@
+/**
+ * Goal activation and lifecycle (ADR-145)
+ *
+ * Evaluates goal activation conditions against character state,
+ * manages the active goal queue (priority-sorted), and handles
+ * interruption/resumption.
+ *
+ * Public interface: GoalManager.
+ * Owner context: @sharpee/character / goals
+ */
+import { CharacterModelTrait } from "../../world-model/index";
+import { GoalDef, ActiveGoal } from './goal-types';
+/**
+ * Manages goal activation, deactivation, interruption, and the
+ * active goal queue for a single NPC.
+ */
+export declare class GoalManager {
+    /** All authored goal definitions for this NPC. */
+    private readonly defs;
+    /** Currently active goals, sorted by priority (highest first). */
+    private activeGoals;
+    /**
+     * Register a goal definition.
+     *
+     * @param def - The goal definition
+     */
+    registerGoal(def: GoalDef): void;
+    /**
+     * Register multiple goal definitions.
+     *
+     * @param defs - The goal definitions
+     */
+    registerGoals(defs: GoalDef[]): void;
+    /**
+     * Evaluate all goal activation and interruption conditions.
+     * Activates new goals, interrupts active ones, resumes cleared ones.
+     *
+     * @param trait - The NPC's CharacterModelTrait
+     * @returns The current active goal queue (priority-sorted)
+     */
+    evaluate(trait: CharacterModelTrait): ActiveGoal[];
+    /**
+     * Get the highest-priority non-interrupted active goal.
+     *
+     * @returns The top goal, or undefined
+     */
+    getTopGoal(): ActiveGoal | undefined;
+    /**
+     * Check if a goal is currently active.
+     *
+     * @param goalId - The goal ID
+     * @returns True if the goal is in the active queue
+     */
+    isActive(goalId: string): boolean;
+    /**
+     * Get all active goals.
+     *
+     * @returns The active goal queue
+     */
+    getActiveGoals(): readonly ActiveGoal[];
+    /**
+     * Advance the current step of a goal (after step completion).
+     *
+     * @param goalId - The goal ID
+     */
+    advanceStep(goalId: string): void;
+    /**
+     * Complete a goal and remove it from the active queue.
+     *
+     * @param goalId - The goal ID
+     */
+    complete(goalId: string): void;
+    /** Export active goals for save/restore. */
+    toJSON(): ActiveGoalState[];
+    /** Restore active goals from serialized state. */
+    restoreState(states: ActiveGoalState[]): void;
+    /**
+     * Evaluate interruption and resumption conditions for all active goals.
+     *
+     * For interrupted goals with resumeOnClear, checks if interruption
+     * conditions have cleared and resumes them. For non-interrupted goals,
+     * checks if any interruption conditions are now met and interrupts them.
+     *
+     * @param activeGoals - The active goal queue
+     * @param trait - The NPC's CharacterModelTrait
+     */
+    private evaluateInterruptions;
+    private activate;
+    private deactivate;
+}
+/** Serialized active goal state. */
+export interface ActiveGoalState {
+    defId: string;
+    currentStep: number;
+    paused: boolean;
+    interrupted: boolean;
+    prepared: boolean;
+}
+//# sourceMappingURL=goal-activation.d.ts.map

package/goals/goal-activation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"goal-activation.d.ts","sourceRoot":"","sources":["../../../../../../repos/sharpee/packages/character/src/goals/goal-activation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,EACL,OAAO,EACP,UAAU,EAEX,MAAM,cAAc,CAAC;AAMtB;;;GAGG;AACH,qBAAa,WAAW;IACtB,kDAAkD;IAClD,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAiB;IAEtC,kEAAkE;IAClE,OAAO,CAAC,WAAW,CAAoB;IAMvC;;;;OAIG;IACH,YAAY,CAAC,GAAG,EAAE,OAAO,GAAG,IAAI;IAIhC;;;;OAIG;IACH,aAAa,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAQpC;;;;;;OAMG;IACH,QAAQ,CAAC,KAAK,EAAE,mBAAmB,GAAG,UAAU,EAAE;IAgClD;;;;OAIG;IACH,UAAU,IAAI,UAAU,GAAG,SAAS;IAIpC;;;;;OAKG;IACH,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAIjC;;;;OAIG;IACH,cAAc,IAAI,SAAS,UAAU,EAAE;IAIvC;;;;OAIG;IACH,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAkBjC;;;;OAIG;IACH,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAQ9B,4CAA4C;IAC5C,MAAM,IAAI,eAAe,EAAE;IAU3B,kDAAkD;IAClD,YAAY,CAAC,MAAM,EAAE,eAAe,EAAE,GAAG,IAAI;IAoB7C;;;;;;;;;OASG;IACH,OAAO,CAAC,qBAAqB;IA8B7B,OAAO,CAAC,QAAQ;IAUhB,OAAO,CAAC,UAAU;CAGnB;AAMD,oCAAoC;AACpC,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,OAAO,CAAC;IAChB,WAAW,EAAE,OAAO,CAAC;IACrB,QAAQ,EAAE,OAAO,CAAC;CACnB"}

package/goals/goal-activation.js

@@ -0,0 +1,212 @@
+"use strict";
+/**
+ * Goal activation and lifecycle (ADR-145)
+ *
+ * Evaluates goal activation conditions against character state,
+ * manages the active goal queue (priority-sorted), and handles
+ * interruption/resumption.
+ *
+ * Public interface: GoalManager.
+ * Owner context: @sharpee/character / goals
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GoalManager = void 0;
+const goal_types_1 = require("./goal-types");
+// ---------------------------------------------------------------------------
+// Goal manager
+// ---------------------------------------------------------------------------
+/**
+ * Manages goal activation, deactivation, interruption, and the
+ * active goal queue for a single NPC.
+ */
+class GoalManager {
+    /** All authored goal definitions for this NPC. */
+    defs = [];
+    /** Currently active goals, sorted by priority (highest first). */
+    activeGoals = [];
+    // =========================================================================
+    // Registration
+    // =========================================================================
+    /**
+     * Register a goal definition.
+     *
+     * @param def - The goal definition
+     */
+    registerGoal(def) {
+        this.defs.push(def);
+    }
+    /**
+     * Register multiple goal definitions.
+     *
+     * @param defs - The goal definitions
+     */
+    registerGoals(defs) {
+        this.defs.push(...defs);
+    }
+    // =========================================================================
+    // Evaluation (called each NPC turn)
+    // =========================================================================
+    /**
+     * Evaluate all goal activation and interruption conditions.
+     * Activates new goals, interrupts active ones, resumes cleared ones.
+     *
+     * @param trait - The NPC's CharacterModelTrait
+     * @returns The current active goal queue (priority-sorted)
+     */
+    evaluate(trait) {
+        // Check for new activations
+        for (const def of this.defs) {
+            if (this.isActive(def.id))
+                continue;
+            const shouldActivate = def.activatesWhen.every(pred => trait.evaluate(pred));
+            if (shouldActivate) {
+                this.activate(def);
+            }
+        }
+        // Check for interruptions on active goals
+        this.evaluateInterruptions(this.activeGoals, trait);
+        // Sort by priority (highest first), interrupted goals at the end
+        this.activeGoals.sort((a, b) => {
+            if (a.interrupted !== b.interrupted) {
+                return a.interrupted ? 1 : -1;
+            }
+            return goal_types_1.GOAL_PRIORITY_VALUES[b.def.priority] - goal_types_1.GOAL_PRIORITY_VALUES[a.def.priority];
+        });
+        return this.activeGoals;
+    }
+    // =========================================================================
+    // State queries
+    // =========================================================================
+    /**
+     * Get the highest-priority non-interrupted active goal.
+     *
+     * @returns The top goal, or undefined
+     */
+    getTopGoal() {
+        return this.activeGoals.find(g => !g.interrupted && !g.paused);
+    }
+    /**
+     * Check if a goal is currently active.
+     *
+     * @param goalId - The goal ID
+     * @returns True if the goal is in the active queue
+     */
+    isActive(goalId) {
+        return this.activeGoals.some(g => g.def.id === goalId);
+    }
+    /**
+     * Get all active goals.
+     *
+     * @returns The active goal queue
+     */
+    getActiveGoals() {
+        return this.activeGoals;
+    }
+    /**
+     * Advance the current step of a goal (after step completion).
+     *
+     * @param goalId - The goal ID
+     */
+    advanceStep(goalId) {
+        const goal = this.activeGoals.find(g => g.def.id === goalId);
+        if (!goal)
+            return;
+        goal.currentStep++;
+        // Check if all sequential steps are done
+        if (goal.def.steps && goal.currentStep >= goal.def.steps.length) {
+            if (goal.def.mode === 'prepared') {
+                // Switch to opportunistic for the final act
+                goal.prepared = true;
+            }
+            else {
+                // Sequential goal complete — remove from active
+                this.deactivate(goalId);
+            }
+        }
+    }
+    /**
+     * Complete a goal and remove it from the active queue.
+     *
+     * @param goalId - The goal ID
+     */
+    complete(goalId) {
+        this.deactivate(goalId);
+    }
+    // =========================================================================
+    // Serialization
+    // =========================================================================
+    /** Export active goals for save/restore. */
+    toJSON() {
+        return this.activeGoals.map(g => ({
+            defId: g.def.id,
+            currentStep: g.currentStep,
+            paused: g.paused,
+            interrupted: g.interrupted,
+            prepared: g.prepared,
+        }));
+    }
+    /** Restore active goals from serialized state. */
+    restoreState(states) {
+        this.activeGoals = [];
+        for (const state of states) {
+            const def = this.defs.find(d => d.id === state.defId);
+            if (!def)
+                continue;
+            this.activeGoals.push({
+                def,
+                currentStep: state.currentStep,
+                paused: state.paused,
+                interrupted: state.interrupted,
+                prepared: state.prepared,
+            });
+        }
+    }
+    // =========================================================================
+    // Private helpers
+    // =========================================================================
+    /**
+     * Evaluate interruption and resumption conditions for all active goals.
+     *
+     * For interrupted goals with resumeOnClear, checks if interruption
+     * conditions have cleared and resumes them. For non-interrupted goals,
+     * checks if any interruption conditions are now met and interrupts them.
+     *
+     * @param activeGoals - The active goal queue
+     * @param trait - The NPC's CharacterModelTrait
+     */
+    evaluateInterruptions(activeGoals, trait) {
+        for (const goal of activeGoals) {
+            if (goal.interrupted) {
+                // Check if interruption conditions cleared and goal should resume
+                if (goal.def.resumeOnClear && goal.def.interruptedBy) {
+                    const stillInterrupted = goal.def.interruptedBy.some(pred => trait.evaluate(pred));
+                    if (!stillInterrupted) {
+                        goal.interrupted = false;
+                    }
+                }
+                continue;
+            }
+            // Check if this goal should be interrupted
+            if (goal.def.interruptedBy) {
+                const shouldInterrupt = goal.def.interruptedBy.some(pred => trait.evaluate(pred));
+                if (shouldInterrupt) {
+                    goal.interrupted = true;
+                }
+            }
+        }
+    }
+    activate(def) {
+        this.activeGoals.push({
+            def,
+            currentStep: 0,
+            paused: false,
+            interrupted: false,
+            prepared: false,
+        });
+    }
+    deactivate(goalId) {
+        this.activeGoals = this.activeGoals.filter(g => g.def.id !== goalId);
+    }
+}
+exports.GoalManager = GoalManager;
+//# sourceMappingURL=goal-activation.js.map

package/goals/goal-activation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"goal-activation.js","sourceRoot":"","sources":["../../../../../../../repos/sharpee/packages/character/src/goals/goal-activation.ts"],"names":[],"mappings":"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"}

package/goals/goal-types.d.ts

@@ -0,0 +1,138 @@
+/**
+ * NPC goal pursuit types (ADR-145)
+ *
+ * Type definitions for authored behavior sequences: goal definitions,
+ * step types, pursuit modes, and active goal state.
+ *
+ * Public interface: All exported types.
+ * Owner context: @sharpee/character / goals
+ */
+/** Goal priority levels. */
+export type GoalPriority = 'critical' | 'high' | 'medium' | 'low';
+/** Maps priority words to numeric values for sorting. */
+export declare const GOAL_PRIORITY_VALUES: Record<GoalPriority, number>;
+/**
+ * How the NPC pursues the goal.
+ * - sequential: execute steps in order, one per turn
+ * - opportunistic: no steps — wait for act conditions
+ * - prepared: sequential prep steps, then switch to opportunistic
+ */
+export type PursuitMode = 'sequential' | 'opportunistic' | 'prepared';
+/** Base for all step types. */
+interface StepBase {
+    /** Message ID when player witnesses this step. */
+    witnessed?: string;
+}
+/** Move toward a location or entity. */
+export interface SeekStep extends StepBase {
+    type: 'seek';
+    target: string;
+    from?: string;
+}
+/** Pick up or obtain an item. */
+export interface AcquireStep extends StepBase {
+    type: 'acquire';
+    target: string;
+}
+/** Pause until a condition is met. */
+export interface WaitForStep extends StepBase {
+    type: 'waitFor';
+    conditions: string[];
+}
+/** Go to a specific location. */
+export interface MoveToStep extends StepBase {
+    type: 'moveTo';
+    target: string;
+}
+/** Perform an authored action. */
+export interface ActStep extends StepBase {
+    type: 'act';
+    messageId: string;
+}
+/** Initiate conversation. */
+export interface SayStep extends StepBase {
+    type: 'say';
+    messageId: string;
+    target?: string;
+}
+/** Hand an item to another entity. */
+export interface GiveStep extends StepBase {
+    type: 'give';
+    item: string;
+    target: string;
+}
+/** Leave an item somewhere. */
+export interface DropStep extends StepBase {
+    type: 'drop';
+    item: string;
+    location?: string;
+}
+/** Union of all goal step types. */
+export type GoalStep = SeekStep | AcquireStep | WaitForStep | MoveToStep | ActStep | SayStep | GiveStep | DropStep;
+/** Author-defined goal with activation conditions and behavior sequence. */
+export interface GoalDef {
+    /** Unique goal identifier. */
+    id: string;
+    /** Predicate conditions that activate this goal. */
+    activatesWhen: string[];
+    /** Predicate conditions that interrupt (suspend) this goal. */
+    interruptedBy?: string[];
+    /** Goal priority. */
+    priority: GoalPriority;
+    /** Pursuit mode. */
+    mode: PursuitMode;
+    /** Behavior sequence (for sequential and prepared modes). */
+    steps?: GoalStep[];
+    /**
+     * Act conditions (for opportunistic and prepared modes).
+     * When all conditions are met, the final act fires.
+     */
+    actsWhen?: string[];
+    /** Message ID for the final act (opportunistic/prepared). */
+    actMessageId?: string;
+    /** Message ID when the goal is interrupted. */
+    onInterrupt?: string;
+    /** Whether the goal resumes from where it left off after interruption clears. */
+    resumeOnClear?: boolean;
+}
+/** Runtime state of an active goal. */
+export interface ActiveGoal {
+    /** The goal definition. */
+    def: GoalDef;
+    /** Current step index (for sequential/prepared modes). */
+    currentStep: number;
+    /** Whether the goal is paused (preempted by higher priority). */
+    paused: boolean;
+    /** Whether the goal is interrupted (conditions met). */
+    interrupted: boolean;
+    /**
+     * Whether the preparatory steps are complete (for prepared mode).
+     * When true, the goal switches to opportunistic behavior.
+     */
+    prepared: boolean;
+}
+/**
+ * NPC movement profile — defines map knowledge and access.
+ * NPCs can only pathfind through known rooms and accessible passages.
+ */
+export interface MovementProfile {
+    /** Room IDs the NPC knows about, or 'all'. */
+    knows: string[] | 'all';
+    /** Passage/connection IDs the NPC can traverse, or 'all'. */
+    access: string[] | 'all';
+}
+/** Result of evaluating a single goal step. */
+export type StepResult = {
+    status: 'completed';
+    witnessed?: string;
+} | {
+    status: 'in-progress';
+    witnessed?: string;
+} | {
+    status: 'waiting';
+} | {
+    status: 'blocked';
+    reason: string;
+};
+export {};
+//# sourceMappingURL=goal-types.d.ts.map

package/goals/goal-types.d.ts.map

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

package/goals/goal-types.js

@@ -0,0 +1,20 @@
+"use strict";
+/**
+ * NPC goal pursuit types (ADR-145)
+ *
+ * Type definitions for authored behavior sequences: goal definitions,
+ * step types, pursuit modes, and active goal state.
+ *
+ * Public interface: All exported types.
+ * Owner context: @sharpee/character / goals
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GOAL_PRIORITY_VALUES = void 0;
+/** Maps priority words to numeric values for sorting. */
+exports.GOAL_PRIORITY_VALUES = {
+    critical: 100,
+    high: 75,
+    medium: 50,
+    low: 25,
+};
+//# sourceMappingURL=goal-types.js.map