@maka/maka-cli 5.3.1 → 5.3.2

package/bundle/typescript/src/commands/game/sideQuest/models/item.d.ts

@@ -0,0 +1,56 @@
+import { Size, Category, Rating } from '../types/shared/item-enum.js';
+import { AbstractItem } from '../types/shared/abstracts.js';
+export interface IItemConstructorConfig {
+    name: string;
+    description: string;
+    size: Size;
+    category: Category;
+    shape: string;
+    color: string;
+    texture: string;
+    rating: Rating;
+    weight: number;
+    details?: string;
+    content?: string;
+    satisfiesLifestyle?: {
+        addictionTypes?: string[];
+        habitTags?: string[];
+    };
+    transferable?: boolean;
+}
+export declare class Item extends AbstractItem {
+    private _id;
+    private _owner?;
+    name: string;
+    description: string;
+    size: Size;
+    category: Category;
+    shape: string;
+    color: string;
+    texture: string;
+    rating: Rating;
+    weight: number;
+    content?: string;
+    details?: string;
+    satisfiesLifestyle?: {
+        addictionTypes?: string[];
+        habitTags?: string[];
+    };
+    private _transferable;
+    protected _currencyAmount: number;
+    protected _currencyCapacity?: number;
+    constructor(options: IItemConstructorConfig);
+    get owner(): string | undefined;
+    set owner(owner: string | undefined);
+    get id(): string;
+    get transferable(): boolean;
+    use(): string;
+    supportsAddiction(addiction: string): boolean;
+    supportsHabit(habit: string): boolean;
+    isCurrencyCarrier(): boolean;
+    get currencyAmount(): number;
+    addCurrency(amount: number): number;
+    deductCurrency(amount: number): number;
+    private getCharacteristics;
+    getFormattedCharacteristics(): string;
+}

package/bundle/typescript/src/commands/game/sideQuest/models/item.js

@@ -0,0 +1,145 @@
+import { Size, Category, Rating } from '../types/shared/item-enum.js';
+import { v4 as uuidv4 } from 'uuid';
+import { AbstractItem } from '../types/shared/abstracts.js';
+export class Item extends AbstractItem {
+    _id;
+    _owner;
+    name;
+    description;
+    size;
+    category;
+    shape;
+    color;
+    texture;
+    rating;
+    weight;
+    content;
+    details;
+    satisfiesLifestyle;
+    _transferable;
+    // New currency-related fields
+    _currencyAmount = 0;
+    _currencyCapacity;
+    constructor(options) {
+        super();
+        // Validate enum values
+        if (!Object.values(Size).includes(options.size)) {
+            throw new Error(`Invalid size value for ${options.name}: ${options.size}`);
+        }
+        if (!Object.values(Category).includes(options.category)) {
+            throw new Error(`Invalid category value for ${options.name}: ${options.category}`);
+        }
+        if (!Object.values(Rating).includes(options.rating)) {
+            throw new Error(`Invalid rating value for ${options.name}: ${options.rating}`);
+        }
+        this.name = options.name;
+        this.description = options.description;
+        this.size = options.size;
+        this.category = options.category;
+        this.shape = options.shape;
+        this.color = options.color;
+        this.texture = options.texture;
+        this.rating = options.rating;
+        this.weight = options.weight;
+        this.details = options.details;
+        this.content = options.content;
+        this.satisfiesLifestyle = options.satisfiesLifestyle;
+        this._transferable = options.transferable !== false; // default true
+        this._id = uuidv4();
+        // Optional: you can define capacity by size
+        if (this.isCurrencyCarrier()) {
+            switch (this.size) {
+                case Size.Small:
+                    this._currencyCapacity = 100;
+                    break;
+                case Size.Medium:
+                    this._currencyCapacity = 500;
+                    break;
+                case Size.Large:
+                    this._currencyCapacity = 1000;
+                    break;
+            }
+        }
+    }
+    get owner() {
+        return this._owner;
+    }
+    set owner(owner) {
+        this._owner = owner;
+    }
+    get id() {
+        return this._id;
+    }
+    get transferable() {
+        return this._transferable;
+    }
+    use() {
+        return `You use the ${this.name}. Nothing special happens.`;
+    }
+    supportsAddiction(addiction) {
+        return this.satisfiesLifestyle?.addictionTypes?.includes(addiction) ?? false;
+    }
+    supportsHabit(habit) {
+        return this.satisfiesLifestyle?.habitTags?.includes(habit) ?? false;
+    }
+    // --- Currency Support ---
+    isCurrencyCarrier() {
+        return this.category === Category.CurrencyContainer;
+    }
+    get currencyAmount() {
+        return this._currencyAmount;
+    }
+    addCurrency(amount) {
+        if (!this.isCurrencyCarrier())
+            return 0;
+        const space = this._currencyCapacity !== undefined
+            ? Math.max(0, this._currencyCapacity - this._currencyAmount)
+            : Infinity;
+        const added = Math.min(amount, space);
+        this._currencyAmount += added;
+        return added;
+    }
+    deductCurrency(amount) {
+        if (!this.isCurrencyCarrier())
+            return 0;
+        const deducted = Math.min(this._currencyAmount, amount);
+        this._currencyAmount -= deducted;
+        return deducted;
+    }
+    getCharacteristics() {
+        return {
+            id: this._id,
+            name: this.name,
+            description: this.description,
+            size: this.size,
+            category: this.category,
+            shape: this.shape,
+            color: this.color,
+            texture: this.texture,
+            rating: this.rating,
+            weight: this.weight,
+            content: this.content,
+            details: this.details,
+            addictionTypes: this.satisfiesLifestyle?.addictionTypes,
+            habitTags: this.satisfiesLifestyle?.habitTags,
+            currencyAmount: this.isCurrencyCarrier() ? this._currencyAmount : undefined,
+            currencyCapacity: this.isCurrencyCarrier() ? this._currencyCapacity : undefined,
+        };
+    }
+    getFormattedCharacteristics() {
+        const characteristics = this.getCharacteristics();
+        return Object.entries(characteristics)
+            .filter(([_, value]) => value !== undefined)
+            .map(([key, value]) => {
+            const formattedKey = key
+                .replace(/([A-Z])/g, ' $1') // insert space before capital letters
+                .replace(/^./, str => str.toUpperCase()); // capitalize first letter
+            const formattedValue = Array.isArray(value)
+                ? value.join(', ')
+                : value;
+            return `${formattedKey}: ${formattedValue}`;
+        })
+            .join('\n');
+    }
+}
+//# sourceMappingURL=item.js.map

package/bundle/typescript/src/commands/game/sideQuest/models/item.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"item.js","sourceRoot":"","sources":["../../../../../../../src/commands/game/sideQuest/models/item.ts"],"names":[],"mappings":"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"}

package/bundle/typescript/src/commands/game/sideQuest/models/npc.d.ts

@@ -0,0 +1,36 @@
+import { Player } from './player.js';
+import { Scene } from './scene.js';
+import { IPlayerConstructorConfig } from '../models/player.js';
+import { CommandRegistry } from '../commands/command-registry.js';
+export interface INPCConstructorConfig {
+    dialog: string[];
+    description: string;
+    playerConstructorConfig: IPlayerConstructorConfig;
+}
+export declare class NPC extends Player {
+    private _dialogue;
+    private _description;
+    private _scene?;
+    private _commandHelp;
+    private _history;
+    private readonly _maxHistory;
+    private commandRegistry;
+    private lastNpcHeardTime;
+    private static npcHearCooldownMs;
+    private lastNpcSeenTime;
+    private static npcSeeCooldownMs;
+    private _maxRecursion;
+    private waitingForPlayer;
+    constructor(npcConfig: INPCConstructorConfig, commandRegistry: CommandRegistry);
+    set scene(scene: Scene);
+    get description(): string;
+    set description(description: string);
+    act(commandString: string): Promise<void>;
+    hear(actor: Player, message: string): Promise<void>;
+    see(actor: Player, verb: string, details?: string): Promise<void>;
+    private _addToHistory;
+    private getHistorySummary;
+    speak(message?: string): string;
+    recursiveReflect(commandString: string, result: string, recursionDepth?: number, maxRecursion?: number): Promise<void>;
+    respondTo(actor: Player, message: string): Promise<void>;
+}

package/bundle/typescript/src/commands/game/sideQuest/models/npc.js

@@ -0,0 +1,407 @@
+import { capitalCase } from 'change-case';
+import { Player } from './player.js';
+import { Door } from './door.js';
+import { HTTPS } from '../../../../tools/https/https.class.js';
+export class NPC extends Player {
+    _dialogue;
+    _description;
+    _scene;
+    _commandHelp;
+    _history = [];
+    _maxHistory = 200;
+    commandRegistry;
+    lastNpcHeardTime = 0;
+    static npcHearCooldownMs = 500; // 10 seconds. Adjust as you like!
+    lastNpcSeenTime = 0;
+    static npcSeeCooldownMs = 500; // 10 seconds (tune as you like)
+    _maxRecursion = 5;
+    waitingForPlayer = false;
+    constructor(npcConfig, commandRegistry) {
+        super(npcConfig.playerConstructorConfig);
+        this._dialogue = npcConfig.dialog;
+        this._description = npcConfig.description;
+        this.commandRegistry = commandRegistry;
+        this._commandHelp = `
+Available in-game commands (use with [COMMAND] prefix):
+
+- go <direction> — move in a direction like north, south, east, west
+- say <message> — speak a message
+- take <item name> — pick up an item from the current room
+- drop <item name> — drop an item
+- use <item name> — use an item
+- equip <item name> — equip an item (e.g., equip a weapon to use)
+- equip all - equip all wearable items in inventory
+- unequip <item name> — remove an equipped item
+- unlock <door name> — unlock a door (if you have the key or solution)
+- lock <door name> — lock a door
+- solve <puzzle name> — attempt to solve a puzzle
+- search — search the room for hidden things
+- look — look around the current room
+- look at <target> - looks at an item, player, or direction
+- store <item name> — store an item (in bank, safe, etc.)
+- give <item name> to <target> — give an item to someone
+- talk-to <target> — initiate conversation with another character
+- read <target> - Reads an item of Category "Book"
+- kill <target> - Kills an actor, removing them from the game.
+`.trim();
+    }
+    set scene(scene) {
+        this._scene = scene;
+    }
+    get description() {
+        return this._description;
+    }
+    set description(description) {
+        this._description = description;
+    }
+    async act(commandString) {
+        const command = await this.commandRegistry.parse(commandString, this);
+        if (command) {
+            // Capture the result of the command
+            const result = await command.execute();
+            await this.recursiveReflect(commandString, result);
+        }
+        else {
+            this.logger.error(`${this.name} tried to perform unknown command: ${commandString}`);
+        }
+    }
+    async hear(actor, message) {
+        if (actor === this || actor.name === this.name)
+            return;
+        // Player wakes us up
+        if (!(actor instanceof NPC)) {
+            if (this.waitingForPlayer)
+                this.logger.write(`[DEBUG] ${this.name} received player input, waking up.`);
+            this.waitingForPlayer = false;
+        }
+        // If another NPC tries to trigger us and we are waiting for a player, ignore
+        if (this.waitingForPlayer && actor instanceof NPC) {
+            this.logger.write(`[DEBUG] ${this.name} is waiting for player input, ignoring NPC.`);
+            return;
+        }
+        // If another NPC tries to trigger us and we are on cooldown, ignore
+        if (actor instanceof NPC) {
+            const now = Date.now();
+            if (now - this.lastNpcHeardTime < NPC.npcHearCooldownMs) {
+                this.logger.write(`[DEBUG] ${this.name} is on NPC hear cooldown.`);
+                return;
+            }
+            this.lastNpcHeardTime = now;
+            this.waitingForPlayer = true;
+            this.logger.write(`[DEBUG] ${this.name} heard NPC, entering waiting state.`);
+        }
+        // Process input
+        const entry = `${actor.name} says: "${message}"`;
+        this._addToHistory(entry);
+        this.logger.write(`${this.name} heard from ${actor.name}`);
+        await this.respondTo(actor, message);
+    }
+    async see(actor, verb, details) {
+        try {
+            if (actor === this || actor.name === this.name)
+                return;
+            if (!(actor instanceof NPC)) {
+                if (this.waitingForPlayer)
+                    this.logger.write(`[DEBUG] ${this.name} received player action, waking up.`);
+                this.waitingForPlayer = false;
+            }
+            if (this.waitingForPlayer && actor instanceof NPC) {
+                this.logger.write(`[DEBUG] ${this.name} is waiting for player input, ignoring NPC action.`);
+                return;
+            }
+            if (actor instanceof NPC) {
+                const now = Date.now();
+                if (now - this.lastNpcSeenTime < NPC.npcSeeCooldownMs) {
+                    this.logger.write(`[DEBUG] ${this.name} is on NPC see cooldown.`);
+                    return;
+                }
+                this.lastNpcSeenTime = now;
+                this.waitingForPlayer = true;
+                this.logger.write(`[DEBUG] ${this.name} saw NPC, entering waiting state.`);
+            }
+            const entry = `${actor.name} ${verb}${details ? ` ${details}` : ''}`;
+            this._addToHistory(entry);
+            this.logger.write(`${this.name} sees ${entry}`);
+            await this.respondTo(actor, entry);
+        }
+        catch (error) {
+            this.logger.error(`Error in see: ${error}`);
+            throw new Error(error);
+        }
+    }
+    _addToHistory(entry) {
+        this._history.push(entry);
+        if (this._history.length > this._maxHistory) {
+            this._history.shift();
+        }
+    }
+    getHistorySummary() {
+        if (this._history.length === 0)
+            return `This NPC has not observed any recent activity.`;
+        const history = `Recent activity around this NPC:\n${this._history.map((h, i) => `  ${i + 1}. ${h}`)?.join('\n')}`;
+        this.logger.write(history);
+        return history;
+    }
+    speak(message) {
+        return message || this._dialogue[Math.floor(Math.random() * this._dialogue.length)];
+    }
+    async recursiveReflect(commandString, result, recursionDepth = 0, maxRecursion = this._maxRecursion) {
+        if (recursionDepth >= maxRecursion) {
+            this.logger.write('Max recursion reached.');
+            return;
+        }
+        const historySummary = this.getHistorySummary();
+        // Build the prompt context
+        const context = `
+You are an NPC named ${this.name}.
+
+You just performed the action: "${commandString}"
+With the result: "${result}"
+
+Based on this, what is the most logical next in-game command (from the following list)?
+    ${this._commandHelp}
+- Only respond with: [COMMAND] <in-game command here>
+- Do not respond on behalf of another player or NPC
+- If there is nothing to do, respond with: wait
+- Only respond with one [COMMAND]
+
+This is what has already happened:
+${historySummary}
+`;
+        // Send to GPT
+        const gptResult = await HTTPS.askGPT({
+            prompt: context,
+            openApiKey: process.env.OPENAI_API_KEY || '',
+            model: 'gpt-4.1'
+        });
+        const reply = JSON.parse(gptResult.data)?.choices?.[0]?.message?.content?.trim();
+        if (!reply || reply.toLowerCase().includes('wait')) {
+            this.logger.write(`${this.name} is finished reflecting for now.`);
+            return;
+        }
+        // Parse the next command, execute, and reflect again
+        const nextCommandMatch = reply.match(/^\[COMMAND\]\s*(.*)$/i);
+        if (nextCommandMatch && nextCommandMatch[1]) {
+            const nextCommand = nextCommandMatch[1];
+            const command = await this.commandRegistry.parse(nextCommand, this);
+            if (command) {
+                const nextResult = await command.execute();
+                if (nextResult) {
+                    this._addToHistory(nextResult);
+                }
+                await this.recursiveReflect(nextCommand, nextResult, recursionDepth + 1, maxRecursion);
+            }
+            else {
+                this.logger.error(`NPC planned unknown command: ${nextCommand}`);
+            }
+        }
+        else {
+            this.logger.write('No valid command parsed from GPT reflection.');
+        }
+    }
+    async respondTo(actor, message) {
+        this.logger.write('Attempting to respond');
+        if (!process.env.OPENAI_API_KEY) {
+            this.logger.write(`No AI available`);
+            await actor.hear(this, this.speak());
+            return;
+        }
+        // ---------- helpers ----------
+        const safeArray = (arr, label = 'unknown') => {
+            const ok = Array.isArray(arr) ? arr : [];
+            if (!Array.isArray(arr)) {
+                this.logger.write(`[DEBUG][${this.name}] ${label} was not an array, substituting []. Value: ${JSON.stringify(arr)}`);
+            }
+            return ok;
+        };
+        const toLines = (s) => {
+            if (typeof s !== 'string')
+                return [];
+            return s.split(/\r?\n/);
+        };
+        // ---------- scene + npc context ----------
+        const story = this._scene?.story
+            ? `The overall storyline for this scene is: ${this._scene.story}`
+            : `This scene has no overall storyline`;
+        const historySummary = this.getHistorySummary();
+        const npcDescription = this.description
+            ? `This NPC has the following characteristics: ${this._description}`
+            : `This NPC is non-descript.`;
+        this.logger.write(npcDescription);
+        const lifestyleSummary = Array.isArray(this.lifestyleChoices) && this.lifestyleChoices.length > 0
+            ? `This NPC has the following lifestyle characteristics: ${this.lifestyleChoices.join(', ')}.`
+            : `This NPC has no defined lifestyle preferences.`;
+        const room = this.currentLocation;
+        if (!room) {
+            this.logger.error(`[ERROR][${this.name}] currentLocation is undefined in respondTo!`);
+            return;
+        }
+        const roomDesc = `They are currently in: "${room.name}" — ${room.description}`;
+        // ---------- exits (fully defensive) ----------
+        let safeExits = [];
+        try {
+            if (room.exits && typeof room.exits.entries === 'function') {
+                safeExits = Array.from(room.exits.entries());
+            }
+            else {
+                this.logger.write(`[DEBUG][${this.name}] room.exits missing or not iterable; using empty exits.`);
+            }
+        }
+        catch (e) {
+            this.logger.error(`[ERROR][${this.name}] room.exits.entries() failed: ${e}`);
+        }
+        const formattedExitsArr = safeExits.map(([direction, exit]) => {
+            const directionLabel = capitalCase(direction);
+            if (exit instanceof Door) {
+                const targetRoom = exit.getOtherSideToName(room);
+                const isLocked = exit.checkIfLocked();
+                const isLockable = exit.checkIfLockable();
+                let requirementDetail = '';
+                if (isLocked)
+                    requirementDetail = ` Requires key: "${exit.unlockItemOrSolution}".`;
+                const status = isLocked ? ' (Locked)' : (isLockable ? ' (Unlocked)' : '');
+                return `${directionLabel} → ${targetRoom}${status}${requirementDetail}`;
+            }
+            if (typeof exit === 'string') {
+                return `${directionLabel} → ${exit}`;
+            }
+            return `${directionLabel} → Unknown`;
+        });
+        const formattedExitsStr = Array.isArray(formattedExitsArr) && formattedExitsArr.length > 0
+            ? formattedExitsArr.join('\n')
+            : '';
+        // ---------- ownership + inventories (defensive) ----------
+        const ownedRooms = safeArray(this._scene?.getOwnedRoomsBy?.(this.name), 'ownedRooms');
+        this.logger.write(`[DEBUG][${this.name}] ownedRooms: ${JSON.stringify(ownedRooms)}`);
+        const ownedRoomsDesc = ownedRooms.length > 0
+            ? `They own the following rooms: ${ownedRooms.filter(r => r && r.name).map(r => `"${r.name}"`).join(', ')}.`
+            : `They do not appear to own any rooms.`;
+        const ownedItems = safeArray(this._scene?.getOwnedItemsBy?.(this.name), 'ownedItems');
+        this.logger.write(`[DEBUG][${this.name}] ownedItems: ${JSON.stringify(ownedItems)}`);
+        const ownedItemsDesc = ownedItems.length > 0
+            ? `They own the following items: ${ownedItems.filter(i => i && i.name).map(i => `"${i.name}"`).join(', ')}.`
+            : `They do not appear to own any items.`;
+        const npcItems = safeArray(this.inventory?.getAllItems?.(), 'npcItems');
+        this.logger.write(`[DEBUG][${this.name}] npcItems: ${JSON.stringify(npcItems)}`);
+        const npcInventoryDesc = npcItems.length > 0
+            ? `This NPC is carrying the following items:\n${npcItems
+                .filter(item => !!item)
+                .map(item => `- ${item.getFormattedCharacteristics?.() ?? (item.name ?? '[unnamed item]')}`)
+                .join('\n')}`
+            : `This NPC is not carrying anything.`;
+        const visibleItems = safeArray(room.inventory?.getAllItems?.(), 'visibleItems');
+        this.logger.write(`[DEBUG][${this.name}] visibleItems: ${JSON.stringify(visibleItems)}`);
+        const roomInventoryDesc = visibleItems.length > 0
+            ? `Items visible in the room: ${visibleItems.filter(i => i && i.name).map(i => i.name).join(', ')}.`
+            : `There are no visible items in the room.`;
+        // ---------- prompt ----------
+        const prompt = `
+You are an NPC named ${this.name} in a gritty cyberpunk text adventure game.
+
+- Stay in character. Respond naturally based on your surroundings, personality, and the player’s message.
+- Any exposition should be in 3rd person. Keep exposition to bare minimum.
+- When speaking, use the "say" command. Syntax is "[COMMAND] say <message>"
+- If you want to perform an action, include a separate line that starts with:
+  [COMMAND] <your in-game command here>
+- Attempt to use [COMMAND] when appropriate for interacting with the environment. (e.g., "take <item>" when picking up)
+- You should only provide one [COMMAND] at a time.
+- Do not respond on behalf of another player or NPC
+
+Your objective is to drive the story line.
+    ${story}
+
+    ${this._commandHelp}
+
+    ${npcDescription}
+
+    ${roomDesc}
+    ${formattedExitsStr}
+    ${roomInventoryDesc}
+
+    ${lifestyleSummary}
+    ${npcInventoryDesc}
+
+    ${ownedRoomsDesc}
+    ${ownedItemsDesc}
+
+    ${historySummary}
+
+  ${actor.name}: ${message}
+`.trim();
+        // ---------- GPT call + parsing (defensive) ----------
+        try {
+            const result = await HTTPS.askGPT({
+                prompt,
+                openApiKey: process.env.OPENAI_API_KEY,
+                model: 'gpt-4.1'
+            });
+            let parsed;
+            try {
+                parsed = JSON.parse(result?.data ?? '{}');
+            }
+            catch (e) {
+                this.logger.error(`[ERROR][${this.name}] JSON.parse failed on result.data: ${e}`);
+                return;
+            }
+            if (parsed?.error) {
+                throw new Error(parsed.error.message ?? 'Unknown GPT error');
+            }
+            const reply = parsed?.choices?.[0]?.message?.content?.trim?.();
+            if (!reply || typeof reply !== 'string') {
+                this.logger.write(`[DEBUG][${this.name}] Empty or invalid reply from GPT; no action taken.`);
+                return;
+            }
+            this._addToHistory(reply);
+            const lines = toLines(reply);
+            // Spoken lines
+            const spokenLines = lines.filter(line => line.startsWith('[COMMAND] say'));
+            // Commands (excluding say/talk-to)
+            const commandLines = lines.filter(line => line.startsWith('[COMMAND]') &&
+                !line.startsWith('[COMMAND] say') &&
+                !line.startsWith('[COMMAND] talk-to'));
+            // Exposition (non-command lines)
+            const expositionLines = lines.filter(line => !line.startsWith('[COMMAND]'));
+            // Speak each say command
+            for (const spokenText of spokenLines) {
+                const commandText = (spokenText ?? '').replace('[COMMAND]', '').trim();
+                this.logger.write(`${this.name} attempts to say: ${commandText}`);
+                try {
+                    if (commandText.length > 0) {
+                        await this.act(commandText);
+                    }
+                }
+                catch (err) {
+                    this.logger.error(`${this.name} failed to say "${commandText}": ${err}`);
+                    // continue; don't throw so we can process remaining lines
+                }
+            }
+            // Log exposition
+            for (const exposition of expositionLines) {
+                if (exposition?.length) {
+                    this.logger.logWithColor(`${exposition}`, 'blue');
+                }
+            }
+            // Execute other commands
+            for (const commandLine of commandLines) {
+                const commandText = (commandLine ?? '').replace('[COMMAND]', '').trim();
+                this.logger.write(`${this.name} attempts to execute: ${commandText}`);
+                try {
+                    if (commandText.length > 0) {
+                        await this.act(commandText);
+                    }
+                }
+                catch (err) {
+                    this.logger.error(`${this.name} failed to execute command "${commandText}": ${err}`);
+                    // continue; don't throw so we can process remaining lines
+                }
+            }
+        }
+        catch (err) {
+            this.logger.write(`GPT fallback due to error: ${err}`);
+            // surface a consistent Error instance, but don't double-wrap Errors
+            const e = err instanceof Error ? err : new Error(String(err));
+            throw e;
+        }
+    }
+}
+//# sourceMappingURL=npc.js.map