@terkoizmy/intent-sdk 1.0.0

package/dist/parser/index.js

@@ -0,0 +1,293 @@
+import { IntentClassifier } from "./classifiers/intent-classifier";
+import { AmountExtractor } from "./extractors/amount";
+import { TokenExtractor } from "./extractors/token";
+import { ActionExtractor } from "./extractors/action";
+import { ConstraintExtractor } from "./extractors/constraints";
+import { TemplateRegistry } from "./template/index";
+import { normalizeText } from "./utils/normalize";
+import { mergeEntities, calculateConfidence, } from "./utils/parser-helpers";
+import { validateIntent } from "./validators/schema";
+import { TokenResolver } from "../services/token-resolver";
+/**
+ * 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 class IntentParser {
+    classifier;
+    amountExtractor;
+    tokenExtractor;
+    actionExtractor;
+    constraintExtractor;
+    templates;
+    config;
+    // TODO [Phase 3]: Token resolver instance for resolving symbol → address
+    tokenResolver;
+    constructor(config = {}) {
+        // Initialize with default config
+        this.config = {
+            defaultDeadlineOffset: 3600,
+            knownTokens: {},
+            knownProtocols: [],
+            enableFuzzyMatching: false,
+            enableCache: false,
+            minConfidence: 0.5,
+            tokenResolver: { enabled: false, cacheTTL: 300_000, timeout: 5000, maxCacheSize: 1000 },
+            ...config,
+        };
+        // Initialize components
+        this.classifier = new IntentClassifier();
+        this.amountExtractor = new AmountExtractor();
+        this.tokenExtractor = new TokenExtractor(this.config.knownTokens);
+        this.actionExtractor = new ActionExtractor();
+        this.constraintExtractor = new ConstraintExtractor();
+        this.templates = new TemplateRegistry();
+        // Initialize TokenResolver if config.tokenResolver is provided and enabled
+        if (this.config.tokenResolver?.enabled) {
+            this.tokenResolver = new TokenResolver(this.config.tokenResolver);
+        }
+        else {
+            this.tokenResolver = null;
+        }
+    }
+    /**
+     * 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) {
+        try {
+            // Step 1: Normalize text
+            const normalizedText = normalizeText(text);
+            // Step 2: Classify intent type
+            const intentType = this.classifier.classify(normalizedText);
+            // Step 3: Extract entities
+            const amounts = this.amountExtractor.extract(normalizedText);
+            const tokens = this.tokenExtractor.extract(normalizedText);
+            const actions = this.actionExtractor.extract(normalizedText);
+            const constraints = this.constraintExtractor.extract(normalizedText);
+            // Step 4: Get appropriate template
+            const template = this.templates.get(intentType);
+            if (!template) {
+                return {
+                    success: false,
+                    error: `No template found for intent type: ${intentType}`,
+                };
+            }
+            // Step 5: Build structured intent
+            const structuredIntent = this.buildIntent(intentType, { amounts, tokens, actions, constraints }, template, text);
+            // Step 6: Validate
+            const validation = validateIntent(structuredIntent);
+            if (!validation.success) {
+                return {
+                    success: false,
+                    error: validation.error,
+                };
+            }
+            return {
+                success: true,
+                data: structuredIntent,
+            };
+        }
+        catch (error) {
+            return {
+                success: false,
+                error: error instanceof Error ? error.message : "Unknown error",
+            };
+        }
+    }
+    /**
+     * 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
+     */
+    buildIntent(intentType, entities, template, originalText) {
+        // 1. Merge entities into parameters
+        const extractedParams = mergeEntities(entities, intentType, originalText);
+        // 2. Apply template defaults
+        const parameters = {
+            ...template.defaults,
+            ...extractedParams,
+        };
+        // 3. Build constraints
+        const constraints = {
+            ...template.defaultConstraints,
+            // Template defaults set deadline=0 as placeholder — always compute actual deadline
+            deadline: Date.now() + this.config.defaultDeadlineOffset * 1000,
+        };
+        // Add extracted constraints
+        if (entities.constraints) {
+            entities.constraints.forEach((c) => {
+                if (c.type === "slippage") {
+                    constraints.maxSlippage = c.value;
+                }
+                // TODO: Map other constraints
+            });
+        }
+        // Note: Token address resolution is handled in parseAsync / resolveTokenAddresses
+        // to keep buildIntent synchronous for backward compatibility.
+        // 4. Calculate confidence score
+        const confidence = calculateConfidence(parameters, template);
+        // 5. Add metadata
+        return {
+            intentType: intentType,
+            parameters,
+            constraints,
+            metadata: {
+                originalText,
+                confidence,
+                parsedAt: Date.now(),
+                warnings: [], // TODO: Add warnings based on validation/confidence
+            },
+        };
+    }
+    /**
+     * 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..."
+     */
+    async parseAsync(text) {
+        // Step 1: Jalankan parse() biasa (sync) untuk dapatkan base intent
+        const result = this.parse(text);
+        if (!result.success || !result.data)
+            return result;
+        // Step 2: Jika tokenResolver aktif → resolve addresses
+        if (this.tokenResolver) {
+            await this.resolveTokenAddresses(result.data);
+            // Step 3: Recalculate confidence — addresses may now be resolved,
+            // which triggers address bonuses in calculateConfidence
+            const template = this.templates.get(result.data.intentType);
+            if (template) {
+                result.data.metadata.confidence = calculateConfidence(result.data.parameters, template);
+            }
+        }
+        // Step 4: Return enriched result
+        return result;
+    }
+    /**
+     * 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
+     */
+    async resolveTokenAddresses(intent) {
+        if (!this.tokenResolver)
+            return;
+        // Default chain to ethereum if not specified
+        // Normalization should handle casing, but we ensure lowercase here for cache/API consistency
+        const chain = (intent.parameters.sourceChain || "ethereum").toLowerCase();
+        const warnings = intent.metadata.warnings || [];
+        // Resolve inputToken
+        if (intent.parameters.inputToken) {
+            const resolved = await this.tokenResolver.resolve(intent.parameters.inputToken, chain);
+            if (resolved) {
+                intent.parameters.inputTokenAddress = resolved.address;
+            }
+            else {
+                warnings.push(`Could not resolve address for ${intent.parameters.inputToken} on ${chain}`);
+            }
+        }
+        // Resolve outputToken
+        // If it's a bridge, targetChain might be different. 
+        // If not bridge, it's usually on the same chain (swap)
+        if (intent.parameters.outputToken) {
+            const outputChain = (intent.parameters.targetChain || chain).toLowerCase();
+            const resolved = await this.tokenResolver.resolve(intent.parameters.outputToken, outputChain);
+            if (resolved) {
+                intent.parameters.outputTokenAddress = resolved.address;
+            }
+            else {
+                warnings.push(`Could not resolve address for ${intent.parameters.outputToken} on ${outputChain}`);
+            }
+        }
+        intent.metadata.warnings = warnings;
+    }
+    /**
+     * Batch parse multiple intents (sync — tanpa token resolution)
+     *
+     * INPUT: Array of natural language strings
+     * OUTPUT: Array of ParseResult
+     */
+    parseBatch(texts) {
+        return texts.map((text) => this.parse(text));
+    }
+    /**
+     * 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
+     */
+    async parseBatchAsync(texts) {
+        return Promise.all(texts.map((text) => this.parseAsync(text)));
+    }
+}
+// Export everything
+export * from "../types";
+export { IntentParser as default };
+//# sourceMappingURL=index.js.map

package/dist/parser/index.js.map

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

package/dist/parser/template/bridge.d.ts

@@ -0,0 +1,37 @@
+import type { IntentTemplate } from "../../types";
+/**
+ * Bridge Intent Template
+ *
+ * Handles cross-chain token bridging between different blockchains.
+ *
+ * USE CASES:
+ * - "Bridge 100 USDC from Ethereum to Polygon"
+ * - "Move 0.5 ETH to Arbitrum"
+ * - "Cross-chain transfer 1000 DAI from mainnet to Optimism"
+ *
+ * REQUIRED FIELDS:
+ * - inputToken: The token to bridge (e.g., "USDC", "ETH")
+ * - inputAmount: How much to bridge (e.g., "100", "0.5")
+ * - sourceChain: Origin chain (e.g., "Ethereum", "Polygon")
+ * - targetChain: Destination chain (e.g., "Arbitrum", "Optimism")
+ *
+ * OPTIONAL FIELDS:
+ * - outputToken: Target token if different from input (e.g., bridge USDC, receive USDC.e)
+ * - maxSlippage: Maximum acceptable slippage in basis points (100 = 1%)
+ *
+ * DEFAULT CONSTRAINTS:
+ * - deadline: 0 (will be set dynamically)
+ * - maxSlippage: 100 (1%)
+ *
+ * KNOWN CHAINS (for reference):
+ * - "Ethereum" / "mainnet"
+ * - "Polygon"
+ * - "Arbitrum"
+ * - "Optimism"
+ * - "Base"
+ * - "Avalanche"
+ * - "BSC" / "BNB Chain"
+ * - "Solana"
+ */
+export declare const bridgeTemplate: IntentTemplate;
+//# sourceMappingURL=bridge.d.ts.map

package/dist/parser/template/bridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bridge.d.ts","sourceRoot":"","sources":["../../../src/parser/template/bridge.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAElD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,eAAO,MAAM,cAAc,EAAE,cAkD5B,CAAC"}

package/dist/parser/template/bridge.js

@@ -0,0 +1,80 @@
+/**
+ * Bridge Intent Template
+ *
+ * Handles cross-chain token bridging between different blockchains.
+ *
+ * USE CASES:
+ * - "Bridge 100 USDC from Ethereum to Polygon"
+ * - "Move 0.5 ETH to Arbitrum"
+ * - "Cross-chain transfer 1000 DAI from mainnet to Optimism"
+ *
+ * REQUIRED FIELDS:
+ * - inputToken: The token to bridge (e.g., "USDC", "ETH")
+ * - inputAmount: How much to bridge (e.g., "100", "0.5")
+ * - sourceChain: Origin chain (e.g., "Ethereum", "Polygon")
+ * - targetChain: Destination chain (e.g., "Arbitrum", "Optimism")
+ *
+ * OPTIONAL FIELDS:
+ * - outputToken: Target token if different from input (e.g., bridge USDC, receive USDC.e)
+ * - maxSlippage: Maximum acceptable slippage in basis points (100 = 1%)
+ *
+ * DEFAULT CONSTRAINTS:
+ * - deadline: 0 (will be set dynamically)
+ * - maxSlippage: 100 (1%)
+ *
+ * KNOWN CHAINS (for reference):
+ * - "Ethereum" / "mainnet"
+ * - "Polygon"
+ * - "Arbitrum"
+ * - "Optimism"
+ * - "Base"
+ * - "Avalanche"
+ * - "BSC" / "BNB Chain"
+ * - "Solana"
+ */
+export const bridgeTemplate = {
+    type: "bridge",
+    requiredFields: ["inputToken", "inputAmount", "sourceChain", "targetChain"],
+    optionalFields: ["outputToken", "maxSlippage"],
+    defaults: {
+        maxSlippage: 100, // 1%
+        outputToken: undefined,
+    },
+    defaultConstraints: {
+        deadline: 0,
+        maxSlippage: 100,
+    },
+    /**
+     * Validate bridge parameters
+     *
+     * INPUT: IntentParameters object
+     * OUTPUT: boolean — true if valid
+     *
+     * VALIDATION RULES:
+     * - inputToken must be present
+     * - inputAmount must be present and > 0
+     * - sourceChain must be present
+     * - targetChain must be present
+     * - sourceChain and targetChain must be different
+     */
+    validate: (params) => {
+        // 1. Check inputToken is present
+        if (!params.inputToken)
+            return false;
+        // 2. Check inputAmount is present and not "0"
+        if (!params.inputAmount || params.inputAmount === "0")
+            return false;
+        // 3. Check sourceChain is present
+        if (!params.sourceChain)
+            return false;
+        // 4. Check targetChain is present
+        if (!params.targetChain)
+            return false;
+        // 5. Verify sourceChain !== targetChain
+        if (params.sourceChain.toLowerCase() === params.targetChain.toLowerCase()) {
+            return false;
+        }
+        return true;
+    },
+};
+//# sourceMappingURL=bridge.js.map

package/dist/parser/template/bridge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bridge.js","sourceRoot":"","sources":["../../../src/parser/template/bridge.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,MAAM,CAAC,MAAM,cAAc,GAAmB;IAC1C,IAAI,EAAE,QAAQ;IAEd,cAAc,EAAE,CAAC,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,aAAa,CAAC;IAE3E,cAAc,EAAE,CAAC,aAAa,EAAE,aAAa,CAAC;IAE9C,QAAQ,EAAE;QACN,WAAW,EAAE,GAAG,EAAE,KAAK;QACvB,WAAW,EAAE,SAAS;KACzB;IAED,kBAAkB,EAAE;QAChB,QAAQ,EAAE,CAAC;QACX,WAAW,EAAE,GAAG;KACnB;IAED;;;;;;;;;;;;OAYG;IACH,QAAQ,EAAE,CAAC,MAAM,EAAE,EAAE;QACjB,iCAAiC;QACjC,IAAI,CAAC,MAAM,CAAC,UAAU;YAAE,OAAO,KAAK,CAAC;QAErC,8CAA8C;QAC9C,IAAI,CAAC,MAAM,CAAC,WAAW,IAAI,MAAM,CAAC,WAAW,KAAK,GAAG;YAAE,OAAO,KAAK,CAAC;QAEpE,kCAAkC;QAClC,IAAI,CAAC,MAAM,CAAC,WAAW;YAAE,OAAO,KAAK,CAAC;QAEtC,kCAAkC;QAClC,IAAI,CAAC,MAAM,CAAC,WAAW;YAAE,OAAO,KAAK,CAAC;QAEtC,wCAAwC;QACxC,IAAI,MAAM,CAAC,WAAW,CAAC,WAAW,EAAE,KAAK,MAAM,CAAC,WAAW,CAAC,WAAW,EAAE,EAAE,CAAC;YACxE,OAAO,KAAK,CAAC;QACjB,CAAC;QAED,OAAO,IAAI,CAAC;IAChB,CAAC;CACJ,CAAC"}

package/dist/parser/template/claim.d.ts

@@ -0,0 +1,15 @@
+import type { IntentTemplate } from "../../types";
+/**
+ * Claim Intent Template
+ *
+ * Handles claiming rewards, airdrops, and vested tokens.
+ *
+ * USE CASES:
+ * - "Claim my AERO airdrop"
+ * - "Claim staking rewards from ETH"
+ * - "Claim 500 vested ARB tokens"
+ * - "Collect my UNI rewards"
+ * - "Withdraw vested EIGEN tokens"
+ */
+export declare const claimTemplate: IntentTemplate;
+//# sourceMappingURL=claim.d.ts.map

package/dist/parser/template/claim.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claim.d.ts","sourceRoot":"","sources":["../../../src/parser/template/claim.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAElD;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,aAAa,EAAE,cA4B3B,CAAC"}

package/dist/parser/template/claim.js

@@ -0,0 +1,36 @@
+/**
+ * Claim Intent Template
+ *
+ * Handles claiming rewards, airdrops, and vested tokens.
+ *
+ * USE CASES:
+ * - "Claim my AERO airdrop"
+ * - "Claim staking rewards from ETH"
+ * - "Claim 500 vested ARB tokens"
+ * - "Collect my UNI rewards"
+ * - "Withdraw vested EIGEN tokens"
+ */
+export const claimTemplate = {
+    type: "claim",
+    // Only the token being claimed is strictly required —
+    // amount and protocol can often be inferred on-chain
+    requiredFields: ["inputToken"],
+    optionalFields: ["inputAmount", "claimType", "protocol"],
+    defaults: {
+        claimType: "rewards",
+    },
+    defaultConstraints: {
+        deadline: 0, // Will be set dynamically by parser
+    },
+    validate: (params) => {
+        if (!params.inputToken)
+            return false;
+        // claimType must be one of the known types if provided
+        if (params.claimType &&
+            !["airdrop", "rewards", "vesting"].includes(params.claimType)) {
+            return false;
+        }
+        return true;
+    },
+};
+//# sourceMappingURL=claim.js.map

package/dist/parser/template/claim.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"claim.js","sourceRoot":"","sources":["../../../src/parser/template/claim.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,aAAa,GAAmB;IACzC,IAAI,EAAE,OAAO;IAEb,sDAAsD;IACtD,qDAAqD;IACrD,cAAc,EAAE,CAAC,YAAY,CAAC;IAE9B,cAAc,EAAE,CAAC,aAAa,EAAE,WAAW,EAAE,UAAU,CAAC;IAExD,QAAQ,EAAE;QACN,SAAS,EAAE,SAAS;KACvB;IAED,kBAAkB,EAAE;QAChB,QAAQ,EAAE,CAAC,EAAE,oCAAoC;KACpD;IAED,QAAQ,EAAE,CAAC,MAAM,EAAE,EAAE;QACjB,IAAI,CAAC,MAAM,CAAC,UAAU;YAAE,OAAO,KAAK,CAAC;QACrC,uDAAuD;QACvD,IACI,MAAM,CAAC,SAAS;YAChB,CAAC,CAAC,SAAS,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,SAAS,CAAC,EAC/D,CAAC;YACC,OAAO,KAAK,CAAC;QACjB,CAAC;QACD,OAAO,IAAI,CAAC;IAChB,CAAC;CACJ,CAAC"}

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

@@ -0,0 +1,28 @@
+import type { IntentTemplate, IntentType } from "../../types";
+/**
+ * Template Registry
+ * Central registry for all intent templates
+ */
+export declare class TemplateRegistry {
+    private templates;
+    constructor();
+    /**
+     * Get template by intent type
+     *
+     * INPUT: IntentType
+     * OUTPUT: IntentTemplate | undefined
+     */
+    get(intentType: IntentType): IntentTemplate | undefined;
+    /**
+     * Register custom template
+     *
+     * INPUT: IntentTemplate
+     * OUTPUT: void
+     */
+    register(template: IntentTemplate): void;
+    /**
+     * Check if template exists
+     */
+    has(intentType: IntentType): boolean;
+}
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/parser/template/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAS9D;;;GAGG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,SAAS,CAAkC;;IAcnD;;;;;OAKG;IACH,GAAG,CAAC,UAAU,EAAE,UAAU,GAAG,cAAc,GAAG,SAAS;IAIvD;;;;;OAKG;IACH,QAAQ,CAAC,QAAQ,EAAE,cAAc,GAAG,IAAI;IAIxC;;OAEG;IACH,GAAG,CAAC,UAAU,EAAE,UAAU,GAAG,OAAO;CAGrC"}

package/dist/parser/template/index.js

@@ -0,0 +1,50 @@
+import { swapTemplate } from "./swap";
+import { yieldTemplate } from "./yield";
+import { nftTemplate } from "./nft";
+import { sendTemplate } from "./send";
+import { bridgeTemplate } from "./bridge";
+import { claimTemplate } from "./claim";
+import { unknownTemplate } from "./unknown";
+/**
+ * Template Registry
+ * Central registry for all intent templates
+ */
+export class TemplateRegistry {
+    templates;
+    constructor() {
+        this.templates = new Map([
+            ["swap", swapTemplate],
+            ["yield_strategy", yieldTemplate],
+            ["nft_purchase", nftTemplate],
+            ["send", sendTemplate],
+            ["bridge", bridgeTemplate],
+            ["claim", claimTemplate],
+            ["unknown", unknownTemplate],
+        ]);
+    }
+    /**
+     * Get template by intent type
+     *
+     * INPUT: IntentType
+     * OUTPUT: IntentTemplate | undefined
+     */
+    get(intentType) {
+        return this.templates.get(intentType);
+    }
+    /**
+     * Register custom template
+     *
+     * INPUT: IntentTemplate
+     * OUTPUT: void
+     */
+    register(template) {
+        this.templates.set(template.type, template);
+    }
+    /**
+     * Check if template exists
+     */
+    has(intentType) {
+        return this.templates.has(intentType);
+    }
+}
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/parser/template/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AACtC,OAAO,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACxC,OAAO,EAAE,WAAW,EAAE,MAAM,OAAO,CAAC;AACpC,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AACtC,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACxC,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAE5C;;;GAGG;AACH,MAAM,OAAO,gBAAgB;IACnB,SAAS,CAAkC;IAEnD;QACE,IAAI,CAAC,SAAS,GAAG,IAAI,GAAG,CAAC;YACvB,CAAC,MAAM,EAAE,YAAY,CAAC;YACtB,CAAC,gBAAgB,EAAE,aAAa,CAAC;YACjC,CAAC,cAAc,EAAE,WAAW,CAAC;YAC7B,CAAC,MAAM,EAAE,YAAY,CAAC;YACtB,CAAC,QAAQ,EAAE,cAAc,CAAC;YAC1B,CAAC,OAAO,EAAE,aAAa,CAAC;YACxB,CAAC,SAAS,EAAE,eAAe,CAAC;SAC7B,CAAC,CAAC;IACL,CAAC;IAED;;;;;OAKG;IACH,GAAG,CAAC,UAAsB;QACxB,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;IACxC,CAAC;IAED;;;;;OAKG;IACH,QAAQ,CAAC,QAAwB;QAC/B,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IAC9C,CAAC;IAED;;OAEG;IACH,GAAG,CAAC,UAAsB;QACxB,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;IACxC,CAAC;CACF"}

package/dist/parser/template/nft.d.ts

@@ -0,0 +1,3 @@
+import type { IntentTemplate } from "../../types";
+export declare const nftTemplate: IntentTemplate;
+//# sourceMappingURL=nft.d.ts.map

package/dist/parser/template/nft.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nft.d.ts","sourceRoot":"","sources":["../../../src/parser/template/nft.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAElD,eAAO,MAAM,WAAW,EAAE,cAqBzB,CAAC"}

package/dist/parser/template/nft.js

@@ -0,0 +1,19 @@
+export const nftTemplate = {
+    type: "nft_purchase",
+    requiredFields: ["collection"],
+    optionalFields: ["traits", "maxPrice", "recipient"],
+    defaults: {
+        traits: {},
+        recipient: undefined,
+    },
+    defaultConstraints: {
+        deadline: 0,
+        preferredMarketplaces: ["opensea", "blur"],
+    },
+    validate: (params) => {
+        if (!params.collection)
+            return false;
+        return true;
+    },
+};
+//# sourceMappingURL=nft.js.map

package/dist/parser/template/nft.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nft.js","sourceRoot":"","sources":["../../../src/parser/template/nft.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,WAAW,GAAmB;IACzC,IAAI,EAAE,cAAc;IAEpB,cAAc,EAAE,CAAC,YAAY,CAAC;IAE9B,cAAc,EAAE,CAAC,QAAQ,EAAE,UAAU,EAAE,WAAW,CAAC;IAEnD,QAAQ,EAAE;QACR,MAAM,EAAE,EAAE;QACV,SAAS,EAAE,SAAS;KACrB;IAED,kBAAkB,EAAE;QAClB,QAAQ,EAAE,CAAC;QACX,qBAAqB,EAAE,CAAC,SAAS,EAAE,MAAM,CAAC;KAC3C;IAED,QAAQ,EAAE,CAAC,MAAM,EAAE,EAAE;QACnB,IAAI,CAAC,MAAM,CAAC,UAAU;YAAE,OAAO,KAAK,CAAC;QACrC,OAAO,IAAI,CAAC;IACd,CAAC;CACF,CAAC"}

package/dist/parser/template/send.d.ts

@@ -0,0 +1,24 @@
+import type { IntentTemplate } from "../../types";
+/**
+ * Send Intent Template
+ *
+ * Handles sending/transferring tokens to a recipient address.
+ *
+ * USE CASES:
+ * - "Send 0.5 ETH to 0x1234..."
+ * - "Transfer 100 USDC to vitalik.eth"
+ * - "Pay 50 DAI to 0xabcd..."
+ *
+ * REQUIRED FIELDS:
+ * - inputToken: The token to send (e.g., "ETH", "USDC")
+ * - inputAmount: How much to send (e.g., "0.5", "100")
+ * - recipient: Destination address or ENS name (e.g., "0x1234...", "vitalik.eth")
+ *
+ * OPTIONAL FIELDS:
+ * - maxGasCost: Maximum gas the user is willing to pay (e.g., "0.01")
+ *
+ * DEFAULT CONSTRAINTS:
+ * - deadline: 0 (will be set dynamically by parser using config.defaultDeadlineOffset)
+ */
+export declare const sendTemplate: IntentTemplate;
+//# sourceMappingURL=send.d.ts.map

package/dist/parser/template/send.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"send.d.ts","sourceRoot":"","sources":["../../../src/parser/template/send.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAElD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,eAAO,MAAM,YAAY,EAAE,cA4C1B,CAAC"}