@chaoslabs/ai-sdk 0.0.2 → 0.0.3

package/dist/conversation.js

@@ -0,0 +1,230 @@
+// Chaos AI SDK - Conversation Management
+//
+// A class for managing multi-turn conversations with history tracking.
+import { extractText } from './types.js';
+import { WALLET_MODEL } from './request.js';
+/**
+ * Manages a multi-turn conversation with history tracking.
+ *
+ * @example
+ * ```typescript
+ * import { Chaos, Conversation } from '@chaoslabs/ai-sdk';
+ *
+ * const chaos = new Chaos({ apiKey: 'ck-...' });
+ * const conversation = new Conversation(chaos, {
+ *   userId: 'user-123',
+ *   walletId: '0x...',
+ * });
+ *
+ * // Send messages - history is tracked automatically
+ * const response1 = await conversation.send("What's my portfolio value?");
+ * const response2 = await conversation.send("Which asset has the highest allocation?");
+ *
+ * // Get conversation stats
+ * console.log(conversation.stats);
+ *
+ * // Reset for a new conversation
+ * conversation.reset();
+ * ```
+ */
+export class Conversation {
+    client;
+    model;
+    maxHistoryLength;
+    history = [];
+    metadata;
+    userTurns = 0;
+    assistantTurns = 0;
+    startedAt;
+    lastMessageAt = null;
+    constructor(client, options) {
+        this.client = client;
+        this.model = options.model || WALLET_MODEL;
+        this.maxHistoryLength = options.maxHistoryLength || 50;
+        this.startedAt = new Date();
+        this.metadata = {
+            user_id: options.userId,
+            wallet_id: options.walletId,
+            session_id: options.sessionId || `session-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`,
+        };
+    }
+    /**
+     * Get the current session ID.
+     */
+    get sessionId() {
+        return this.metadata.session_id;
+    }
+    /**
+     * Get the conversation history.
+     */
+    get messages() {
+        return [...this.history];
+    }
+    /**
+     * Get conversation statistics.
+     */
+    get stats() {
+        return {
+            userTurns: this.userTurns,
+            assistantTurns: this.assistantTurns,
+            totalMessages: this.history.length,
+            sessionId: this.metadata.session_id,
+            startedAt: this.startedAt,
+            lastMessageAt: this.lastMessageAt,
+        };
+    }
+    /**
+     * Send a message and get a response.
+     * Automatically manages conversation history.
+     */
+    async send(message) {
+        // Add user message to history
+        this.addUserMessage(message);
+        // Send request with full history
+        const response = await this.client.chat.responses.create({
+            model: this.model,
+            input: [...this.history],
+            metadata: this.metadata,
+        });
+        // Add assistant response to history if successful
+        if (response.status === 'completed') {
+            const text = extractText(response);
+            if (text) {
+                this.addAssistantMessage(text);
+            }
+        }
+        this.lastMessageAt = new Date();
+        return response;
+    }
+    /**
+     * Add a user message to the history without sending.
+     * Useful for restoring conversation state.
+     */
+    addUserMessage(content) {
+        this.history.push({
+            type: 'message',
+            role: 'user',
+            content,
+        });
+        this.userTurns++;
+        this.trimHistory();
+    }
+    /**
+     * Add an assistant message to the history.
+     * Useful for restoring conversation state.
+     */
+    addAssistantMessage(content) {
+        // Store assistant responses as user messages with prefix for context
+        // This matches the pattern used in the multi-turn example
+        this.history.push({
+            type: 'message',
+            role: 'user',
+            content: `[Assistant]: ${content}`,
+        });
+        this.assistantTurns++;
+        this.trimHistory();
+    }
+    /**
+     * Add a system message to the history.
+     */
+    addSystemMessage(content) {
+        this.history.push({
+            type: 'message',
+            role: 'system',
+            content,
+        });
+        this.trimHistory();
+    }
+    /**
+     * Reset the conversation to start fresh.
+     * Generates a new session ID and clears history.
+     */
+    reset() {
+        this.history = [];
+        this.userTurns = 0;
+        this.assistantTurns = 0;
+        this.startedAt = new Date();
+        this.lastMessageAt = null;
+        this.metadata.session_id = `session-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`;
+    }
+    /**
+     * Clear the history but keep the same session ID.
+     */
+    clearHistory() {
+        this.history = [];
+        this.userTurns = 0;
+        this.assistantTurns = 0;
+    }
+    /**
+     * Fork this conversation to create a branch.
+     * The new conversation has the same history but a new session ID.
+     */
+    fork() {
+        const forked = new Conversation(this.client, {
+            model: this.model,
+            maxHistoryLength: this.maxHistoryLength,
+            userId: this.metadata.user_id,
+            walletId: this.metadata.wallet_id,
+        });
+        // Copy history
+        for (const msg of this.history) {
+            if (msg.role === 'user') {
+                if (msg.content.startsWith('[Assistant]: ')) {
+                    forked.history.push(msg);
+                    forked.assistantTurns++;
+                }
+                else {
+                    forked.history.push(msg);
+                    forked.userTurns++;
+                }
+            }
+            else {
+                forked.history.push(msg);
+            }
+        }
+        return forked;
+    }
+    /**
+     * Serialize the conversation to JSON for persistence.
+     */
+    toJSON() {
+        return {
+            sessionId: this.metadata.session_id,
+            history: [...this.history],
+            metadata: { ...this.metadata },
+            stats: this.stats,
+        };
+    }
+    /**
+     * Restore conversation state from JSON.
+     */
+    static fromJSON(client, data) {
+        const conversation = new Conversation(client, {
+            userId: data.metadata.user_id,
+            walletId: data.metadata.wallet_id,
+            sessionId: data.sessionId,
+        });
+        // Restore history
+        for (const msg of data.history) {
+            conversation.history.push(msg);
+            if (msg.role === 'user') {
+                if (msg.content.startsWith('[Assistant]: ')) {
+                    conversation.assistantTurns++;
+                }
+                else {
+                    conversation.userTurns++;
+                }
+            }
+        }
+        return conversation;
+    }
+    /**
+     * Trim history to stay within maxHistoryLength.
+     */
+    trimHistory() {
+        if (this.history.length > this.maxHistoryLength) {
+            const excess = this.history.length - this.maxHistoryLength;
+            this.history = this.history.slice(excess);
+        }
+    }
+}

package/dist/index.d.ts

@@ -6,3 +6,8 @@ export { ChaosError, ChaosTimeoutError } from './types.js';
 export { extractText, extractBlocks, hasRisks, hasBlockers, isTableBlock, isChartBlock, isTransactionActionBlock, isInteractiveBlock, isMarkdownBlock, isOutputText, isChaosBlock, } from './types.js';
 export { BlockSchema, parseRawBlock, detectBlockType } from './schemas.js';
 export type { BlockParsed } from './schemas.js';
+export { Conversation } from './conversation.js';
+export type { ConversationOptions, ConversationStats } from './conversation.js';
+export { PRIMITIVE_SWAP, PRIMITIVE_SUPPLY, PRIMITIVE_WITHDRAW, PRIMITIVE_BORROW, PRIMITIVE_REPAY, PRIMITIVE_STAKE, PRIMITIVE_UNSTAKE, PRIMITIVE_CLAIM, PRIMITIVE_BRIDGE, PRIMITIVE_ADD_LIQUIDITY, PRIMITIVE_REMOVE_LIQUIDITY, PRIMITIVE_OPEN_POSITION, PRIMITIVE_CLOSE_POSITION, PRIMITIVE_DEPOSIT, PRIMITIVE_MINT, PRIMITIVE_BURN, PRIMITIVE_RESTAKE, PRIMITIVE_APPROVE, PRIMITIVE_TRANSFER, PRIMITIVE_WRAP, PRIMITIVE_UNWRAP, ALL_PRIMITIVES, LENDING_PRIMITIVES, TRADING_PRIMITIVES, STAKING_PRIMITIVES, LIQUIDITY_PRIMITIVES, TRANSFER_PRIMITIVES, isValidPrimitive, isLendingPrimitive, isTradingPrimitive, isStakingPrimitive, isLiquidityPrimitive, isTransferPrimitive, } from './primitives.js';
+export type { PrimitiveType } from './primitives.js';
+export { extractTableBlocks, extractChartBlocks, extractTransactionBlocks, extractMarkdownBlocks, extractInteractiveBlocks, findTableByTitle, findChartByTitle, findTransactionsByPrimitive, extractPrimitives, extractPrimitivesByType, getPrimitiveTypes, tableToObjects, getTableColumn, findTableRow, getTableDimensions, getChartData, getChartTotal, getChartPercentages, getAllWarnings, getAllBlockers, getHighestRiskLevel, countBlocksByType, hasBlocks, hasBlockType, } from './blocks.js';

package/dist/index.js

@@ -6,3 +6,29 @@ export { ChaosError, ChaosTimeoutError } from './types.js';
 export { extractText, extractBlocks, hasRisks, hasBlockers, isTableBlock, isChartBlock, isTransactionActionBlock, isInteractiveBlock, isMarkdownBlock, isOutputText, isChaosBlock, } from './types.js';
 // Export schemas for validation
 export { BlockSchema, parseRawBlock, detectBlockType } from './schemas.js';
+// Export Conversation class
+export { Conversation } from './conversation.js';
+// Export primitive constants and helpers
+export { 
+// Primitive type constants
+PRIMITIVE_SWAP, PRIMITIVE_SUPPLY, PRIMITIVE_WITHDRAW, PRIMITIVE_BORROW, PRIMITIVE_REPAY, PRIMITIVE_STAKE, PRIMITIVE_UNSTAKE, PRIMITIVE_CLAIM, PRIMITIVE_BRIDGE, PRIMITIVE_ADD_LIQUIDITY, PRIMITIVE_REMOVE_LIQUIDITY, PRIMITIVE_OPEN_POSITION, PRIMITIVE_CLOSE_POSITION, PRIMITIVE_DEPOSIT, PRIMITIVE_MINT, PRIMITIVE_BURN, PRIMITIVE_RESTAKE, PRIMITIVE_APPROVE, PRIMITIVE_TRANSFER, PRIMITIVE_WRAP, PRIMITIVE_UNWRAP, 
+// Primitive categories
+ALL_PRIMITIVES, LENDING_PRIMITIVES, TRADING_PRIMITIVES, STAKING_PRIMITIVES, LIQUIDITY_PRIMITIVES, TRANSFER_PRIMITIVES, 
+// Primitive helpers
+isValidPrimitive, isLendingPrimitive, isTradingPrimitive, isStakingPrimitive, isLiquidityPrimitive, isTransferPrimitive, } from './primitives.js';
+// Export block utilities
+export { 
+// Block extraction
+extractTableBlocks, extractChartBlocks, extractTransactionBlocks, extractMarkdownBlocks, extractInteractiveBlocks, 
+// Block search
+findTableByTitle, findChartByTitle, findTransactionsByPrimitive, 
+// Primitive extraction
+extractPrimitives, extractPrimitivesByType, getPrimitiveTypes, 
+// Table utilities
+tableToObjects, getTableColumn, findTableRow, getTableDimensions, 
+// Chart utilities
+getChartData, getChartTotal, getChartPercentages, 
+// Risk utilities
+getAllWarnings, getAllBlockers, getHighestRiskLevel, 
+// Block statistics
+countBlocksByType, hasBlocks, hasBlockType, } from './blocks.js';

package/dist/primitives.d.ts

@@ -0,0 +1,157 @@
+/**
+ * Swap tokens on a decentralized exchange.
+ * @example "Swap 1 ETH for USDC"
+ */
+export declare const PRIMITIVE_SWAP = "swap";
+/**
+ * Supply assets to a lending protocol.
+ * @example "Supply 1000 USDC to Aave"
+ */
+export declare const PRIMITIVE_SUPPLY = "supply";
+/**
+ * Withdraw supplied assets from a lending protocol.
+ * @example "Withdraw my USDC from Compound"
+ */
+export declare const PRIMITIVE_WITHDRAW = "withdraw";
+/**
+ * Borrow assets from a lending protocol.
+ * @example "Borrow 500 DAI from Aave"
+ */
+export declare const PRIMITIVE_BORROW = "borrow";
+/**
+ * Repay borrowed assets to a lending protocol.
+ * @example "Repay my DAI debt on Compound"
+ */
+export declare const PRIMITIVE_REPAY = "repay";
+/**
+ * Stake tokens for rewards or governance.
+ * @example "Stake 10 ETH with Lido"
+ */
+export declare const PRIMITIVE_STAKE = "stake";
+/**
+ * Unstake previously staked tokens.
+ * @example "Unstake my stETH"
+ */
+export declare const PRIMITIVE_UNSTAKE = "unstake";
+/**
+ * Claim accrued rewards from protocols.
+ * @example "Claim my Aave rewards"
+ */
+export declare const PRIMITIVE_CLAIM = "claim";
+/**
+ * Bridge assets between chains.
+ * @example "Bridge 100 USDC to Arbitrum"
+ */
+export declare const PRIMITIVE_BRIDGE = "bridge";
+/**
+ * Provide liquidity to a pool.
+ * @example "Add liquidity to ETH-USDC pool"
+ */
+export declare const PRIMITIVE_ADD_LIQUIDITY = "add_liquidity";
+/**
+ * Remove liquidity from a pool.
+ * @example "Remove liquidity from my ETH-USDC position"
+ */
+export declare const PRIMITIVE_REMOVE_LIQUIDITY = "remove_liquidity";
+/**
+ * Open a perpetual futures position.
+ * @example "Open 2x long ETH position"
+ */
+export declare const PRIMITIVE_OPEN_POSITION = "open_position";
+/**
+ * Close a perpetual futures position.
+ * @example "Close my ETH long"
+ */
+export declare const PRIMITIVE_CLOSE_POSITION = "close_position";
+/**
+ * Deposit into a vault strategy.
+ * @example "Deposit 1000 USDC into Yearn"
+ */
+export declare const PRIMITIVE_DEPOSIT = "deposit";
+/**
+ * Mint stablecoins or synthetic assets.
+ * @example "Mint 1000 DAI from my ETH collateral"
+ */
+export declare const PRIMITIVE_MINT = "mint";
+/**
+ * Burn or repay minted assets.
+ * @example "Burn 500 DAI to reduce my debt"
+ */
+export declare const PRIMITIVE_BURN = "burn";
+/**
+ * Restake assets for additional yield.
+ * @example "Restake my stETH on EigenLayer"
+ */
+export declare const PRIMITIVE_RESTAKE = "restake";
+/**
+ * Approve token spending.
+ * @example "Approve USDC for Uniswap"
+ */
+export declare const PRIMITIVE_APPROVE = "approve";
+/**
+ * Transfer tokens to another address.
+ * @example "Send 100 USDC to 0x..."
+ */
+export declare const PRIMITIVE_TRANSFER = "transfer";
+/**
+ * Wrap native tokens (e.g., ETH to WETH).
+ * @example "Wrap 1 ETH to WETH"
+ */
+export declare const PRIMITIVE_WRAP = "wrap";
+/**
+ * Unwrap wrapped tokens (e.g., WETH to ETH).
+ * @example "Unwrap 1 WETH to ETH"
+ */
+export declare const PRIMITIVE_UNWRAP = "unwrap";
+/**
+ * All DeFi primitive types as a union type.
+ */
+export type PrimitiveType = typeof PRIMITIVE_SWAP | typeof PRIMITIVE_SUPPLY | typeof PRIMITIVE_WITHDRAW | typeof PRIMITIVE_BORROW | typeof PRIMITIVE_REPAY | typeof PRIMITIVE_STAKE | typeof PRIMITIVE_UNSTAKE | typeof PRIMITIVE_CLAIM | typeof PRIMITIVE_BRIDGE | typeof PRIMITIVE_ADD_LIQUIDITY | typeof PRIMITIVE_REMOVE_LIQUIDITY | typeof PRIMITIVE_OPEN_POSITION | typeof PRIMITIVE_CLOSE_POSITION | typeof PRIMITIVE_DEPOSIT | typeof PRIMITIVE_MINT | typeof PRIMITIVE_BURN | typeof PRIMITIVE_RESTAKE | typeof PRIMITIVE_APPROVE | typeof PRIMITIVE_TRANSFER | typeof PRIMITIVE_WRAP | typeof PRIMITIVE_UNWRAP;
+/**
+ * All primitive type constants for iteration.
+ */
+export declare const ALL_PRIMITIVES: PrimitiveType[];
+/**
+ * Lending-related primitives.
+ */
+export declare const LENDING_PRIMITIVES: PrimitiveType[];
+/**
+ * Trading-related primitives.
+ */
+export declare const TRADING_PRIMITIVES: PrimitiveType[];
+/**
+ * Staking-related primitives.
+ */
+export declare const STAKING_PRIMITIVES: PrimitiveType[];
+/**
+ * Liquidity-related primitives.
+ */
+export declare const LIQUIDITY_PRIMITIVES: PrimitiveType[];
+/**
+ * Transfer-related primitives.
+ */
+export declare const TRANSFER_PRIMITIVES: PrimitiveType[];
+/**
+ * Check if a primitive type is valid.
+ */
+export declare function isValidPrimitive(primitive: string): primitive is PrimitiveType;
+/**
+ * Check if a primitive is a lending operation.
+ */
+export declare function isLendingPrimitive(primitive: string): boolean;
+/**
+ * Check if a primitive is a trading operation.
+ */
+export declare function isTradingPrimitive(primitive: string): boolean;
+/**
+ * Check if a primitive is a staking operation.
+ */
+export declare function isStakingPrimitive(primitive: string): boolean;
+/**
+ * Check if a primitive is a liquidity operation.
+ */
+export declare function isLiquidityPrimitive(primitive: string): boolean;
+/**
+ * Check if a primitive is a transfer operation.
+ */
+export declare function isTransferPrimitive(primitive: string): boolean;

package/dist/primitives.js

@@ -0,0 +1,220 @@
+// Chaos AI SDK - Primitive Constants
+//
+// Constants for all DeFi primitive types supported by the SDK.
+// Use these when checking primitive types in TransactionActionBlocks.
+// ============================================================================
+// Primitive Type Constants
+// ============================================================================
+/**
+ * Swap tokens on a decentralized exchange.
+ * @example "Swap 1 ETH for USDC"
+ */
+export const PRIMITIVE_SWAP = 'swap';
+/**
+ * Supply assets to a lending protocol.
+ * @example "Supply 1000 USDC to Aave"
+ */
+export const PRIMITIVE_SUPPLY = 'supply';
+/**
+ * Withdraw supplied assets from a lending protocol.
+ * @example "Withdraw my USDC from Compound"
+ */
+export const PRIMITIVE_WITHDRAW = 'withdraw';
+/**
+ * Borrow assets from a lending protocol.
+ * @example "Borrow 500 DAI from Aave"
+ */
+export const PRIMITIVE_BORROW = 'borrow';
+/**
+ * Repay borrowed assets to a lending protocol.
+ * @example "Repay my DAI debt on Compound"
+ */
+export const PRIMITIVE_REPAY = 'repay';
+/**
+ * Stake tokens for rewards or governance.
+ * @example "Stake 10 ETH with Lido"
+ */
+export const PRIMITIVE_STAKE = 'stake';
+/**
+ * Unstake previously staked tokens.
+ * @example "Unstake my stETH"
+ */
+export const PRIMITIVE_UNSTAKE = 'unstake';
+/**
+ * Claim accrued rewards from protocols.
+ * @example "Claim my Aave rewards"
+ */
+export const PRIMITIVE_CLAIM = 'claim';
+/**
+ * Bridge assets between chains.
+ * @example "Bridge 100 USDC to Arbitrum"
+ */
+export const PRIMITIVE_BRIDGE = 'bridge';
+/**
+ * Provide liquidity to a pool.
+ * @example "Add liquidity to ETH-USDC pool"
+ */
+export const PRIMITIVE_ADD_LIQUIDITY = 'add_liquidity';
+/**
+ * Remove liquidity from a pool.
+ * @example "Remove liquidity from my ETH-USDC position"
+ */
+export const PRIMITIVE_REMOVE_LIQUIDITY = 'remove_liquidity';
+/**
+ * Open a perpetual futures position.
+ * @example "Open 2x long ETH position"
+ */
+export const PRIMITIVE_OPEN_POSITION = 'open_position';
+/**
+ * Close a perpetual futures position.
+ * @example "Close my ETH long"
+ */
+export const PRIMITIVE_CLOSE_POSITION = 'close_position';
+/**
+ * Deposit into a vault strategy.
+ * @example "Deposit 1000 USDC into Yearn"
+ */
+export const PRIMITIVE_DEPOSIT = 'deposit';
+/**
+ * Mint stablecoins or synthetic assets.
+ * @example "Mint 1000 DAI from my ETH collateral"
+ */
+export const PRIMITIVE_MINT = 'mint';
+/**
+ * Burn or repay minted assets.
+ * @example "Burn 500 DAI to reduce my debt"
+ */
+export const PRIMITIVE_BURN = 'burn';
+/**
+ * Restake assets for additional yield.
+ * @example "Restake my stETH on EigenLayer"
+ */
+export const PRIMITIVE_RESTAKE = 'restake';
+/**
+ * Approve token spending.
+ * @example "Approve USDC for Uniswap"
+ */
+export const PRIMITIVE_APPROVE = 'approve';
+/**
+ * Transfer tokens to another address.
+ * @example "Send 100 USDC to 0x..."
+ */
+export const PRIMITIVE_TRANSFER = 'transfer';
+/**
+ * Wrap native tokens (e.g., ETH to WETH).
+ * @example "Wrap 1 ETH to WETH"
+ */
+export const PRIMITIVE_WRAP = 'wrap';
+/**
+ * Unwrap wrapped tokens (e.g., WETH to ETH).
+ * @example "Unwrap 1 WETH to ETH"
+ */
+export const PRIMITIVE_UNWRAP = 'unwrap';
+/**
+ * All primitive type constants for iteration.
+ */
+export const ALL_PRIMITIVES = [
+    PRIMITIVE_SWAP,
+    PRIMITIVE_SUPPLY,
+    PRIMITIVE_WITHDRAW,
+    PRIMITIVE_BORROW,
+    PRIMITIVE_REPAY,
+    PRIMITIVE_STAKE,
+    PRIMITIVE_UNSTAKE,
+    PRIMITIVE_CLAIM,
+    PRIMITIVE_BRIDGE,
+    PRIMITIVE_ADD_LIQUIDITY,
+    PRIMITIVE_REMOVE_LIQUIDITY,
+    PRIMITIVE_OPEN_POSITION,
+    PRIMITIVE_CLOSE_POSITION,
+    PRIMITIVE_DEPOSIT,
+    PRIMITIVE_MINT,
+    PRIMITIVE_BURN,
+    PRIMITIVE_RESTAKE,
+    PRIMITIVE_APPROVE,
+    PRIMITIVE_TRANSFER,
+    PRIMITIVE_WRAP,
+    PRIMITIVE_UNWRAP,
+];
+/**
+ * Lending-related primitives.
+ */
+export const LENDING_PRIMITIVES = [
+    PRIMITIVE_SUPPLY,
+    PRIMITIVE_WITHDRAW,
+    PRIMITIVE_BORROW,
+    PRIMITIVE_REPAY,
+];
+/**
+ * Trading-related primitives.
+ */
+export const TRADING_PRIMITIVES = [
+    PRIMITIVE_SWAP,
+    PRIMITIVE_OPEN_POSITION,
+    PRIMITIVE_CLOSE_POSITION,
+];
+/**
+ * Staking-related primitives.
+ */
+export const STAKING_PRIMITIVES = [
+    PRIMITIVE_STAKE,
+    PRIMITIVE_UNSTAKE,
+    PRIMITIVE_RESTAKE,
+    PRIMITIVE_CLAIM,
+];
+/**
+ * Liquidity-related primitives.
+ */
+export const LIQUIDITY_PRIMITIVES = [
+    PRIMITIVE_ADD_LIQUIDITY,
+    PRIMITIVE_REMOVE_LIQUIDITY,
+    PRIMITIVE_DEPOSIT,
+];
+/**
+ * Transfer-related primitives.
+ */
+export const TRANSFER_PRIMITIVES = [
+    PRIMITIVE_BRIDGE,
+    PRIMITIVE_TRANSFER,
+    PRIMITIVE_WRAP,
+    PRIMITIVE_UNWRAP,
+];
+// ============================================================================
+// Primitive Helpers
+// ============================================================================
+/**
+ * Check if a primitive type is valid.
+ */
+export function isValidPrimitive(primitive) {
+    return ALL_PRIMITIVES.includes(primitive);
+}
+/**
+ * Check if a primitive is a lending operation.
+ */
+export function isLendingPrimitive(primitive) {
+    return LENDING_PRIMITIVES.includes(primitive);
+}
+/**
+ * Check if a primitive is a trading operation.
+ */
+export function isTradingPrimitive(primitive) {
+    return TRADING_PRIMITIVES.includes(primitive);
+}
+/**
+ * Check if a primitive is a staking operation.
+ */
+export function isStakingPrimitive(primitive) {
+    return STAKING_PRIMITIVES.includes(primitive);
+}
+/**
+ * Check if a primitive is a liquidity operation.
+ */
+export function isLiquidityPrimitive(primitive) {
+    return LIQUIDITY_PRIMITIVES.includes(primitive);
+}
+/**
+ * Check if a primitive is a transfer operation.
+ */
+export function isTransferPrimitive(primitive) {
+    return TRANSFER_PRIMITIVES.includes(primitive);
+}