@sharpee/core 0.9.56-beta

package/dist/query/query-manager.d.ts

@@ -0,0 +1,86 @@
+/**
+ * Query Manager - Manages pending queries and routes responses
+ *
+ * This is the core component of the PC communication system (ADR-018).
+ * It tracks pending queries, validates responses, and routes them to
+ * appropriate handlers.
+ */
+import EventEmitter from 'eventemitter3';
+import { IPendingQuery, IQueryResponse, IQueryState, IQueryHandler, QueryValidator, IQueryEvents } from './types';
+import { ISemanticEventSource } from '../events';
+/**
+ * Query Manager implementation
+ */
+export declare class QueryManager extends EventEmitter {
+    private state;
+    private handlers;
+    private validators;
+    private timeouts;
+    private eventSource;
+    constructor();
+    /**
+     * Register a query handler
+     */
+    registerHandler(id: string, handler: IQueryHandler): void;
+    /**
+     * Register a response validator
+     */
+    registerValidator(name: string, validator: QueryValidator): void;
+    /**
+     * Present a query to the player
+     */
+    askQuery(query: IPendingQuery): Promise<IQueryResponse | null>;
+    /**
+     * Process input while a query is pending
+     */
+    processInput(input: string): 'handled' | 'interrupt' | 'pass';
+    /**
+     * Cancel the current query
+     */
+    cancelCurrentQuery(): void;
+    /**
+     * Get current state
+     */
+    getState(): Readonly<IQueryState>;
+    /**
+     * Get event source for connecting to engine
+     */
+    getEventSource(): ISemanticEventSource;
+    /**
+     * Check if there's a pending query
+     */
+    hasPendingQuery(): boolean;
+    /**
+     * Get the current pending query
+     */
+    getCurrentQuery(): IPendingQuery | undefined;
+    /**
+     * Clear all queries
+     */
+    clearAll(): void;
+    /**
+     * Handle query timeout
+     */
+    private handleTimeout;
+    /**
+     * Interrupt a query with a command
+     */
+    private interruptQuery;
+    /**
+     * Find handler for a query
+     */
+    private findHandler;
+    /**
+     * Check if input looks like a command
+     */
+    private looksLikeCommand;
+}
+/**
+ * Create a new query manager instance
+ */
+export declare function createQueryManager(): QueryManager;
+/**
+ * Type guard for query events
+ */
+export declare function isQueryEvent<K extends keyof IQueryEvents>(event: string | symbol, key: K): event is K;
+//# sourceMappingURL=query-manager.d.ts.map

package/dist/query/query-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-manager.d.ts","sourceRoot":"","sources":["../../src/query/query-manager.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,YAAY,MAAM,eAAe,CAAC;AACzC,OAAO,EACL,aAAa,EACb,cAAc,EACd,WAAW,EACX,aAAa,EACb,cAAc,EAEd,YAAY,EAEb,MAAM,SAAS,CAAC;AACjB,OAAO,EAAkB,oBAAoB,EAA6B,MAAM,WAAW,CAAC;AAE5F;;GAEG;AACH,qBAAa,YAAa,SAAQ,YAAY;IAC5C,OAAO,CAAC,KAAK,CAIX;IAEF,OAAO,CAAC,QAAQ,CAAoC;IACpD,OAAO,CAAC,UAAU,CAAqC;IACvD,OAAO,CAAC,QAAQ,CAAoD;IACpE,OAAO,CAAC,WAAW,CAAqD;;IAiBxE;;OAEG;IACH,eAAe,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,GAAG,IAAI;IAIzD;;OAEG;IACH,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,cAAc,GAAG,IAAI;IAIhE;;OAEG;IACG,QAAQ,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;IAiEpE;;OAEG;IACH,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,WAAW,GAAG,MAAM;IAiH7D;;OAEG;IACH,kBAAkB,IAAI,IAAI;IAwC1B;;OAEG;IACH,QAAQ,IAAI,QAAQ,CAAC,WAAW,CAAC;IAIjC;;OAEG;IACH,cAAc,IAAI,oBAAoB;IAItC;;OAEG;IACH,eAAe,IAAI,OAAO;IAI1B;;OAEG;IACH,eAAe,IAAI,aAAa,GAAG,SAAS;IAI5C;;OAEG;IACH,QAAQ,IAAI,IAAI;IAiBhB;;OAEG;IACH,OAAO,CAAC,aAAa;IAgCrB;;OAEG;IACH,OAAO,CAAC,cAAc;IAwBtB;;OAEG;IACH,OAAO,CAAC,WAAW;IASnB;;OAEG;IACH,OAAO,CAAC,gBAAgB;CAWzB;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,YAAY,CAEjD;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,CAAC,SAAS,MAAM,YAAY,EACvD,KAAK,EAAE,MAAM,GAAG,MAAM,EACtB,GAAG,EAAE,CAAC,GACL,KAAK,IAAI,CAAC,CAEZ"}

package/dist/query/query-manager.js

@@ -0,0 +1,391 @@
+"use strict";
+/**
+ * Query Manager - Manages pending queries and routes responses
+ *
+ * This is the core component of the PC communication system (ADR-018).
+ * It tracks pending queries, validates responses, and routes them to
+ * appropriate handlers.
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.QueryManager = void 0;
+exports.createQueryManager = createQueryManager;
+exports.isQueryEvent = isQueryEvent;
+const eventemitter3_1 = __importDefault(require("eventemitter3"));
+const types_1 = require("./types");
+const events_1 = require("../events");
+/**
+ * Query Manager implementation
+ */
+class QueryManager extends eventemitter3_1.default {
+    state = {
+        queryStack: [],
+        history: [],
+        interceptingInput: false
+    };
+    handlers = new Map();
+    validators = new Map();
+    timeouts = new Map();
+    eventSource = (0, events_1.createSemanticEventSource)();
+    constructor() {
+        super();
+        // Register standard validators
+        this.registerValidator('yes_no', types_1.StandardValidators.yesNo);
+        this.registerValidator('numeric', (response, query) => {
+            const min = query.context.min;
+            const max = query.context.max;
+            return types_1.StandardValidators.numeric(response, min, max);
+        });
+        this.registerValidator('multiple_choice', (response, query) => {
+            return types_1.StandardValidators.multipleChoice(response, query.options || []);
+        });
+    }
+    /**
+     * Register a query handler
+     */
+    registerHandler(id, handler) {
+        this.handlers.set(id, handler);
+    }
+    /**
+     * Register a response validator
+     */
+    registerValidator(name, validator) {
+        this.validators.set(name, validator);
+    }
+    /**
+     * Present a query to the player
+     */
+    async askQuery(query) {
+        // If there's already a pending query, stack this one
+        if (this.state.pendingQuery) {
+            if (query.priority && query.priority > (this.state.pendingQuery.priority || 0)) {
+                // Higher priority interrupts
+                this.state.queryStack.unshift(this.state.pendingQuery);
+                this.state.pendingQuery = query;
+            }
+            else {
+                // Queue for later
+                this.state.queryStack.push(query);
+                return null;
+            }
+        }
+        else {
+            this.state.pendingQuery = query;
+        }
+        // Start intercepting input
+        this.state.interceptingInput = true;
+        // Emit the query event
+        this.emit('query:pending', query);
+        // Set timeout if specified
+        if (query.timeout) {
+            const timeoutId = setTimeout(() => {
+                this.handleTimeout(query);
+            }, query.timeout);
+            this.timeouts.set(query.id, timeoutId);
+        }
+        // Return a promise that resolves when answered
+        return new Promise((resolve) => {
+            const answerHandler = (response, answeredQuery) => {
+                if (answeredQuery.id === query.id) {
+                    this.off('query:answered', answerHandler);
+                    this.off('query:timeout', timeoutHandler);
+                    this.off('query:cancelled', cancelHandler);
+                    resolve(response);
+                }
+            };
+            const timeoutHandler = (timedOutQuery) => {
+                if (timedOutQuery.id === query.id) {
+                    this.off('query:answered', answerHandler);
+                    this.off('query:timeout', timeoutHandler);
+                    this.off('query:cancelled', cancelHandler);
+                    resolve(null);
+                }
+            };
+            const cancelHandler = (cancelledQuery) => {
+                if (cancelledQuery.id === query.id) {
+                    this.off('query:answered', answerHandler);
+                    this.off('query:timeout', timeoutHandler);
+                    this.off('query:cancelled', cancelHandler);
+                    resolve(null);
+                }
+            };
+            this.on('query:answered', answerHandler);
+            this.on('query:timeout', timeoutHandler);
+            this.on('query:cancelled', cancelHandler);
+        });
+    }
+    /**
+     * Process input while a query is pending
+     */
+    processInput(input) {
+        if (!this.state.pendingQuery || !this.state.interceptingInput) {
+            return 'pass';
+        }
+        const query = this.state.pendingQuery;
+        // Check if this looks like a command (for interruption)
+        if (this.looksLikeCommand(input) && query.allowInterruption) {
+            this.interruptQuery(query, input);
+            return 'interrupt';
+        }
+        // Validate the response
+        let validationResult = { valid: true, normalized: input };
+        if (query.validator) {
+            const validator = this.validators.get(query.validator);
+            if (validator) {
+                validationResult = validator(input, query);
+            }
+        }
+        else if (query.type === 'multiple_choice' && query.options) {
+            // Default validation for multiple choice queries
+            const trimmed = input.trim().toLowerCase();
+            const optionIndex = parseInt(trimmed, 10) - 1;
+            if (!isNaN(optionIndex) && optionIndex >= 0 && optionIndex < query.options.length) {
+                // Numeric selection
+                validationResult = { valid: true, normalized: optionIndex };
+            }
+            else if (query.options.some(opt => opt.toLowerCase() === trimmed)) {
+                // Text match
+                validationResult = { valid: true, normalized: trimmed };
+            }
+            else {
+                // Invalid response
+                validationResult = {
+                    valid: false,
+                    message: `Please select one of the available options: ${query.options.join(', ')}`,
+                    hint: 'You can enter the option number or text'
+                };
+            }
+        }
+        if (!validationResult.valid) {
+            this.emit('query:invalid', input, validationResult, query);
+            // Also emit as a semantic event
+            const invalidEventData = {
+                queryId: query.id,
+                input,
+                message: validationResult.message || 'Invalid response',
+                hint: validationResult.hint
+            };
+            const invalidEvent = {
+                id: `evt_${Date.now()}_${Math.random().toString(36).substr(2, 9)}`,
+                type: 'query.invalid',
+                timestamp: Date.now(),
+                entities: {},
+                data: invalidEventData
+            };
+            this.eventSource.emit(invalidEvent);
+            return 'handled';
+        }
+        // Create response object
+        const response = {
+            queryId: query.id,
+            rawInput: input,
+            response: validationResult.normalized || input,
+            selectedIndex: typeof validationResult.normalized === 'number' ?
+                validationResult.normalized : undefined,
+            wasInterrupted: false,
+            timestamp: Date.now()
+        };
+        // Clear timeout
+        const timeoutId = this.timeouts.get(query.id);
+        if (timeoutId) {
+            clearTimeout(timeoutId);
+            this.timeouts.delete(query.id);
+        }
+        // Record in history
+        this.state.history.push({
+            query,
+            response,
+            result: 'answered'
+        });
+        // Clear current query
+        this.state.pendingQuery = undefined;
+        // Process next query in stack
+        if (this.state.queryStack.length > 0) {
+            const nextQuery = this.state.queryStack.shift();
+            this.state.pendingQuery = nextQuery;
+            this.emit('query:pending', nextQuery);
+        }
+        else {
+            this.state.interceptingInput = false;
+        }
+        // Emit answer event
+        this.emit('query:answered', response, query);
+        // Route to handler if registered
+        const handler = this.findHandler(query);
+        if (handler) {
+            handler.handleResponse(response, query);
+        }
+        return 'handled';
+    }
+    /**
+     * Cancel the current query
+     */
+    cancelCurrentQuery() {
+        if (!this.state.pendingQuery)
+            return;
+        const query = this.state.pendingQuery;
+        // Clear timeout
+        const timeoutId = this.timeouts.get(query.id);
+        if (timeoutId) {
+            clearTimeout(timeoutId);
+            this.timeouts.delete(query.id);
+        }
+        // Record in history
+        this.state.history.push({
+            query,
+            result: 'cancelled'
+        });
+        // Clear current query
+        this.state.pendingQuery = undefined;
+        // Process next query
+        if (this.state.queryStack.length > 0) {
+            const nextQuery = this.state.queryStack.shift();
+            this.state.pendingQuery = nextQuery;
+            this.emit('query:pending', nextQuery);
+        }
+        else {
+            this.state.interceptingInput = false;
+        }
+        // Emit cancel event
+        this.emit('query:cancelled', query);
+        // Notify handler
+        const handler = this.findHandler(query);
+        if (handler && handler.handleCancel) {
+            handler.handleCancel(query);
+        }
+    }
+    /**
+     * Get current state
+     */
+    getState() {
+        return { ...this.state };
+    }
+    /**
+     * Get event source for connecting to engine
+     */
+    getEventSource() {
+        return this.eventSource;
+    }
+    /**
+     * Check if there's a pending query
+     */
+    hasPendingQuery() {
+        return !!this.state.pendingQuery;
+    }
+    /**
+     * Get the current pending query
+     */
+    getCurrentQuery() {
+        return this.state.pendingQuery;
+    }
+    /**
+     * Clear all queries
+     */
+    clearAll() {
+        // Cancel current query
+        if (this.state.pendingQuery) {
+            this.cancelCurrentQuery();
+        }
+        // Clear stack
+        this.state.queryStack = [];
+        this.state.interceptingInput = false;
+        // Clear all timeouts
+        for (const [, timeoutId] of this.timeouts) {
+            clearTimeout(timeoutId);
+        }
+        this.timeouts.clear();
+    }
+    /**
+     * Handle query timeout
+     */
+    handleTimeout(query) {
+        if (this.state.pendingQuery?.id !== query.id)
+            return;
+        // Record in history
+        this.state.history.push({
+            query,
+            result: 'timeout'
+        });
+        // Clear current query
+        this.state.pendingQuery = undefined;
+        this.timeouts.delete(query.id);
+        // Process next query
+        if (this.state.queryStack.length > 0) {
+            const nextQuery = this.state.queryStack.shift();
+            this.state.pendingQuery = nextQuery;
+            this.emit('query:pending', nextQuery);
+        }
+        else {
+            this.state.interceptingInput = false;
+        }
+        // Emit timeout event
+        this.emit('query:timeout', query);
+        // Notify handler
+        const handler = this.findHandler(query);
+        if (handler && handler.handleTimeout) {
+            handler.handleTimeout(query);
+        }
+    }
+    /**
+     * Interrupt a query with a command
+     */
+    interruptQuery(query, command) {
+        // Clear timeout
+        const timeoutId = this.timeouts.get(query.id);
+        if (timeoutId) {
+            clearTimeout(timeoutId);
+            this.timeouts.delete(query.id);
+        }
+        // Record in history
+        this.state.history.push({
+            query,
+            result: 'cancelled'
+        });
+        // Clear current query
+        this.state.pendingQuery = undefined;
+        // Don't process next query - let the command execute
+        this.state.interceptingInput = false;
+        // Emit interrupt event
+        this.emit('query:interrupted', query, command);
+    }
+    /**
+     * Find handler for a query
+     */
+    findHandler(query) {
+        for (const [, handler] of this.handlers) {
+            if (handler.canHandle(query)) {
+                return handler;
+            }
+        }
+        return undefined;
+    }
+    /**
+     * Check if input looks like a command
+     */
+    looksLikeCommand(input) {
+        const commandPatterns = [
+            /^(look|take|drop|go|examine|inventory|save|load|help)/i,
+            /^(n|s|e|w|ne|nw|se|sw|up|down|in|out)$/i,
+            /^x\s+/i, // "x thing" for examine
+            /^g\s+/i, // "g place" for go
+            /^l$/i // "l" for look
+        ];
+        return commandPatterns.some(pattern => pattern.test(input.trim()));
+    }
+}
+exports.QueryManager = QueryManager;
+/**
+ * Create a new query manager instance
+ */
+function createQueryManager() {
+    return new QueryManager();
+}
+/**
+ * Type guard for query events
+ */
+function isQueryEvent(event, key) {
+    return event === key;
+}
+//# sourceMappingURL=query-manager.js.map

package/dist/query/query-manager.js.map

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

package/dist/query/types.d.ts

@@ -0,0 +1,188 @@
+/**
+ * Core types for the PC communication query system
+ *
+ * These types define the structure of queries, responses, and validation
+ * for the client query system (ADR-018).
+ */
+/**
+ * Sources that can initiate queries
+ */
+export declare enum QuerySource {
+    /** System-level queries (save, quit, restart) */
+    SYSTEM = "system",
+    /** Parser disambiguation queries */
+    DISAMBIGUATION = "disambiguation",
+    /** NPC dialogue queries */
+    NPC = "npc",
+    /** Game mechanic queries (passwords, combinations) */
+    GAME_MECHANIC = "mechanic",
+    /** Narrative-driven queries */
+    NARRATIVE = "narrative"
+}
+/**
+ * Types of queries that can be presented
+ */
+export declare enum QueryType {
+    /** Simple yes/no question */
+    YES_NO = "yes_no",
+    /** Multiple choice with predefined options */
+    MULTIPLE_CHOICE = "multiple_choice",
+    /** Open-ended text input */
+    FREE_TEXT = "free_text",
+    /** Numeric input only */
+    NUMERIC = "numeric",
+    /** Special type for disambiguation */
+    DISAMBIGUATION = "disambiguation"
+}
+/**
+ * A query waiting for player response
+ */
+export interface IPendingQuery {
+    /** Unique identifier for this query */
+    id: string;
+    /** Source that initiated the query */
+    source: QuerySource;
+    /** Type of query */
+    type: QueryType;
+    /** Message ID for the query prompt */
+    messageId: string;
+    /** Parameters for message formatting */
+    messageParams?: Record<string, any>;
+    /** Available options (for multiple choice) */
+    options?: string[];
+    /** Additional context for the query handler */
+    context: IQueryContext;
+    /** Whether the player can interrupt this query */
+    allowInterruption: boolean;
+    /** Name of the validator to use */
+    validator?: string;
+    /** Optional timeout in milliseconds */
+    timeout?: number;
+    /** Timestamp when query was created */
+    created: number;
+    /** Priority level (higher = more important) */
+    priority?: number;
+}
+/**
+ * Context data passed with queries
+ */
+export interface IQueryContext {
+    /** Query-specific data */
+    [key: string]: any;
+    /** For quit queries */
+    score?: number;
+    maxScore?: number;
+    moves?: number;
+    hasUnsavedProgress?: boolean;
+    nearComplete?: boolean;
+    /** For save queries */
+    existingFile?: string;
+    lastSaveTime?: number;
+    /** For disambiguation */
+    candidates?: Array<{
+        id: string;
+        name: string;
+        description?: string;
+    }>;
+    /** For NPC queries */
+    npcId?: string;
+    npcName?: string;
+    topic?: string;
+    /** For game mechanic queries */
+    attempts?: number;
+    maxAttempts?: number;
+    hint?: string;
+}
+/**
+ * Player's response to a query
+ */
+export interface IQueryResponse {
+    /** ID of the query being responded to */
+    queryId: string;
+    /** Raw input from the player */
+    rawInput: string;
+    /** Processed/normalized response */
+    response: string | number | boolean;
+    /** Selected option index (for multiple choice) */
+    selectedIndex?: number;
+    /** Whether this was an interruption */
+    wasInterrupted: boolean;
+    /** Timestamp of response */
+    timestamp: number;
+}
+/**
+ * Function to validate a response
+ */
+export type QueryValidator = (response: string, query: IPendingQuery) => IValidationResult;
+/**
+ * Result of validating a response
+ */
+export interface IValidationResult {
+    /** Whether the response is valid */
+    valid: boolean;
+    /** Error message if invalid */
+    message?: string;
+    /** Normalized/parsed response value */
+    normalized?: any;
+    /** Hint for the player */
+    hint?: string;
+}
+/**
+ * Handler for processing query responses
+ */
+export interface IQueryHandler {
+    /** Query types this handler can process */
+    canHandle: (query: IPendingQuery) => boolean;
+    /** Process a validated response */
+    handleResponse: (response: IQueryResponse, query: IPendingQuery) => void;
+    /** Handle query timeout */
+    handleTimeout?: (query: IPendingQuery) => void;
+    /** Handle query cancellation */
+    handleCancel?: (query: IPendingQuery) => void;
+}
+/**
+ * Query manager state
+ */
+export interface IQueryState {
+    /** Currently active query */
+    pendingQuery?: IPendingQuery;
+    /** Stack of queries waiting to be presented */
+    queryStack: IPendingQuery[];
+    /** History of recent queries and responses */
+    history: Array<{
+        query: IPendingQuery;
+        response?: IQueryResponse;
+        result: 'answered' | 'timeout' | 'cancelled';
+    }>;
+    /** Whether input is currently being routed to query system */
+    interceptingInput: boolean;
+}
+/**
+ * Events emitted by the query system
+ */
+export interface IQueryEvents {
+    /** A new query needs to be presented to the player */
+    'query:pending': (query: IPendingQuery) => void;
+    /** A query was answered */
+    'query:answered': (response: IQueryResponse, query: IPendingQuery) => void;
+    /** A query timed out */
+    'query:timeout': (query: IPendingQuery) => void;
+    /** A query was cancelled */
+    'query:cancelled': (query: IPendingQuery) => void;
+    /** A query was interrupted by a command */
+    'query:interrupted': (query: IPendingQuery, command: string) => void;
+    /** Validation failed for a response */
+    'query:invalid': (response: string, result: IValidationResult, query: IPendingQuery) => void;
+}
+/**
+ * Standard validators
+ */
+export declare const StandardValidators: {
+    /** Validate yes/no responses */
+    yesNo: (response: string) => IValidationResult;
+    /** Validate numeric responses */
+    numeric: (response: string, min?: number, max?: number) => IValidationResult;
+    /** Validate multiple choice responses */
+    multipleChoice: (response: string, options: string[]) => IValidationResult;
+};
+//# sourceMappingURL=types.d.ts.map