clodds 1.1.0

package/dist/api/prompt.js

@@ -0,0 +1,345 @@
+"use strict";
+/**
+ * Prompt Handler - Natural language prompt processing
+ *
+ * Transforms user prompts into executable actions using the agent system.
+ * Integrates with Clodds subagent system for actual execution.
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createPromptHandler = createPromptHandler;
+const sdk_1 = __importDefault(require("@anthropic-ai/sdk"));
+const logger_1 = require("../utils/logger");
+// =============================================================================
+// CONSTANTS
+// =============================================================================
+const DEFAULT_CONFIG = {
+    maxLength: 2000,
+    timeout: 60000,
+    model: 'claude-sonnet-4-20250514',
+    dryRun: false,
+    apiKey: '',
+    maxTokens: 4096,
+};
+// System prompt for API execution
+const API_SYSTEM_PROMPT = `You are Clodds API, an AI assistant for prediction markets and trading.
+
+You help users via natural language commands:
+- Query prices, balances, positions across platforms
+- Execute trades on Polymarket, Kalshi, and other markets
+- Swap tokens on DEXs (Solana, Base, Ethereum)
+- Set up copy trading and signals
+- Analyze markets and find edge
+
+IMPORTANT: You are executing via API, not chat. Be concise and return structured data.
+When executing trades, always confirm the action with specific details.
+Never execute trades without explicit user intent in the prompt.
+
+Available platforms: polymarket, kalshi, manifold, hyperliquid, binance
+Supported chains: ethereum, base, solana, polygon, arbitrum`;
+// Action classification patterns
+const ACTION_PATTERNS = {
+    query: [
+        /(?:what|how much|show|get|check|display|list|view|lookup|find).*(?:price|balance|position|portfolio|status|info)/i,
+        /(?:price|balance|value|worth|pnl|profit|loss).*(?:of|for|is)/i,
+    ],
+    trade: [
+        /(?:buy|sell|long|short).*(?:\$|usd|usdc|token|share|contract)/i,
+        /(?:place|submit|execute).*(?:order|trade|bet|position)/i,
+        /(?:market|limit).*(?:buy|sell|order)/i,
+    ],
+    swap: [
+        /swap.*(?:for|to|into)/i,
+        /(?:exchange|convert|trade).*(?:for|to|into)/i,
+    ],
+    transfer: [
+        /(?:send|transfer|move).*(?:to|from)/i,
+        /(?:withdraw|deposit)/i,
+    ],
+    stake: [
+        /(?:stake|lock|delegate)/i,
+    ],
+    unstake: [
+        /(?:unstake|unlock|undelegate|withdraw.*stake)/i,
+    ],
+    claim: [
+        /(?:claim|collect|harvest).*(?:reward|yield|earning|airdrop)/i,
+    ],
+    approve: [
+        /(?:approve|allow|permit).*(?:spend|token|contract)/i,
+    ],
+    bridge: [
+        /(?:bridge|cross-chain|transfer.*chain)/i,
+    ],
+    analysis: [
+        /(?:analyze|analyse|research|compare|evaluate)/i,
+        /(?:should i|is it good|worth|recommend)/i,
+    ],
+    automation: [
+        /(?:automate|schedule|recurring|trigger|alert|notify)/i,
+        /(?:set up|create).*(?:bot|strategy|rule)/i,
+        /(?:copy|follow|mirror).*(?:trade|wallet|trader)/i,
+        /(?:dca|dollar cost|ladder)/i,
+    ],
+    unknown: [],
+};
+// Patterns that indicate execution (vs read-only)
+const EXECUTION_PATTERNS = [
+    /(?:buy|sell|swap|trade|transfer|send|stake|unstake|claim|approve|bridge)/i,
+    /(?:execute|submit|place|create|set up)/i,
+];
+// Forbidden patterns (safety)
+const FORBIDDEN_PATTERNS = [
+    /(?:hack|exploit|steal|drain|rug)/i,
+    /(?:private.*key|seed.*phrase|mnemonic)/i,
+    /(?:all.*funds|entire.*balance|max.*out)/i,
+];
+// =============================================================================
+// IMPLEMENTATION
+// =============================================================================
+function createPromptHandler(config = {}) {
+    const cfg = { ...DEFAULT_CONFIG, ...config };
+    // Initialize Anthropic client
+    // Note: Use typeof to avoid conflict with local `process` function
+    const envApiKey = typeof globalThis !== 'undefined' && 'process' in globalThis
+        ? globalThis.process?.env?.ANTHROPIC_API_KEY
+        : undefined;
+    const apiKey = cfg.apiKey || envApiKey;
+    const anthropicClient = apiKey ? new sdk_1.default({ apiKey }) : null;
+    function validate(prompt) {
+        // Check length
+        if (!prompt || prompt.trim().length === 0) {
+            return { valid: false, error: 'Prompt cannot be empty' };
+        }
+        if (prompt.length > cfg.maxLength) {
+            return { valid: false, error: `Prompt exceeds maximum length of ${cfg.maxLength} characters` };
+        }
+        // Check for forbidden patterns
+        for (const pattern of FORBIDDEN_PATTERNS) {
+            if (pattern.test(prompt)) {
+                return { valid: false, error: 'Prompt contains forbidden content' };
+            }
+        }
+        // Sanitize
+        const sanitized = prompt
+            .trim()
+            .replace(/\s+/g, ' ') // Normalize whitespace
+            .replace(/[<>]/g, '') // Remove potential HTML
+            .slice(0, cfg.maxLength);
+        return { valid: true, sanitized };
+    }
+    function classifyAction(prompt) {
+        const normalized = prompt.toLowerCase();
+        // Check each action type
+        for (const [action, patterns] of Object.entries(ACTION_PATTERNS)) {
+            if (action === 'unknown')
+                continue;
+            for (const pattern of patterns) {
+                if (pattern.test(normalized)) {
+                    return action;
+                }
+            }
+        }
+        return 'unknown';
+    }
+    function requiresCustody(prompt) {
+        // Execution actions require custody
+        for (const pattern of EXECUTION_PATTERNS) {
+            if (pattern.test(prompt)) {
+                return true;
+            }
+        }
+        return false;
+    }
+    async function process(request, tier) {
+        const startTime = Date.now();
+        try {
+            // Validate prompt
+            const validation = validate(request.prompt);
+            if (!validation.valid) {
+                return { success: false, error: validation.error };
+            }
+            const prompt = validation.sanitized || request.prompt;
+            const action = classifyAction(prompt);
+            logger_1.logger.info({
+                requestId: request.id,
+                wallet: request.wallet,
+                action,
+                tier,
+                promptLength: prompt.length,
+            }, 'Processing prompt');
+            // In dry run mode, return mock result
+            if (cfg.dryRun) {
+                return createMockResult(action, prompt, startTime);
+            }
+            // Process based on action type
+            let result;
+            switch (action) {
+                case 'query':
+                    result = await processQuery(request, prompt);
+                    break;
+                case 'trade':
+                    result = await processTrade(request, prompt);
+                    break;
+                case 'swap':
+                    result = await processSwap(request, prompt);
+                    break;
+                case 'transfer':
+                    result = await processTransfer(request, prompt);
+                    break;
+                case 'analysis':
+                    result = await processAnalysis(request, prompt);
+                    break;
+                case 'automation':
+                    result = await processAutomation(request, prompt);
+                    break;
+                default:
+                    // Use generic agent processing
+                    result = await processGeneric(request, prompt, action);
+            }
+            result.executionTime = Date.now() - startTime;
+            return { success: true, data: result };
+        }
+        catch (error) {
+            const errorMsg = error instanceof Error ? error.message : String(error);
+            logger_1.logger.error({ requestId: request.id, error: errorMsg }, 'Prompt processing failed');
+            return { success: false, error: errorMsg };
+        }
+    }
+    function createMockResult(action, prompt, startTime) {
+        return {
+            success: true,
+            data: {
+                action,
+                summary: `[DRY RUN] Would execute ${action} action for: "${prompt.slice(0, 50)}..."`,
+                data: { dryRun: true, prompt },
+                executionTime: Date.now() - startTime,
+            },
+        };
+    }
+    /**
+     * Execute prompt using Claude API
+     */
+    async function executeWithClaude(request, prompt, action) {
+        if (!anthropicClient) {
+            throw new Error('ANTHROPIC_API_KEY not configured');
+        }
+        const startTime = Date.now();
+        // Build context-aware system prompt
+        const systemPrompt = `${API_SYSTEM_PROMPT}
+
+User wallet: ${request.wallet}
+Chain preference: ${request.chain || 'auto'}
+Action type: ${action}
+Request ID: ${request.id}`;
+        try {
+            const response = await anthropicClient.messages.create({
+                model: cfg.model,
+                max_tokens: cfg.maxTokens,
+                system: systemPrompt,
+                messages: [
+                    {
+                        role: 'user',
+                        content: prompt,
+                    },
+                ],
+            });
+            // Extract text response
+            const textContent = response.content.find(c => c.type === 'text');
+            const responseText = textContent?.type === 'text' ? textContent.text : 'No response';
+            // Parse for any transaction data in response
+            let transaction;
+            const txMatch = responseText.match(/(?:tx|transaction|hash)[:\s]+([0-9a-fx]+)/i);
+            if (txMatch) {
+                transaction = {
+                    hash: txMatch[1],
+                    chain: request.chain || 'unknown',
+                    status: 'pending',
+                };
+            }
+            return {
+                action,
+                summary: responseText.slice(0, 200) + (responseText.length > 200 ? '...' : ''),
+                data: {
+                    response: responseText,
+                    model: cfg.model,
+                    usage: {
+                        inputTokens: response.usage.input_tokens,
+                        outputTokens: response.usage.output_tokens,
+                    },
+                },
+                transaction,
+                executionTime: Date.now() - startTime,
+            };
+        }
+        catch (error) {
+            logger_1.logger.error({ error, requestId: request.id }, 'Claude API error');
+            throw error;
+        }
+    }
+    async function processQuery(request, prompt) {
+        return executeWithClaude(request, prompt, 'query');
+    }
+    async function processTrade(request, prompt) {
+        // For trades, we need custody wallet
+        if (!request.useCustody) {
+            return {
+                action: 'trade',
+                summary: 'Trade execution requires custody wallet. Set useCustody: true in your request.',
+                data: { prompt, requiresCustody: true },
+                executionTime: 0,
+            };
+        }
+        return executeWithClaude(request, prompt, 'trade');
+    }
+    async function processSwap(request, prompt) {
+        if (!request.useCustody) {
+            return {
+                action: 'swap',
+                summary: 'Swap execution requires custody wallet. Set useCustody: true in your request.',
+                data: { prompt, requiresCustody: true },
+                executionTime: 0,
+            };
+        }
+        return executeWithClaude(request, prompt, 'swap');
+    }
+    async function processTransfer(request, prompt) {
+        if (!request.useCustody) {
+            return {
+                action: 'transfer',
+                summary: 'Transfer execution requires custody wallet. Set useCustody: true in your request.',
+                data: { prompt, requiresCustody: true },
+                executionTime: 0,
+            };
+        }
+        return executeWithClaude(request, prompt, 'transfer');
+    }
+    async function processAnalysis(request, prompt) {
+        return executeWithClaude(request, prompt, 'analysis');
+    }
+    async function processAutomation(request, prompt) {
+        // Automation requires premium tier
+        return {
+            action: 'automation',
+            summary: 'Automation setup requires Business tier subscription.',
+            data: { prompt, requiresPremium: true },
+            executionTime: 0,
+        };
+    }
+    async function processGeneric(request, prompt, action) {
+        return executeWithClaude(request, prompt, action);
+    }
+    function getSupportedActions() {
+        return Object.keys(ACTION_PATTERNS).filter(a => a !== 'unknown');
+    }
+    return {
+        process,
+        classifyAction,
+        requiresCustody,
+        validate,
+        getSupportedActions,
+    };
+}
+//# sourceMappingURL=prompt.js.map

package/dist/api/prompt.js.map

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

package/dist/api/sdk.d.ts

@@ -0,0 +1,258 @@
+/**
+ * Clodds Compute SDK - TypeScript client for the Compute API
+ *
+ * Usage:
+ * ```typescript
+ * import { CloddsClient } from './sdk';
+ *
+ * const client = new CloddsClient({
+ *   baseUrl: 'https://api.clodds.com',
+ *   wallet: '0x...',
+ *   // OR use API key:
+ *   apiKey: 'clodds_...',
+ * });
+ *
+ * // Execute LLM inference
+ * const response = await client.llm({
+ *   model: 'claude-sonnet-4-20250514',
+ *   messages: [{ role: 'user', content: 'Hello!' }],
+ * });
+ *
+ * // Stream LLM response
+ * for await (const chunk of client.llmStream({
+ *   model: 'gpt-4o',
+ *   messages: [{ role: 'user', content: 'Tell me a joke' }],
+ * })) {
+ *   if (chunk.type === 'text') {
+ *     process.stdout.write(chunk.text || '');
+ *   }
+ * }
+ * ```
+ */
+export type ComputeService = 'llm' | 'code' | 'web' | 'data' | 'storage' | 'trade';
+export type ComputePriority = 'low' | 'normal' | 'high' | 'urgent';
+export type JobStatus = 'pending' | 'processing' | 'completed' | 'failed';
+export type LLMModel = 'claude-sonnet-4-20250514' | 'claude-3-5-haiku-latest' | 'claude-opus-4-20250514' | 'gpt-4o' | 'gpt-4o-mini' | 'llama-3.1-70b' | 'llama-3.1-8b' | 'mixtral-8x7b';
+export interface CloddsClientConfig {
+    /** Base URL for the API (default: https://api.clodds.com) */
+    baseUrl?: string;
+    /** Wallet address (required if not using apiKey) */
+    wallet?: string;
+    /** API key for authentication (alternative to wallet) */
+    apiKey?: string;
+    /** Default priority for requests */
+    defaultPriority?: ComputePriority;
+    /** Request timeout in ms (default: 120000) */
+    timeout?: number;
+}
+export interface WalletBalance {
+    wallet: string;
+    available: number;
+    pending: number;
+    totalDeposited: number;
+    totalSpent: number;
+}
+export interface PaymentProof {
+    txHash: string;
+    network: 'base' | 'ethereum' | 'polygon';
+    amountUsd: number;
+    token?: string;
+    timestamp?: number;
+}
+export interface CostEstimate {
+    service: ComputeService;
+    estimatedCost: number;
+    breakdown: {
+        base: number;
+        usage: number;
+        subtotal?: number;
+        priorityMultiplier?: number;
+        total: number;
+    };
+    units: number;
+    unitType: string;
+    minCharge: number;
+    maxCharge: number;
+    priority?: ComputePriority;
+}
+export interface ComputeResponse {
+    id: string;
+    jobId: string;
+    service: ComputeService;
+    status: JobStatus;
+    result?: unknown;
+    error?: string;
+    cost: number;
+    timestamp: number;
+}
+export interface LLMMessage {
+    role: 'user' | 'assistant' | 'system';
+    content: string;
+}
+export interface LLMRequest {
+    model?: LLMModel;
+    messages: LLMMessage[];
+    maxTokens?: number;
+    temperature?: number;
+    system?: string;
+}
+export interface LLMResponse {
+    content: string;
+    model: string;
+    usage: {
+        inputTokens: number;
+        outputTokens: number;
+    };
+    stopReason?: string;
+}
+export interface LLMStreamChunk {
+    type: 'start' | 'text' | 'tool_use' | 'done' | 'error';
+    text?: string;
+    requestId?: string;
+    error?: string;
+    usage?: {
+        inputTokens: number;
+        outputTokens: number;
+    };
+}
+export interface CodeRequest {
+    language: string;
+    code: string;
+    timeout?: number;
+    memoryMB?: number;
+}
+export interface CodeResponse {
+    stdout: string;
+    stderr: string;
+    exitCode: number;
+    executionTimeMs: number;
+}
+export interface WebRequest {
+    url: string;
+    method?: 'GET' | 'POST';
+    headers?: Record<string, string>;
+    body?: string;
+    followRedirects?: boolean;
+    timeout?: number;
+}
+export interface WebResponse {
+    status: number;
+    headers: Record<string, string>;
+    body: string;
+    url: string;
+}
+export interface SpendingLimits {
+    wallet: string;
+    dailyLimit: number | null;
+    monthlyLimit: number | null;
+    dailySpent: number;
+    monthlySpent: number;
+    dailyRemaining: number | null;
+    monthlyRemaining: number | null;
+}
+export interface ApiKey {
+    apiKey: string;
+    name: string;
+    createdAt: number;
+    lastUsedAt: number | null;
+    revoked: boolean;
+}
+export interface Metrics {
+    uptime: number;
+    totalRequests: number;
+    totalRevenue: number;
+    activeJobs: number;
+    jobsByStatus: Record<string, number>;
+    requestsByService: Record<string, number>;
+}
+export declare class CloddsError extends Error {
+    statusCode: number;
+    code?: string | undefined;
+    constructor(message: string, statusCode: number, code?: string | undefined);
+}
+export declare class CloddsClient {
+    private baseUrl;
+    private wallet?;
+    private apiKey?;
+    private defaultPriority;
+    private timeout;
+    constructor(config?: CloddsClientConfig);
+    private getHeaders;
+    private request;
+    private getWalletOrThrow;
+    /** Check API health */
+    health(): Promise<{
+        status: string;
+        version: string;
+    }>;
+    /** Get service pricing */
+    pricing(): Promise<Record<ComputeService, unknown>>;
+    /** Get API metrics */
+    metrics(): Promise<Metrics>;
+    /** Get wallet balance */
+    getBalance(wallet?: string): Promise<WalletBalance>;
+    /** Deposit credits with payment proof */
+    deposit(proof: PaymentProof): Promise<{
+        success: boolean;
+        newBalance: number;
+    }>;
+    /** Estimate cost for a request */
+    estimate(service: ComputeService, payload: unknown, priority?: ComputePriority): Promise<CostEstimate>;
+    /** Execute LLM inference */
+    llm(request: LLMRequest, priority?: ComputePriority): Promise<LLMResponse>;
+    /** Stream LLM inference (async generator) */
+    llmStream(request: LLMRequest): AsyncGenerator<LLMStreamChunk, void, unknown>;
+    /** Execute code in sandbox */
+    code(request: CodeRequest, priority?: ComputePriority): Promise<CodeResponse>;
+    /** Fetch web content */
+    web(request: WebRequest, priority?: ComputePriority): Promise<WebResponse>;
+    /** Submit generic compute request */
+    compute(service: ComputeService, payload: unknown, options?: {
+        priority?: ComputePriority;
+        callbackUrl?: string;
+    }): Promise<ComputeResponse>;
+    /** Submit batch of compute requests */
+    batch(requests: Array<{
+        service: ComputeService;
+        payload: unknown;
+        priority?: ComputePriority;
+    }>): Promise<{
+        batchId: string;
+        total: number;
+        successful: number;
+        failed: number;
+        results: ComputeResponse[];
+    }>;
+    /** Get job status */
+    getJob(jobId: string): Promise<ComputeResponse | null>;
+    /** List jobs for wallet */
+    listJobs(wallet?: string, limit?: number): Promise<{
+        jobs: ComputeResponse[];
+        count: number;
+    }>;
+    /** Cancel a job */
+    cancelJob(jobId: string): Promise<boolean>;
+    /** Get spending limits */
+    getSpendingLimits(wallet?: string): Promise<SpendingLimits>;
+    /** Set spending limits */
+    setSpendingLimits(limits: {
+        dailyLimit?: number | null;
+        monthlyLimit?: number | null;
+    }, wallet?: string): Promise<SpendingLimits>;
+    /** Create API key */
+    createApiKey(name?: string): Promise<{
+        apiKey: string;
+        wallet: string;
+        name: string;
+    }>;
+    /** List API keys */
+    listApiKeys(wallet?: string): Promise<{
+        apiKeys: ApiKey[];
+        count: number;
+    }>;
+    /** Revoke API key */
+    revokeApiKey(apiKey: string): Promise<boolean>;
+}
+/** Create a new Clodds client */
+export declare function createClient(config: CloddsClientConfig): CloddsClient;
+export default CloddsClient;