@terkoizmy/intent-sdk 1.0.0

package/dist/parser/extractors/amount.js

@@ -0,0 +1,113 @@
+/**
+ * Amount Extractor
+ * Extracts numerical amounts from text
+ */
+export class AmountExtractor {
+    patterns;
+    constructor() {
+        this.patterns = this.initializePatterns();
+    }
+    /**
+     * Extract all amount entities from text
+     *
+     * INPUT: Text string
+     * OUTPUT: Array of AmountEntity
+     *
+     * EXAMPLES:
+     * "1000 USDC" -> [{ value: 1000, rawText: "1000", unit: "USDC" }]
+     * "10k ETH" -> [{ value: 10000, rawText: "10k", unit: "ETH" }]
+     * "0.5 BTC" -> [{ value: 0.5, rawText: "0.5", unit: "BTC" }]
+     *
+     * TODO:
+     * 1. Match patterns for amounts
+     * 2. Parse numeric value (handle k, m suffixes)
+     * 3. Extract optional unit (token symbol)
+     * 4. Return array of AmountEntity
+     */
+    extract(text) {
+        const rawEntities = [];
+        // Collect all potential matches
+        for (const pattern of this.patterns) {
+            // Reset lastIndex for global regex
+            pattern.lastIndex = 0;
+            let match;
+            while ((match = pattern.exec(text)) !== null) {
+                const rawText = match[0];
+                const groups = match.groups || {};
+                const numericPart = groups.value;
+                const suffix = groups.suffix || "";
+                const unit = groups.unit || undefined;
+                if (!numericPart)
+                    continue;
+                rawEntities.push({
+                    value: this.parseNumericValue(numericPart, suffix),
+                    rawText,
+                    unit,
+                    position: [match.index, match.index + rawText.length],
+                });
+            }
+        }
+        // Sort by length (descending) to prefer longer matches (e.g. "1000 USDC" over "1000")
+        // If lengths are equal, prefer earlier position
+        rawEntities.sort((a, b) => {
+            const lenDiff = (b.position[1] - b.position[0]) - (a.position[1] - a.position[0]);
+            if (lenDiff !== 0)
+                return lenDiff;
+            return a.position[0] - b.position[0];
+        });
+        // Filter overlaps
+        const entities = [];
+        const occupiedmask = new Array(text.length).fill(false);
+        for (const entity of rawEntities) {
+            const [start, end] = entity.position;
+            // Check for overlap
+            let isOverlap = false;
+            for (let i = start; i < end; i++) {
+                if (occupiedmask[i]) {
+                    isOverlap = true;
+                    break;
+                }
+            }
+            if (!isOverlap) {
+                entities.push(entity);
+                // Mark positions as occupied
+                for (let i = start; i < end; i++) {
+                    occupiedmask[i] = true;
+                }
+            }
+        }
+        // Sort valid entities by position
+        return entities.sort((a, b) => a.position[0] - b.position[0]);
+    }
+    /**
+     * Parse numeric value with k/m suffixes
+     *
+     * INPUT: Value string and suffix string
+     * OUTPUT: Numeric value
+     */
+    parseNumericValue(value, suffix) {
+        const num = parseFloat(value);
+        const lowerSuffix = suffix.toLowerCase();
+        if (lowerSuffix === "k") {
+            return num * 1000;
+        }
+        else if (lowerSuffix === "m") {
+            return num * 1000000;
+        }
+        return num;
+    }
+    /**
+     * Initialize regex patterns for amount matching
+     */
+    initializePatterns() {
+        return [
+            // Match: "1000 USDC", "10k ETH", "0.5 BTC", "1.5m DAI"
+            /(?<value>\d+(?:\.\d+)?)\s*(?<suffix>[km]?)\s*(?<unit>[A-Z]{2,10})/g,
+            // Match: "10k", "1.5m" (without unit)
+            /(?<value>\d+(?:\.\d+)?)\s*(?<suffix>[km])/gi,
+            // Match: plain numbers "1000", "0.5"
+            /\b(?<value>\d+(?:\.\d+)?)\b/g,
+        ];
+    }
+}
+//# sourceMappingURL=amount.js.map

package/dist/parser/extractors/amount.js.map

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

package/dist/parser/extractors/constraints.d.ts

@@ -0,0 +1,37 @@
+import type { ConstraintEntity } from "../../types";
+/**
+ * Constraint Extractor
+ * Extracts constraints like slippage, deadline, gas limits
+ */
+export declare class ConstraintExtractor {
+    /**
+     * Extract constraint entities from text
+     *
+     * INPUT: Text string
+     * OUTPUT: Array of ConstraintEntity
+     *
+     * EXAMPLES:
+     * "max 1% slippage" -> [{ type: "slippage", value: 100, rawText: "max 1% slippage" }]
+     * "within 1 hour" -> [{ type: "deadline", value: 3600, rawText: "within 1 hour" }]
+     *
+     * EXTRACTS:
+     * 1. Slippage constraints (%, basis points)
+     * 2. Deadline constraints (time expressions)
+     * 3. Gas constraints
+     * 4. Price constraints
+     */
+    extract(text: string): ConstraintEntity[];
+    /**
+     * Parse time expression to seconds
+     *
+     * INPUT: Time string like "1 hour", "30 minutes", "1 day"
+     * OUTPUT: Seconds
+     *
+     * EXAMPLES:
+     * "1 hour" -> 3600
+     * "30 minutes" -> 1800
+     * "1 day" -> 86400
+     */
+    private parseTimeExpression;
+}
+//# sourceMappingURL=constraints.d.ts.map

package/dist/parser/extractors/constraints.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constraints.d.ts","sourceRoot":"","sources":["../../../src/parser/extractors/constraints.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAEpD;;;GAGG;AACH,qBAAa,mBAAmB;IAC9B;;;;;;;;;;;;;;;OAeG;IACH,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB,EAAE;IA4EzC;;;;;;;;;;OAUG;IACH,OAAO,CAAC,mBAAmB;CAwB5B"}

package/dist/parser/extractors/constraints.js

@@ -0,0 +1,119 @@
+/**
+ * Constraint Extractor
+ * Extracts constraints like slippage, deadline, gas limits
+ */
+export class ConstraintExtractor {
+    /**
+     * Extract constraint entities from text
+     *
+     * INPUT: Text string
+     * OUTPUT: Array of ConstraintEntity
+     *
+     * EXAMPLES:
+     * "max 1% slippage" -> [{ type: "slippage", value: 100, rawText: "max 1% slippage" }]
+     * "within 1 hour" -> [{ type: "deadline", value: 3600, rawText: "within 1 hour" }]
+     *
+     * EXTRACTS:
+     * 1. Slippage constraints (%, basis points)
+     * 2. Deadline constraints (time expressions)
+     * 3. Gas constraints
+     * 4. Price constraints
+     */
+    extract(text) {
+        const entities = [];
+        // Extract slippage
+        const slippageMatch = text.match(/(?:max|maximum)?\s*(\d+(?:\.\d+)?)\s*%?\s*slippage/i);
+        if (slippageMatch) {
+            const percentage = parseFloat(slippageMatch[1]);
+            entities.push({
+                type: "slippage",
+                value: percentage * 100, // Convert to basis points
+                rawText: slippageMatch[0],
+                position: [
+                    slippageMatch.index,
+                    slippageMatch.index + slippageMatch[0].length,
+                ],
+            });
+        }
+        // Extract deadline
+        const deadlineMatch = text.match(/(?:within|in)\s+(\d+)\s*(hour|hr|minute|min|day|second|sec)s?/i);
+        if (deadlineMatch) {
+            const seconds = this.parseTimeExpression(deadlineMatch[0]);
+            entities.push({
+                type: "deadline",
+                value: seconds,
+                rawText: deadlineMatch[0],
+                position: [
+                    deadlineMatch.index,
+                    deadlineMatch.index + deadlineMatch[0].length,
+                ],
+            });
+        }
+        // Extract gas limit (requires 'gas' keyword nearby)
+        const gasMatch = text.match(/(?:gas\s*(?:limit|cost|fee|under|max)|(?:max|under)\s*(?:\d+(?:\.\d+)?)\s*(?:ETH|gwei)\s*gas)\s*(\d+(?:\.\d+)?)\s*(ETH|gwei)/i)
+            || text.match(/gas\s*(?:limit|cost|fee)?\s*(?:under|max|of)?\s*(\d+(?:\.\d+)?)\s*(ETH|gwei)/i);
+        if (gasMatch) {
+            let value = parseFloat(gasMatch[1]);
+            const unit = gasMatch[2].toLowerCase();
+            // Convert gwei to ETH
+            if (unit === 'gwei') {
+                value = value * 1e-9;
+            }
+            entities.push({
+                type: "gas",
+                value: value,
+                rawText: gasMatch[0],
+                position: [
+                    gasMatch.index,
+                    gasMatch.index + gasMatch[0].length,
+                ],
+            });
+        }
+        // Extract price constraints (excludes time words like 'minutes', 'hours')
+        const priceMatch = text.match(/(?:max\s*price|under|below|no\s*more\s*than)\s*(\d+(?:\.\d+)?)\s*(?!(?:second|sec|minute|min|hour|hr|day)s?\b)([A-Z]{2,10})/i);
+        if (priceMatch) {
+            const value = parseFloat(priceMatch[1]);
+            entities.push({
+                type: "price",
+                value: value,
+                rawText: priceMatch[0],
+                position: [
+                    priceMatch.index,
+                    priceMatch.index + priceMatch[0].length,
+                ],
+            });
+        }
+        return entities;
+    }
+    /**
+     * Parse time expression to seconds
+     *
+     * INPUT: Time string like "1 hour", "30 minutes", "1 day"
+     * OUTPUT: Seconds
+     *
+     * EXAMPLES:
+     * "1 hour" -> 3600
+     * "30 minutes" -> 1800
+     * "1 day" -> 86400
+     */
+    parseTimeExpression(timeStr) {
+        const secondMatch = timeStr.match(/(\d+)\s*(?:second|sec)/i);
+        if (secondMatch) {
+            return parseInt(secondMatch[1]);
+        }
+        const minuteMatch = timeStr.match(/(\d+)\s*(?:minute|min)/i);
+        if (minuteMatch) {
+            return parseInt(minuteMatch[1]) * 60;
+        }
+        const hourMatch = timeStr.match(/(\d+)\s*(?:hour|hr)/i);
+        if (hourMatch) {
+            return parseInt(hourMatch[1]) * 3600;
+        }
+        const dayMatch = timeStr.match(/(\d+)\s*day/i);
+        if (dayMatch) {
+            return parseInt(dayMatch[1]) * 86400;
+        }
+        return 3600; // Default 1 hour
+    }
+}
+//# sourceMappingURL=constraints.js.map

package/dist/parser/extractors/constraints.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constraints.js","sourceRoot":"","sources":["../../../src/parser/extractors/constraints.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,OAAO,mBAAmB;IAC9B;;;;;;;;;;;;;;;OAeG;IACH,OAAO,CAAC,IAAY;QAClB,MAAM,QAAQ,GAAuB,EAAE,CAAC;QAExC,mBAAmB;QACnB,MAAM,aAAa,GAAG,IAAI,CAAC,KAAK,CAC9B,qDAAqD,CACtD,CAAC;QACF,IAAI,aAAa,EAAE,CAAC;YAClB,MAAM,UAAU,GAAG,UAAU,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC;YAChD,QAAQ,CAAC,IAAI,CAAC;gBACZ,IAAI,EAAE,UAAU;gBAChB,KAAK,EAAE,UAAU,GAAG,GAAG,EAAE,0BAA0B;gBACnD,OAAO,EAAE,aAAa,CAAC,CAAC,CAAC;gBACzB,QAAQ,EAAE;oBACR,aAAa,CAAC,KAAM;oBACpB,aAAa,CAAC,KAAM,GAAG,aAAa,CAAC,CAAC,CAAC,CAAC,MAAM;iBAC/C;aACF,CAAC,CAAC;QACL,CAAC;QAED,mBAAmB;QACnB,MAAM,aAAa,GAAG,IAAI,CAAC,KAAK,CAAC,gEAAgE,CAAC,CAAC;QACnG,IAAI,aAAa,EAAE,CAAC;YAClB,MAAM,OAAO,GAAG,IAAI,CAAC,mBAAmB,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC;YAC3D,QAAQ,CAAC,IAAI,CAAC;gBACZ,IAAI,EAAE,UAAU;gBAChB,KAAK,EAAE,OAAO;gBACd,OAAO,EAAE,aAAa,CAAC,CAAC,CAAC;gBACzB,QAAQ,EAAE;oBACR,aAAa,CAAC,KAAM;oBACpB,aAAa,CAAC,KAAM,GAAG,aAAa,CAAC,CAAC,CAAC,CAAC,MAAM;iBAC/C;aACF,CAAC,CAAC;QACL,CAAC;QAED,oDAAoD;QACpD,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,+HAA+H,CAAC;eACvJ,IAAI,CAAC,KAAK,CAAC,+EAA+E,CAAC,CAAC;QACjG,IAAI,QAAQ,EAAE,CAAC;YACb,IAAI,KAAK,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;YACpC,MAAM,IAAI,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;YAEvC,sBAAsB;YACtB,IAAI,IAAI,KAAK,MAAM,EAAE,CAAC;gBACpB,KAAK,GAAG,KAAK,GAAG,IAAI,CAAC;YACvB,CAAC;YAED,QAAQ,CAAC,IAAI,CAAC;gBACZ,IAAI,EAAE,KAAK;gBACX,KAAK,EAAE,KAAK;gBACZ,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC;gBACpB,QAAQ,EAAE;oBACR,QAAQ,CAAC,KAAM;oBACf,QAAQ,CAAC,KAAM,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC,MAAM;iBACrC;aACF,CAAC,CAAC;QACL,CAAC;QAED,0EAA0E;QAC1E,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,8HAA8H,CAAC,CAAC;QAC9J,IAAI,UAAU,EAAE,CAAC;YACf,MAAM,KAAK,GAAG,UAAU,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;YACxC,QAAQ,CAAC,IAAI,CAAC;gBACZ,IAAI,EAAE,OAAO;gBACb,KAAK,EAAE,KAAK;gBACZ,OAAO,EAAE,UAAU,CAAC,CAAC,CAAC;gBACtB,QAAQ,EAAE;oBACR,UAAU,CAAC,KAAM;oBACjB,UAAU,CAAC,KAAM,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC,MAAM;iBACzC;aACF,CAAC,CAAC;QACL,CAAC;QAED,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED;;;;;;;;;;OAUG;IACK,mBAAmB,CAAC,OAAe;QAEzC,MAAM,WAAW,GAAG,OAAO,CAAC,KAAK,CAAC,yBAAyB,CAAC,CAAC;QAC7D,IAAI,WAAW,EAAE,CAAC;YAChB,OAAO,QAAQ,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC;QAClC,CAAC;QAED,MAAM,WAAW,GAAG,OAAO,CAAC,KAAK,CAAC,yBAAyB,CAAC,CAAC;QAC7D,IAAI,WAAW,EAAE,CAAC;YAChB,OAAO,QAAQ,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC;QACvC,CAAC;QAED,MAAM,SAAS,GAAG,OAAO,CAAC,KAAK,CAAC,sBAAsB,CAAC,CAAC;QACxD,IAAI,SAAS,EAAE,CAAC;YACd,OAAO,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;QACvC,CAAC;QAED,MAAM,QAAQ,GAAG,OAAO,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC;QAC/C,IAAI,QAAQ,EAAE,CAAC;YACb,OAAO,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC;QACvC,CAAC;QAED,OAAO,IAAI,CAAC,CAAC,iBAAiB;IAChC,CAAC;CACF"}

package/dist/parser/extractors/index.d.ts

@@ -0,0 +1,5 @@
+export { AmountExtractor } from "./amount";
+export { TokenExtractor } from "./token";
+export { ActionExtractor } from "./action";
+export { ConstraintExtractor } from "./constraints";
+//# sourceMappingURL=index.d.ts.map

package/dist/parser/extractors/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/parser/extractors/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAC3C,OAAO,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AACzC,OAAO,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAC3C,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC"}

package/dist/parser/extractors/index.js

@@ -0,0 +1,5 @@
+export { AmountExtractor } from "./amount";
+export { TokenExtractor } from "./token";
+export { ActionExtractor } from "./action";
+export { ConstraintExtractor } from "./constraints";
+//# sourceMappingURL=index.js.map

package/dist/parser/extractors/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/parser/extractors/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAC3C,OAAO,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AACzC,OAAO,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAC3C,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC"}

package/dist/parser/extractors/token.d.ts

@@ -0,0 +1,24 @@
+import type { TokenEntity } from "../../types";
+interface NftCollection {
+    name: string;
+    aliases: string[];
+}
+/**
+ * Token Extractor
+ * Extracts token symbols and NFT collections from text
+ */
+export declare class TokenExtractor {
+    private knownTokens;
+    private knownCollections;
+    constructor(knownTokens?: Record<string, string>, knownCollections?: NftCollection[]);
+    /**
+     * Extract token entities from text
+     *
+     * INPUT: Text string
+     * OUTPUT: Array of TokenEntity
+     */
+    extract(text: string): TokenEntity[];
+    private escapeRegExp;
+}
+export {};
+//# sourceMappingURL=token.d.ts.map

package/dist/parser/extractors/token.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"token.d.ts","sourceRoot":"","sources":["../../../src/parser/extractors/token.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE/C,UAAU,aAAa;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AA8BD;;;GAGG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,WAAW,CAAyB;IAC5C,OAAO,CAAC,gBAAgB,CAAkB;gBAGxC,WAAW,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM,EACxC,gBAAgB,CAAC,EAAE,aAAa,EAAE;IAiBpC;;;;;OAKG;IACH,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,EAAE;IAmFpC,OAAO,CAAC,YAAY;CAGrB"}

package/dist/parser/extractors/token.js

@@ -0,0 +1,124 @@
+// Static set of common English words to filter false positives
+const COMMON_WORDS = new Set([
+    "TO",
+    "FROM",
+    "WITH",
+    "AND",
+    "OR",
+    "THE",
+    "FOR",
+    "OF",
+    "IN",
+    "ON",
+    "AT",
+    // Action words that should not be treated as token symbols
+    "SWAP",
+    "BUY",
+    "SELL",
+    "SEND",
+    "BRIDGE",
+    "CLAIM",
+    "STAKE",
+    "YIELD",
+    "MAX",
+    "MIN",
+    // Domain-specific words that are not token symbols
+    "NFT",
+]);
+/**
+ * Token Extractor
+ * Extracts token symbols and NFT collections from text
+ */
+export class TokenExtractor {
+    knownTokens;
+    knownCollections;
+    constructor(knownTokens = {}, knownCollections) {
+        this.knownTokens = { ...knownTokens };
+        // Default NFT collections — can be overridden via constructor
+        this.knownCollections = knownCollections ?? [
+            { name: "Bored Ape Yacht Club", aliases: ["BAYC", "Bored Ape"] },
+            { name: "Mutant Ape Yacht Club", aliases: ["MAYC", "Mutant Ape"] },
+            { name: "CryptoPunks", aliases: ["Punks", "CryptoPunks"] },
+            { name: "Azuki", aliases: ["Azuki"] },
+            { name: "Doodles", aliases: ["Doodles"] },
+            { name: "Clone X", aliases: ["CloneX", "Clone X"] },
+            { name: "Moonbirds", aliases: ["Moonbirds"] },
+            { name: "Pudgy Penguins", aliases: ["Pudgy Penguins", "Pudgy"] },
+        ];
+    }
+    /**
+     * Extract token entities from text
+     *
+     * INPUT: Text string
+     * OUTPUT: Array of TokenEntity
+     */
+    extract(text) {
+        const entities = [];
+        const matchedRanges = [];
+        // 1. Match NFT collections first (longer specific names take priority)
+        const potentialMatches = [];
+        const uniqueKeys = new Set();
+        for (const collection of this.knownCollections) {
+            for (const alias of [collection.name, ...collection.aliases]) {
+                const pattern = new RegExp(`\\b${this.escapeRegExp(alias)}\\b`, "ig");
+                let collectionMatch;
+                while ((collectionMatch = pattern.exec(text)) !== null) {
+                    const start = collectionMatch.index;
+                    const end = start + collectionMatch[0].length;
+                    const key = `${start}-${end}`;
+                    if (uniqueKeys.has(key))
+                        continue;
+                    uniqueKeys.add(key);
+                    potentialMatches.push({
+                        symbol: collection.name,
+                        rawText: collectionMatch[0],
+                        type: "collection",
+                        position: [start, end],
+                    });
+                }
+            }
+        }
+        // Filter out matches that are contained within other (longer) matches
+        for (const match of potentialMatches) {
+            const isContained = potentialMatches.some((other) => other !== match &&
+                other.position[0] <= match.position[0] &&
+                other.position[1] >= match.position[1] &&
+                other.position[1] - other.position[0] >
+                    match.position[1] - match.position[0]);
+            if (!isContained) {
+                entities.push(match);
+                matchedRanges.push(match.position);
+            }
+        }
+        // 2. Match fungible token symbols
+        const symbolPattern = /\b([A-Z]{2,10})\b/g;
+        let match;
+        while ((match = symbolPattern.exec(text)) !== null) {
+            const symbol = match[1];
+            const start = match.index;
+            const end = start + match[0].length;
+            // Skip common English words and action keywords
+            if (COMMON_WORDS.has(symbol))
+                continue;
+            // Skip if overlaps with already matched NFT
+            const isOverlapping = matchedRanges.some(([rStart, rEnd]) => (start >= rStart && start < rEnd) || (end > rStart && end <= rEnd));
+            if (isOverlapping)
+                continue;
+            entities.push({
+                symbol,
+                rawText: match[0],
+                type: "fungible",
+                address: this.knownTokens[symbol],
+                position: [start, end],
+            });
+            matchedRanges.push([start, end]);
+        }
+        // 3. Fuzzy matching (Optional/Future implementation)
+        // TODO: Implement fuzzy matching for token symbols
+        return entities;
+    }
+    escapeRegExp(string) {
+        return string.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+    }
+}
+//# sourceMappingURL=token.js.map

package/dist/parser/extractors/token.js.map

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

package/dist/parser/index.d.ts

@@ -0,0 +1,125 @@
+import type { ParserConfig, ParseResult } from "../types";
+/**
+ * Main Intent Parser Class
+ *
+ * Example usage:
+ * ```typescript
+ * const parser = new IntentParser();
+ * const result = parser.parse("Swap 1000 USDC to ETH with max 1% slippage");
+ * ```
+ */
+export declare class IntentParser {
+    private classifier;
+    private amountExtractor;
+    private tokenExtractor;
+    private actionExtractor;
+    private constraintExtractor;
+    private templates;
+    private config;
+    private tokenResolver;
+    constructor(config?: ParserConfig);
+    /**
+     * Parse natural language text into structured intent
+     *
+     * INPUT: Natural language string
+     * OUTPUT: ParseResult with StructuredIntent or error
+     *
+     * TODO:
+     * 1. Normalize input text
+     * 2. Classify intent type
+     * 3. Extract entities (amounts, tokens, actions, constraints)
+     * 4. Map entities to appropriate template
+     * 5. Validate result
+     * 6. Return structured intent
+     */
+    parse(text: string): ParseResult;
+    /**
+     * Build structured intent from extracted entities and template
+     *
+     * INPUT:
+     * - intentType: Classified intent type
+     * - entities: All extracted entities
+     * - template: Intent template
+     * - originalText: Original user input
+     *
+     * OUTPUT: StructuredIntent
+     *
+     * TODO:
+     * 1. Map entities to parameters based on template
+     * 2. Fill in default values for missing fields
+     * 3. Build constraints
+     * 4. Calculate confidence score
+     * 5. Add metadata
+     */
+    private buildIntent;
+    /**
+     * Async parse — sama seperti parse() tapi dengan token address resolution
+     *
+     * INPUT: Natural language string
+     * OUTPUT: Promise<ParseResult> (dengan inputTokenAddress/outputTokenAddress terisi)
+     *
+     * KAPAN PAKAI:
+     *   - Gunakan parseAsync() jika tokenResolver.enabled = true
+     *   - Gunakan parse() jika tidak butuh token address (tetap sync, backward compatible)
+     *
+     * BREAKING CHANGE MITIGATION:
+     *   - parse() TETAP sync → tidak ada breaking change
+     *   - parseAsync() BARU → consumer opt-in ke async behavior
+     *
+     * TODO [Phase 3]: Implement parseAsync
+     *
+     * FLOW:
+     *   1. Jalankan semua langkah sama seperti parse()
+     *   2. Setelah buildIntent, call resolveTokenAddresses()
+     *   3. Recalculate confidence (bonus jika address ditemukan)
+     *   4. Return ParseResult
+     *
+     * CONTOH:
+     *   const result = await parser.parseAsync("swap 10 USDC to ETH");
+     *   result.data?.parameters.inputTokenAddress // "0xA0b8..."
+     */
+    parseAsync(text: string): Promise<ParseResult>;
+    /**
+     * Resolve token addresses in a StructuredIntent
+     *
+     * INPUT: StructuredIntent (akan di-mutate — address fields diisi)
+     * OUTPUT: void (mutates intent.parameters in-place)
+     *
+     * LOGIC:
+     *   1. Determine chain dari intent.parameters.sourceChain atau "ethereum"
+     *   2. Resolve inputToken jika ada
+     *   3. Resolve outputToken jika ada (gunakan targetChain untuk bridge)
+     *   4. Tambahkan warning ke metadata jika resolve gagal
+     *
+     * CONTOH:
+     *   intent.parameters = { inputToken: "USDC", sourceChain: "Polygon" }
+     *   → setelah resolve: { inputToken: "USDC", inputTokenAddress: "0x3c49...", sourceChain: "Polygon" }
+     *
+     * TODO [Phase 3]: Implement resolveTokenAddresses
+     */
+    private resolveTokenAddresses;
+    /**
+     * Batch parse multiple intents (sync — tanpa token resolution)
+     *
+     * INPUT: Array of natural language strings
+     * OUTPUT: Array of ParseResult
+     */
+    parseBatch(texts: string[]): ParseResult[];
+    /**
+     * Batch parse multiple intents (async — dengan token resolution)
+     *
+     * INPUT: Array of natural language strings
+     * OUTPUT: Promise<ParseResult[]>
+     *
+     * TODO [Phase 3]: Implement async batch parsing
+     *
+     * LOGIC:
+     *   - Gunakan Promise.all() untuk parallel parsing
+     *   - Setiap text di-parse via parseAsync()
+     *   - Return array of results
+     */
+    parseBatchAsync(texts: string[]): Promise<ParseResult[]>;
+}
+export * from "../types";
+export { IntentParser as default };
+//# sourceMappingURL=index.d.ts.map

package/dist/parser/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/parser/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAoB,MAAM,UAAU,CAAC;AAe5E;;;;;;;;GAQG;AACH,qBAAa,YAAY;IACrB,OAAO,CAAC,UAAU,CAAmB;IACrC,OAAO,CAAC,eAAe,CAAkB;IACzC,OAAO,CAAC,cAAc,CAAiB;IACvC,OAAO,CAAC,eAAe,CAAkB;IACzC,OAAO,CAAC,mBAAmB,CAAsB;IACjD,OAAO,CAAC,SAAS,CAAmB;IACpC,OAAO,CAAC,MAAM,CAAyB;IAGvC,OAAO,CAAC,aAAa,CAAuB;gBAEhC,MAAM,GAAE,YAAiB;IA6BrC;;;;;;;;;;;;;OAaG;IACH,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW;IAoDhC;;;;;;;;;;;;;;;;;OAiBG;IACH,OAAO,CAAC,WAAW;IAoDnB;;;;;;;;;;;;;;;;;;;;;;;;;OAyBG;IACG,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAwBpD;;;;;;;;;;;;;;;;;OAiBG;YACW,qBAAqB;IA0CnC;;;;;OAKG;IACH,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,WAAW,EAAE;IAI1C;;;;;;;;;;;;OAYG;IACG,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;CAGjE;AAGD,cAAc,UAAU,CAAC;AACzB,OAAO,EAAE,YAAY,IAAI,OAAO,EAAE,CAAC"}