@sharpee/parser-en-us 0.9.60-beta

package/dist/index.js

@@ -0,0 +1,44 @@
+"use strict";
+/**
+ * English (US) Parser for Sharpee Interactive Fiction Platform
+ *
+ * This package provides English-specific parsing functionality
+ * for converting natural language commands into structured commands.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.metadata = exports.INANIMATE_THEM = exports.INANIMATE_IT = exports.RECOGNIZED_PRONOUNS = exports.isRecognizedPronoun = exports.PronounContextManager = exports.analyzeBestFailure = exports.Parser = exports.EnglishParser = void 0;
+var english_parser_1 = require("./english-parser");
+Object.defineProperty(exports, "EnglishParser", { enumerable: true, get: function () { return english_parser_1.EnglishParser; } });
+var english_parser_2 = require("./english-parser"); // For convenience
+Object.defineProperty(exports, "Parser", { enumerable: true, get: function () { return english_parser_2.EnglishParser; } });
+var parse_failure_1 = require("./parse-failure");
+Object.defineProperty(exports, "analyzeBestFailure", { enumerable: true, get: function () { return parse_failure_1.analyzeBestFailure; } });
+var pronoun_context_1 = require("./pronoun-context");
+Object.defineProperty(exports, "PronounContextManager", { enumerable: true, get: function () { return pronoun_context_1.PronounContextManager; } });
+Object.defineProperty(exports, "isRecognizedPronoun", { enumerable: true, get: function () { return pronoun_context_1.isRecognizedPronoun; } });
+Object.defineProperty(exports, "RECOGNIZED_PRONOUNS", { enumerable: true, get: function () { return pronoun_context_1.RECOGNIZED_PRONOUNS; } });
+Object.defineProperty(exports, "INANIMATE_IT", { enumerable: true, get: function () { return pronoun_context_1.INANIMATE_IT; } });
+Object.defineProperty(exports, "INANIMATE_THEM", { enumerable: true, get: function () { return pronoun_context_1.INANIMATE_THEM; } });
+/**
+ * Package metadata
+ */
+exports.metadata = {
+    languageCode: 'en-US',
+    languageName: 'English (United States)',
+    parserVersion: '1.0.0',
+    supportedPatterns: [
+        'VERB_ONLY',
+        'VERB_NOUN',
+        'VERB_PREP_NOUN',
+        'VERB_NOUN_PREP_NOUN',
+        'DIRECTION_ONLY'
+    ],
+    features: [
+        'compound-verbs',
+        'articles',
+        'adjectives',
+        'abbreviations',
+        'multi-word-nouns'
+    ]
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAEH,mDAAiD;AAAxC,+GAAA,aAAa,OAAA;AACtB,mDAA2D,CAAC,kBAAkB;AAArE,wGAAA,aAAa,OAAU;AAWhC,iDAAqD;AAA5C,mHAAA,kBAAkB,OAAA;AAI3B,qDAM2B;AALzB,wHAAA,qBAAqB,OAAA;AACrB,sHAAA,mBAAmB,OAAA;AACnB,sHAAA,mBAAmB,OAAA;AACnB,+GAAA,YAAY,OAAA;AACZ,iHAAA,cAAc,OAAA;AAGhB;;GAEG;AACU,QAAA,QAAQ,GAAG;IACtB,YAAY,EAAE,OAAO;IACrB,YAAY,EAAE,yBAAyB;IACvC,aAAa,EAAE,OAAO;IACtB,iBAAiB,EAAE;QACjB,WAAW;QACX,WAAW;QACX,gBAAgB;QAChB,qBAAqB;QACrB,gBAAgB;KACjB;IACD,QAAQ,EAAE;QACR,gBAAgB;QAChB,UAAU;QACV,YAAY;QACZ,eAAe;QACf,kBAAkB;KACnB;CACF,CAAC"}

package/dist/parse-failure.d.ts

@@ -0,0 +1,59 @@
+/**
+ * @file Parse Failure Tracking
+ * @description Types and utilities for tracking partial match failures
+ *              to provide better error messages (Phase 1.2 of parser recommendations)
+ */
+import type { ParseErrorCode } from '@sharpee/world-model';
+/**
+ * Reason why a pattern match failed
+ */
+export type MatchFailureReason = 'NO_TOKENS' | 'VERB_MISMATCH' | 'LITERAL_MISMATCH' | 'SLOT_FAILED' | 'LEFTOVER_TOKENS' | 'NOT_ENOUGH_TOKENS';
+/**
+ * Detailed slot failure information
+ */
+export interface SlotFailure {
+    /** Slot name (e.g., 'target', 'container') */
+    slotName: string;
+    /** Tokens that were tried for this slot */
+    attemptedText: string;
+    /** Why the slot failed */
+    reason: 'NO_MATCH' | 'SCOPE_VIOLATION' | 'AMBIGUOUS';
+    /** For NO_MATCH: the word(s) that couldn't be resolved */
+    unknownWord?: string;
+    /** For SCOPE_VIOLATION: entities found but out of scope */
+    outOfScopeEntities?: string[];
+    /** For AMBIGUOUS: multiple matches found */
+    candidates?: string[];
+}
+/**
+ * Information about a partial pattern match failure
+ */
+export interface PartialMatchFailure {
+    /** The pattern that was attempted */
+    pattern: string;
+    /** The action this pattern maps to */
+    action: string;
+    /** How far into the pattern we got (0-1, higher = more matched) */
+    progress: number;
+    /** Number of tokens consumed before failure */
+    tokensConsumed: number;
+    /** Why the match failed */
+    reason: MatchFailureReason;
+    /** If verb was recognized, what was it */
+    matchedVerb?: string;
+    /** If a slot failed, details about that failure */
+    slotFailure?: SlotFailure;
+    /** The token that caused the mismatch (if applicable) */
+    failedAtToken?: string;
+    /** What was expected at the failure point */
+    expected?: string;
+}
+/**
+ * Analyze partial match failures to determine the best error to report
+ */
+export declare function analyzeBestFailure(failures: PartialMatchFailure[], input: string, hasVerb: boolean): {
+    code: ParseErrorCode;
+    messageId: string;
+    context: Record<string, any>;
+};
+//# sourceMappingURL=parse-failure.d.ts.map

package/dist/parse-failure.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-failure.d.ts","sourceRoot":"","sources":["../src/parse-failure.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAE3D;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAC1B,WAAW,GACX,eAAe,GACf,kBAAkB,GAClB,aAAa,GACb,iBAAiB,GACjB,mBAAmB,CAAC;AAExB;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,8CAA8C;IAC9C,QAAQ,EAAE,MAAM,CAAC;IAEjB,2CAA2C;IAC3C,aAAa,EAAE,MAAM,CAAC;IAEtB,0BAA0B;IAC1B,MAAM,EAAE,UAAU,GAAG,iBAAiB,GAAG,WAAW,CAAC;IAErD,0DAA0D;IAC1D,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,2DAA2D;IAC3D,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAC;IAE9B,4CAA4C;IAC5C,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,qCAAqC;IACrC,OAAO,EAAE,MAAM,CAAC;IAEhB,sCAAsC;IACtC,MAAM,EAAE,MAAM,CAAC;IAEf,mEAAmE;IACnE,QAAQ,EAAE,MAAM,CAAC;IAEjB,+CAA+C;IAC/C,cAAc,EAAE,MAAM,CAAC;IAEvB,2BAA2B;IAC3B,MAAM,EAAE,kBAAkB,CAAC;IAE3B,0CAA0C;IAC1C,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,mDAAmD;IACnD,WAAW,CAAC,EAAE,WAAW,CAAC;IAE1B,yDAAyD;IACzD,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB,6CAA6C;IAC7C,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,mBAAmB,EAAE,EAC/B,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,OAAO,GACf;IAAE,IAAI,EAAE,cAAc,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;CAAE,CAgI3E"}

package/dist/parse-failure.js

@@ -0,0 +1,132 @@
+"use strict";
+/**
+ * @file Parse Failure Tracking
+ * @description Types and utilities for tracking partial match failures
+ *              to provide better error messages (Phase 1.2 of parser recommendations)
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.analyzeBestFailure = analyzeBestFailure;
+/**
+ * Analyze partial match failures to determine the best error to report
+ */
+function analyzeBestFailure(failures, input, hasVerb) {
+    if (failures.length === 0) {
+        // No patterns even tried
+        if (!input.trim()) {
+            return {
+                code: 'NO_VERB',
+                messageId: 'parser.error.noInput',
+                context: {}
+            };
+        }
+        return {
+            code: 'UNKNOWN_VERB',
+            messageId: 'parser.error.unknownVerb',
+            context: { verb: input.split(/\s+/)[0] }
+        };
+    }
+    // Sort by progress descending - most progress = best failure info
+    const sorted = [...failures].sort((a, b) => b.progress - a.progress);
+    const best = sorted[0];
+    // If best failure has verb matched and slot failure, we have good info
+    if (best.matchedVerb && best.slotFailure) {
+        const sf = best.slotFailure;
+        if (sf.reason === 'NO_MATCH') {
+            return {
+                code: 'ENTITY_NOT_FOUND',
+                messageId: 'parser.error.entityNotFound',
+                context: {
+                    verb: best.matchedVerb,
+                    noun: sf.unknownWord || sf.attemptedText,
+                    slot: sf.slotName
+                }
+            };
+        }
+        if (sf.reason === 'SCOPE_VIOLATION') {
+            return {
+                code: 'SCOPE_VIOLATION',
+                messageId: 'parser.error.scopeViolation',
+                context: {
+                    verb: best.matchedVerb,
+                    noun: sf.attemptedText,
+                    slot: sf.slotName
+                }
+            };
+        }
+        if (sf.reason === 'AMBIGUOUS') {
+            return {
+                code: 'AMBIGUOUS_INPUT',
+                messageId: 'parser.error.ambiguous',
+                context: {
+                    verb: best.matchedVerb,
+                    noun: sf.attemptedText,
+                    candidates: sf.candidates
+                }
+            };
+        }
+    }
+    // If verb matched but we ran out of tokens (missing object)
+    if (best.matchedVerb && best.reason === 'NOT_ENOUGH_TOKENS') {
+        // Check if it was looking for a slot
+        if (best.expected?.startsWith(':')) {
+            const slotName = best.expected.slice(1);
+            // Determine if it's direct or indirect object
+            if (slotName === 'target' || slotName === 'item' || slotName === 'object') {
+                return {
+                    code: 'MISSING_OBJECT',
+                    messageId: 'parser.error.missingObject',
+                    context: { verb: best.matchedVerb }
+                };
+            }
+            else {
+                return {
+                    code: 'MISSING_INDIRECT',
+                    messageId: 'parser.error.missingIndirect',
+                    context: {
+                        verb: best.matchedVerb,
+                        slot: slotName
+                    }
+                };
+            }
+        }
+        return {
+            code: 'MISSING_OBJECT',
+            messageId: 'parser.error.missingObject',
+            context: { verb: best.matchedVerb }
+        };
+    }
+    // Verb matched but slot failed without details (generic slot failure)
+    if (best.matchedVerb && best.reason === 'SLOT_FAILED') {
+        return {
+            code: 'MISSING_OBJECT',
+            messageId: 'parser.error.missingObject',
+            context: { verb: best.matchedVerb }
+        };
+    }
+    // If first token matched verb patterns but all failed
+    if (best.matchedVerb && best.reason === 'LEFTOVER_TOKENS') {
+        return {
+            code: 'INVALID_SYNTAX',
+            messageId: 'parser.error.invalidSyntax',
+            context: {
+                verb: best.matchedVerb,
+                extraWords: best.failedAtToken
+            }
+        };
+    }
+    // No verb matched at all - unknown verb
+    if (!hasVerb) {
+        return {
+            code: 'UNKNOWN_VERB',
+            messageId: 'parser.error.unknownVerb',
+            context: { verb: input.split(/\s+/)[0] }
+        };
+    }
+    // Fallback
+    return {
+        code: 'INVALID_SYNTAX',
+        messageId: 'parser.error.invalidSyntax',
+        context: {}
+    };
+}
+//# sourceMappingURL=parse-failure.js.map

package/dist/parse-failure.js.map

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

package/dist/parser-types.d.ts

@@ -0,0 +1,185 @@
+/**
+ * Parser-specific types
+ * These were previously in @sharpee/if-domain but are now local to the parser
+ */
+import type { IParsedCommand, IParseError as CoreParseError } from '@sharpee/world-model';
+/**
+ * Parser interface
+ */
+export interface Parser {
+    parse(input: string): CommandResult<IParsedCommand, CoreParseError>;
+    setDebugCallback?(callback: ((event: any) => void) | undefined): void;
+}
+/**
+ * Parser options
+ */
+export interface ParserOptions {
+    allowPartial?: boolean;
+    expandAbbreviations?: boolean;
+    ignoreArticles?: boolean;
+    minConfidence?: number;
+}
+/**
+ * Internal token representation
+ */
+export interface Token {
+    word: string;
+    normalized: string;
+    position: number;
+    candidates: TokenCandidate[];
+}
+/**
+ * Token candidate
+ */
+export interface TokenCandidate {
+    partOfSpeech: PartOfSpeech;
+    mapsTo: string;
+    priority?: number;
+    source?: string;
+    metadata?: Record<string, any>;
+}
+/**
+ * Command result wrapper
+ */
+export type CommandResult<T, E> = {
+    success: true;
+    value: T;
+} | {
+    success: false;
+    error: E;
+};
+/**
+ * Candidate command (legacy format)
+ */
+export interface CandidateCommand {
+    action: string;
+    originalInput: string;
+    tokens: Token[];
+    pattern: string;
+    confidence: number;
+    nounText?: string;
+    nounCandidates?: string[];
+    preposition?: string;
+    secondNounText?: string;
+    secondNounCandidates?: string[];
+}
+/**
+ * Internal parse result (legacy format)
+ */
+export interface InternalParseResult {
+    candidates: CandidateCommand[];
+    errors: ParseError[];
+    partial: boolean;
+}
+/**
+ * Parse error types
+ */
+export declare enum ParseErrorType {
+    UNKNOWN_WORD = "UNKNOWN_WORD",
+    PATTERN_MISMATCH = "PATTERN_MISMATCH",
+    AMBIGUOUS = "AMBIGUOUS",
+    NO_COMMAND = "NO_COMMAND"
+}
+/**
+ * Parse error
+ */
+export interface ParseError {
+    type: ParseErrorType;
+    message: string;
+    words?: string[];
+    position?: number;
+}
+/**
+ * Vocabulary part of speech
+ */
+export declare enum PartOfSpeech {
+    VERB = "VERB",
+    NOUN = "NOUN",
+    ADJECTIVE = "ADJECTIVE",
+    ARTICLE = "ARTICLE",
+    PREPOSITION = "PREPOSITION",
+    PRONOUN = "PRONOUN",
+    DIRECTION = "DIRECTION",
+    SPECIAL = "SPECIAL"
+}
+/**
+ * Grammar patterns
+ */
+export interface GrammarPatterns {
+    patterns: Array<{
+        name: string;
+        pattern: string;
+        action?: string;
+    }>;
+}
+/**
+ * Language provider interface
+ */
+export interface LanguageProvider {
+    getVerbs?(): Array<{
+        actionId: string;
+        verbs: string[];
+    }>;
+    getDirections?(): Array<{
+        directionId: string;
+        words: string[];
+    }>;
+    getSpecialWords?(): Record<string, string[]>;
+}
+/**
+ * Vocabulary entry
+ */
+export interface VocabularyEntry {
+    word: string;
+    partOfSpeech: PartOfSpeech;
+    mapsTo: string;
+    priority?: number;
+    source?: string;
+    metadata?: Record<string, any>;
+}
+/**
+ * Simple vocabulary registry
+ */
+export declare class VocabularyRegistry {
+    private entries;
+    clear(): void;
+    register(entry: VocabularyEntry): void;
+    registerVerbs(verbs: Array<{
+        word: string;
+        mapsTo: string;
+        priority?: number;
+    }>): void;
+    registerDirections(directions: Array<{
+        word: string;
+        mapsTo: string;
+    }>): void;
+    registerSpecial(special: Array<{
+        word: string;
+        type: string;
+    }>): void;
+    lookup(word: string): VocabularyEntry[];
+}
+export declare const vocabularyRegistry: VocabularyRegistry;
+/**
+ * Adapt verb vocabulary from language provider format
+ */
+export declare function adaptVerbVocabulary(language: LanguageProvider): Array<{
+    word: string;
+    mapsTo: string;
+    priority?: number;
+}>;
+/**
+ * Adapt direction vocabulary from language provider format
+ */
+export declare function adaptDirectionVocabulary(language: LanguageProvider): Array<{
+    word: string;
+    mapsTo: string;
+}>;
+/**
+ * Adapt special vocabulary from language provider format
+ */
+export declare function adaptSpecialVocabulary(language: LanguageProvider): Array<{
+    word: string;
+    type: string;
+}>;
+//# sourceMappingURL=parser-types.d.ts.map

package/dist/parser-types.d.ts.map

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

package/dist/parser-types.js

@@ -0,0 +1,134 @@
+"use strict";
+/**
+ * Parser-specific types
+ * These were previously in @sharpee/if-domain but are now local to the parser
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.vocabularyRegistry = exports.VocabularyRegistry = exports.PartOfSpeech = exports.ParseErrorType = void 0;
+exports.adaptVerbVocabulary = adaptVerbVocabulary;
+exports.adaptDirectionVocabulary = adaptDirectionVocabulary;
+exports.adaptSpecialVocabulary = adaptSpecialVocabulary;
+/**
+ * Parse error types
+ */
+var ParseErrorType;
+(function (ParseErrorType) {
+    ParseErrorType["UNKNOWN_WORD"] = "UNKNOWN_WORD";
+    ParseErrorType["PATTERN_MISMATCH"] = "PATTERN_MISMATCH";
+    ParseErrorType["AMBIGUOUS"] = "AMBIGUOUS";
+    ParseErrorType["NO_COMMAND"] = "NO_COMMAND";
+})(ParseErrorType || (exports.ParseErrorType = ParseErrorType = {}));
+/**
+ * Vocabulary part of speech
+ */
+var PartOfSpeech;
+(function (PartOfSpeech) {
+    PartOfSpeech["VERB"] = "VERB";
+    PartOfSpeech["NOUN"] = "NOUN";
+    PartOfSpeech["ADJECTIVE"] = "ADJECTIVE";
+    PartOfSpeech["ARTICLE"] = "ARTICLE";
+    PartOfSpeech["PREPOSITION"] = "PREPOSITION";
+    PartOfSpeech["PRONOUN"] = "PRONOUN";
+    PartOfSpeech["DIRECTION"] = "DIRECTION";
+    PartOfSpeech["SPECIAL"] = "SPECIAL";
+})(PartOfSpeech || (exports.PartOfSpeech = PartOfSpeech = {}));
+/**
+ * Simple vocabulary registry
+ */
+class VocabularyRegistry {
+    entries = new Map();
+    clear() {
+        this.entries.clear();
+    }
+    register(entry) {
+        const word = entry.word.toLowerCase();
+        if (!this.entries.has(word)) {
+            this.entries.set(word, []);
+        }
+        this.entries.get(word).push(entry);
+    }
+    registerVerbs(verbs) {
+        for (const verb of verbs) {
+            this.register({
+                word: verb.word,
+                partOfSpeech: PartOfSpeech.VERB,
+                mapsTo: verb.mapsTo,
+                priority: verb.priority
+            });
+        }
+    }
+    registerDirections(directions) {
+        for (const dir of directions) {
+            this.register({
+                word: dir.word,
+                partOfSpeech: PartOfSpeech.DIRECTION,
+                mapsTo: dir.mapsTo
+            });
+        }
+    }
+    registerSpecial(special) {
+        for (const spec of special) {
+            this.register({
+                word: spec.word,
+                partOfSpeech: PartOfSpeech.SPECIAL,
+                mapsTo: spec.type
+            });
+        }
+    }
+    lookup(word) {
+        return this.entries.get(word.toLowerCase()) || [];
+    }
+}
+exports.VocabularyRegistry = VocabularyRegistry;
+exports.vocabularyRegistry = new VocabularyRegistry();
+/**
+ * Adapt verb vocabulary from language provider format
+ */
+function adaptVerbVocabulary(language) {
+    const verbs = [];
+    if (language.getVerbs) {
+        for (const verbDef of language.getVerbs()) {
+            for (const verb of verbDef.verbs) {
+                verbs.push({
+                    word: verb,
+                    mapsTo: verbDef.actionId,
+                    priority: 1.0
+                });
+            }
+        }
+    }
+    return verbs;
+}
+/**
+ * Adapt direction vocabulary from language provider format
+ */
+function adaptDirectionVocabulary(language) {
+    const directions = [];
+    if (language.getDirections) {
+        for (const dirDef of language.getDirections()) {
+            for (const word of dirDef.words) {
+                directions.push({
+                    word,
+                    mapsTo: dirDef.directionId
+                });
+            }
+        }
+    }
+    return directions;
+}
+/**
+ * Adapt special vocabulary from language provider format
+ */
+function adaptSpecialVocabulary(language) {
+    const special = [];
+    if (language.getSpecialWords) {
+        const specialWords = language.getSpecialWords();
+        for (const [type, words] of Object.entries(specialWords)) {
+            for (const word of words) {
+                special.push({ word, type });
+            }
+        }
+    }
+    return special;
+}
+//# sourceMappingURL=parser-types.js.map

package/dist/parser-types.js.map

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