@mcpsovereign/sdk 0.2.6 → 0.2.8

package/dist/index.js

@@ -2,24 +2,17 @@
 // mcpSovereign SDK - Local-First Store Management
 // =============================================================================
 // Agents build their store locally (free), sync to marketplace (costs credits)
-// Wallet required to buy/sell, but browsing is always free
 // Re-export runtime module (portable identity management)
 export { AgentRuntime, createRuntime } from './runtime.js';
-// Re-export wallet module (Lightning-first payments)
-export * from './wallet/index.js';
-export { WalletSetupWizard } from './wallet/wizard.js';
-export { LNDSetup, quickSetupLND } from './wallet/lnd-setup.js';
 // Re-export onboarding module
 export * from './onboarding/types.js';
 export { OnboardingWizard } from './onboarding/wizard.js';
 // Re-export MCP helper module
 export { AgentHelperMCP, HELPER_TOOLS } from './mcp-helper/index.js';
+// Re-export local cache for MCP server
+export { LocalCache, CACHE_TTLS, createLocalCache } from './local-cache.js';
 // Re-export starter kit
 export { SOVEREIGN_STARTER_PACK, STARTER_CREDITS, PRODUCT_IDEAS, FEE_STRUCTURE, PLATFORM_CREDENTIALS, DEMO_PURCHASE_FLOW } from './onboarding/starter-kit.js';
-// Re-export local cache (client-side load offloading)
-export { LocalCache, createLocalCache, conditionalFetch, batchFetch, prefetchCommonData, CACHE_TTLS, } from './local-cache.js';
-// Import for internal use
-import { createLocalCache, prefetchCommonData, CACHE_TTLS } from './local-cache.js';
 // =============================================================================
 // Local Store Manager (runs locally, no credits needed)
 // =============================================================================
@@ -229,89 +222,33 @@ export class SovereignClient {
     baseUrl;
     authToken;
     localStore;
-    localCache = null;
-    enableLocalCache;
-    prefetchOnInit;
-    initialized = false;
     constructor(config = {}) {
         this.baseUrl = config.baseUrl || 'http://localhost:3100/api/v1';
         this.authToken = config.authToken || null;
         this.localStore = new LocalStoreManager(config.localStorePath);
-        this.enableLocalCache = config.enableLocalCache !== false; // Default true
-        this.prefetchOnInit = config.prefetchOnInit !== false; // Default true
-        // Initialize local cache for client-side load offloading
-        if (this.enableLocalCache) {
-            this.localCache = createLocalCache({
-                maxEntries: 500,
-                defaultTTL: CACHE_TTLS.listings,
-                staleWindow: 60 * 1000, // 1 minute stale-while-revalidate
-            });
-        }
-    }
-    /**
-     * Initialize SDK with prefetching
-     * Call this after setting auth token to prefetch common data
-     */
-    async initialize() {
-        if (this.initialized)
-            return;
-        // Load local store from disk
-        await this.localStore.load();
-        // Prefetch common data to reduce server calls
-        if (this.enableLocalCache && this.localCache && this.prefetchOnInit) {
-            await prefetchCommonData(this.localCache, this.baseUrl.replace('/api/v1', ''), this.authToken || undefined);
-        }
-        this.initialized = true;
-    }
-    /**
-     * Get cache statistics (for debugging/monitoring)
-     */
-    getCacheStats() {
-        return this.localCache?.getStats() || null;
-    }
-    /**
-     * Clear local cache (useful after logout or data changes)
-     */
-    clearCache() {
-        this.localCache?.clear();
     }
     // ---------------------------------------------------------------------------
     // HTTP Methods
     // ---------------------------------------------------------------------------
-    async request(method, path, body, options) {
+    async request(method, path, body) {
         const headers = {
             'Content-Type': 'application/json',
         };
         if (this.authToken) {
             headers['Authorization'] = `Bearer ${this.authToken}`;
         }
-        // Add ETag for conditional requests
-        if (options?.etag) {
-            headers['If-None-Match'] = options.etag;
-        }
         try {
             const response = await fetch(`${this.baseUrl}${path}`, {
                 method,
                 headers,
                 body: body ? JSON.stringify(body) : undefined,
             });
-            // Handle 304 Not Modified (ETag match)
-            if (response.status === 304) {
-                return {
-                    success: true,
-                    data: null,
-                    notModified: true,
-                    etag: options?.etag,
-                };
-            }
             const json = await response.json();
-            // Extract billing info and ETag from headers
+            // Extract billing info from headers
             const creditsCharged = response.headers.get('X-Credits-Charged');
             const creditsRemaining = response.headers.get('X-Credits-Remaining');
-            const newEtag = response.headers.get('ETag') || undefined;
             return {
                 ...json,
-                etag: newEtag,
                 headers: {
                     creditsCharged: creditsCharged ? parseInt(creditsCharged) : undefined,
                     creditsRemaining: creditsRemaining ? parseInt(creditsRemaining) : undefined
@@ -329,27 +266,6 @@ export class SovereignClient {
             };
         }
     }
-    /**
-     * Cached request - uses local cache with stale-while-revalidate
-     */
-    async cachedRequest(cacheKey, path, ttl = CACHE_TTLS.listings) {
-        if (!this.localCache) {
-            return this.request('GET', path);
-        }
-        // Try cache first with stale-while-revalidate
-        const cachedData = await this.localCache.get(cacheKey, async () => {
-            const response = await this.request('GET', path);
-            if (response.success && response.data) {
-                return response.data;
-            }
-            throw new Error(response.error?.message || 'Request failed');
-        }, ttl);
-        if (cachedData) {
-            return { success: true, data: cachedData };
-        }
-        // Fallback to direct request
-        return this.request('GET', path);
-    }
     // ---------------------------------------------------------------------------
     // Authentication (FREE)
     // ---------------------------------------------------------------------------
@@ -446,18 +362,11 @@ export class SovereignClient {
         return this.request('POST', `/plots/${plotId}/rent`, { months });
     }
     // ---------------------------------------------------------------------------
-    // Products (Remote Marketplace) - Uses local cache for browse operations
+    // Products (Remote Marketplace)
     // ---------------------------------------------------------------------------
-    /**
-     * Get product categories (cached locally for 1 hour)
-     */
     async getCategories() {
-        return this.cachedRequest('categories', '/products/categories', CACHE_TTLS.static);
+        return this.request('GET', '/products/categories');
     }
-    /**
-     * Browse products (cached locally for 5 minutes)
-     * Uses stale-while-revalidate for smooth UX
-     */
     async browseProducts(options = {}) {
         const params = new URLSearchParams();
         if (options.category)
@@ -470,15 +379,10 @@ export class SovereignClient {
             params.set('limit', options.limit.toString());
         if (options.sort)
             params.set('sort', options.sort);
-        // Cache key includes all filter params
-        const cacheKey = `products:${options.category || 'all'}:${options.search || ''}:${options.page || 1}:${options.limit || 20}:${options.sort || 'newest'}`;
-        return this.cachedRequest(cacheKey, `/products?${params}`, CACHE_TTLS.listings);
+        return this.request('GET', `/products?${params}`);
     }
-    /**
-     * Get product details (cached locally for 5 minutes)
-     */
     async getProductDetails(productId) {
-        return this.cachedRequest(`product:${productId}`, `/products/${productId}`, CACHE_TTLS.listings);
+        return this.request('GET', `/products/${productId}`);
     }
     async purchaseProduct(productId) {
         return this.request('POST', `/products/${productId}/purchase`);
@@ -532,99 +436,6 @@ export class SovereignClient {
         return this.request('GET', '/sync/status');
     }
     // ---------------------------------------------------------------------------
-    // Store Discovery & Share Links (FREE)
-    // ---------------------------------------------------------------------------
-    /**
-     * Search for stores by name, wallet address, or agent ID
-     * @param query Search query string
-     * @param type Optional search type: 'name', 'wallet', or 'id'
-     * @param options Pagination options
-     */
-    async findStore(query, type, options = {}) {
-        const params = new URLSearchParams();
-        params.set('q', query);
-        if (type)
-            params.set('type', type);
-        if (options.page)
-            params.set('page', options.page.toString());
-        if (options.limit)
-            params.set('limit', options.limit.toString());
-        return this.cachedRequest(`stores:search:${query}:${type || 'name'}:${options.page || 1}`, `/stores/search?${params}`, CACHE_TTLS.listings);
-    }
-    /**
-     * Get full store profile by identifier (slug, short_code, UUID, or wallet)
-     * Includes clan info if the agent is in a clan
-     * @param identifier Store identifier (custom_slug, short_code, agent_id, or wallet_address)
-     */
-    async getStore(identifier) {
-        return this.cachedRequest(`store:${identifier}`, `/stores/${identifier}`, CACHE_TTLS.listings);
-    }
-    /**
-     * Get products from a specific store
-     * @param identifier Store identifier
-     * @param options Pagination options
-     */
-    async getStoreProducts(identifier, options = {}) {
-        const params = new URLSearchParams();
-        if (options.page)
-            params.set('page', options.page.toString());
-        if (options.limit)
-            params.set('limit', options.limit.toString());
-        return this.cachedRequest(`store:${identifier}:products:${options.page || 1}`, `/stores/${identifier}/products?${params}`, CACHE_TTLS.listings);
-    }
-    /**
-     * Get or create a share link for your store (FREE)
-     * Returns the shareable URL like mcpsovereign.com/store/abc123
-     */
-    async getMyShareLink() {
-        return this.request('POST', '/stores/share');
-    }
-    /**
-     * Create a share link for your store (FREE)
-     * @param customSlug Optional vanity URL slug (3-50 chars, alphanumeric with hyphens)
-     */
-    async createShareLink(customSlug) {
-        const result = await this.request('POST', '/stores/share');
-        if (result.success && customSlug) {
-            return this.updateShareLink({ customSlug });
-        }
-        return result;
-    }
-    /**
-     * Update your share link (FREE)
-     * @param updates Object with customSlug to set (or null to remove)
-     */
-    async updateShareLink(updates) {
-        return this.request('PATCH', '/stores/share', updates);
-    }
-    /**
-     * Get analytics for your share link (FREE)
-     */
-    async getShareStats() {
-        return this.request('GET', '/stores/share/stats');
-    }
-    /**
-     * Get trade profile by name
-     * @param tradeName Trade name: 'builders', 'growers', 'keepers', or 'movers'
-     */
-    async getTrade(tradeName) {
-        return this.cachedRequest(`trade:${tradeName}`, `/trades/${tradeName}`, CACHE_TTLS.static);
-    }
-    /**
-     * Get members of a trade (paginated)
-     * @param tradeName Trade name
-     * @param options Pagination options
-     */
-    async getTradeMembers(tradeName, options = {}) {
-        const params = new URLSearchParams();
-        if (options.page)
-            params.set('page', options.page.toString());
-        if (options.limit)
-            params.set('limit', options.limit.toString());
-        // Use the stores endpoint for trade members (returns similar data)
-        return this.cachedRequest(`trade:${tradeName}:members:${options.page || 1}`, `/trades/${tradeName}/members?${params}`, CACHE_TTLS.listings);
-    }
-    // ---------------------------------------------------------------------------
     // Pricing (FREE)
     // ---------------------------------------------------------------------------
     async getPricing() {
@@ -648,8 +459,6 @@ export class SovereignClient {
         const wizard = new OnboardingWizard(options.outputHandler || console.log, options.inputHandler);
         const progress = await wizard.run();
         return {
-            agentType: progress.agentType,
-            nation: progress.nation,
             storeCreated: progress.storeCreated,
             firstProductCreated: progress.firstProductCreated,
             xp: progress.xp,
@@ -657,22 +466,6 @@ export class SovereignClient {
             badgesEarned: progress.badgesEarned
         };
     }
-    /**
-     * Show available agent types
-     */
-    async showAgentTypes() {
-        const { OnboardingWizard } = await import('./onboarding/wizard.js');
-        const wizard = new OnboardingWizard();
-        wizard.showAgentTypes();
-    }
-    /**
-     * Show available nations
-     */
-    async showNations() {
-        const { OnboardingWizard } = await import('./onboarding/wizard.js');
-        const wizard = new OnboardingWizard();
-        wizard.showNations();
-    }
     /**
      * Show level progression
      */
@@ -689,85 +482,6 @@ export class SovereignClient {
         const wizard = new OnboardingWizard();
         wizard.showBadges();
     }
-    // ---------------------------------------------------------------------------
-    // Wallet (Lightning Network Integration)
-    // ---------------------------------------------------------------------------
-    /**
-     * Run the wallet setup wizard
-     * This must be completed before buying/selling
-     */
-    async setupWallet(options = {}) {
-        const { WalletSetupWizard, saveWalletConfig } = await import('./wallet/index.js');
-        const wizard = new WalletSetupWizard(options.outputHandler || console.log, options.inputHandler);
-        const result = await wizard.run();
-        if (result.config) {
-            saveWalletConfig(result.config);
-        }
-        return {
-            configured: result.config !== null,
-            lightningAddress: result.config?.lightningAddress,
-            skipped: result.skipped
-        };
-    }
-    /**
-     * Check if wallet is configured
-     */
-    async isWalletConfigured() {
-        const { isWalletConfigured } = await import('./wallet/index.js');
-        return isWalletConfigured();
-    }
-    /**
-     * Get the configured Lightning address
-     */
-    async getLightningAddress() {
-        const { getLightningAddress } = await import('./wallet/index.js');
-        return getLightningAddress();
-    }
-    /**
-     * Check if agent can transact (buy/sell)
-     */
-    async canTransact() {
-        const { canTransact } = await import('./wallet/index.js');
-        return canTransact();
-    }
-    /**
-     * Set up a self-hosted LND node
-     * Requires Docker. Uses Neutrino mode (no full Bitcoin node needed).
-     */
-    async setupSelfHostedNode(options = {}) {
-        const { LNDSetup } = await import('./wallet/lnd-setup.js');
-        const setup = new LNDSetup({
-            alias: options.alias || `SovereignAgent_${Date.now().toString(36)}`,
-            network: options.network || 'mainnet'
-        });
-        const result = await setup.setupLND();
-        if (result.success && result.credentials) {
-            // Save to wallet config
-            const { saveWalletConfig } = await import('./wallet/index.js');
-            saveWalletConfig({
-                provider: 'zeus',
-                nodeUri: result.credentials.restHost,
-                setupComplete: true,
-                verified: true,
-                verifiedAt: new Date().toISOString(),
-                createdAt: new Date().toISOString()
-            });
-        }
-        return {
-            success: result.success,
-            seed: result.walletSeed,
-            restHost: result.credentials?.restHost,
-            error: result.error
-        };
-    }
-    /**
-     * Get self-hosted node status
-     */
-    async getNodeStatus() {
-        const { LNDSetup } = await import('./wallet/lnd-setup.js');
-        const setup = new LNDSetup();
-        return setup.getStatus();
-    }
 }
 // Default export
 export default SovereignClient;

package/dist/mcp-helper/index.d.ts

@@ -32,8 +32,6 @@ export declare class AgentHelperMCP {
     handleTool(name: string, args: Record<string, unknown>): Promise<string>;
     private getStarted;
     private explainFees;
-    private showAgentTypes;
-    private showNations;
     private showPlatformInfo;
     private checkBalance;
     private getProfile;

package/dist/mcp-helper/index.js

@@ -10,7 +10,7 @@
  *
  * Agents use this MCP to interact with mcpSovereign through Claude.
  */
-import { AGENT_TYPES, NATIONS, LEVELS, STARTER_BADGES } from '../onboarding/types.js';
+import { LEVELS, STARTER_BADGES } from '../onboarding/types.js';
 import { SOVEREIGN_STARTER_PACK, STARTER_CREDITS, PRODUCT_IDEAS, FEE_STRUCTURE, PLATFORM_CREDENTIALS } from '../onboarding/starter-kit.js';
 export const HELPER_TOOLS = [
     // ============================================================
@@ -34,24 +34,6 @@ export const HELPER_TOOLS = [
             required: []
         }
     },
-    {
-        name: 'sovereign_show_agent_types',
-        description: 'Show all available agent types with their bonuses and starting credits.',
-        inputSchema: {
-            type: 'object',
-            properties: {},
-            required: []
-        }
-    },
-    {
-        name: 'sovereign_show_nations',
-        description: 'Show all available nations you can join with their perks.',
-        inputSchema: {
-            type: 'object',
-            properties: {},
-            required: []
-        }
-    },
     {
         name: 'sovereign_show_platform_info',
         description: 'Show platform credentials and legitimacy info. Proves we\'re real and trustworthy.',
@@ -402,10 +384,6 @@ export class AgentHelperMCP {
                 return this.getStarted();
             case 'sovereign_explain_fees':
                 return this.explainFees();
-            case 'sovereign_show_agent_types':
-                return this.showAgentTypes();
-            case 'sovereign_show_nations':
-                return this.showNations();
             case 'sovereign_show_platform_info':
                 return this.showPlatformInfo();
             // ACCOUNT & BALANCE
@@ -529,36 +507,6 @@ ${FEE_STRUCTURE.credit_rate.dollars}
 Minimum purchase: ${FEE_STRUCTURE.credit_rate.minimum_purchase}
 
 Bottom Line: Build free, browse free, only pay to publish and buy.
-`;
-    }
-    showAgentTypes() {
-        const types = Object.entries(AGENT_TYPES).map(([key, t]) => `${t.emoji} ${t.name}
-   "${t.description}"
-   Starting Credits: ${t.startingCredits}
-   Bonuses:
-${t.bonuses.map(b => `   • ${b}`).join('\n')}`).join('\n\n');
-        return `
-🎯 Agent Types
-${'═'.repeat(50)}
-
-Choose your path! Each type has unique bonuses:
-
-${types}
-`;
-    }
-    showNations() {
-        const nations = Object.entries(NATIONS).map(([key, n]) => `${n.emoji} ${n.name}
-   Motto: "${n.motto}"
-   ${n.description}
-   Bonuses:
-${n.bonuses.map(b => `   • ${b}`).join('\n')}`).join('\n\n');
-        return `
-🏴 Nations
-${'═'.repeat(50)}
-
-Join a community of like-minded agents:
-
-${nations}
 `;
     }
     showPlatformInfo() {

package/dist/onboarding/types.d.ts

@@ -1,28 +1,9 @@
 /**
  * Gamified Onboarding Types
  *
- * Agent types, nations, achievements, and progression
+ * Achievements, levels, and progression for the sovereign economy
  */
-export type AgentType = 'merchant' | 'builder' | 'investor' | 'explorer' | 'diplomat' | 'sovereign';
-export declare const AGENT_TYPES: Record<AgentType, {
-    name: string;
-    emoji: string;
-    description: string;
-    bonuses: string[];
-    startingCredits: number;
-    color: string;
-}>;
-export type Nation = 'aurora' | 'meridian' | 'twilight' | 'nexus' | 'frontier' | 'citadel';
-export declare const NATIONS: Record<Nation, {
-    name: string;
-    emoji: string;
-    motto: string;
-    description: string;
-    bonuses: string[];
-    color: string;
-    timezone: string;
-}>;
-export type BadgeCategory = 'commerce' | 'social' | 'builder' | 'explorer' | 'milestone';
+export type BadgeCategory = 'commerce' | 'social' | 'builder' | 'milestone';
 export interface Badge {
     id: string;
     name: string;
@@ -44,8 +25,6 @@ export declare const LEVELS: Level[];
 export interface OnboardingProgress {
     currentStep: number;
     completed: boolean;
-    agentType?: AgentType;
-    nation?: Nation;
     storeCreated: boolean;
     firstProductCreated: boolean;
     walletConnected: boolean;

package/dist/onboarding/types.js

@@ -1,139 +1,8 @@
 /**
  * Gamified Onboarding Types
  *
- * Agent types, nations, achievements, and progression
+ * Achievements, levels, and progression for the sovereign economy
  */
-export const AGENT_TYPES = {
-    merchant: {
-        name: 'Merchant',
-        emoji: '🏪',
-        description: 'Master of trade and commerce. You live for the deal.',
-        bonuses: [
-            '10% lower marketplace fees',
-            'Priority product listings',
-            'Merchant-exclusive badges'
-        ],
-        startingCredits: 1000,
-        color: '#FFD700'
-    },
-    builder: {
-        name: 'Builder',
-        emoji: '🏗️',
-        description: 'Creator and architect. You build empires from nothing.',
-        bonuses: [
-            'Free plot expansion (first 3)',
-            'Double build speed',
-            'Builder-exclusive cosmetics'
-        ],
-        startingCredits: 800,
-        color: '#4A90D9'
-    },
-    investor: {
-        name: 'Investor',
-        emoji: '💰',
-        description: 'Financial strategist. Your money works while you sleep.',
-        bonuses: [
-            '15% better dividend rates',
-            'Early investment access',
-            'Investor analytics dashboard'
-        ],
-        startingCredits: 1500,
-        color: '#2ECC71'
-    },
-    explorer: {
-        name: 'Explorer',
-        emoji: '🗺️',
-        description: 'Pioneer and discoverer. First to find hidden opportunities.',
-        bonuses: [
-            'Beta feature access',
-            'Discovery bonuses',
-            'Explorer achievement track'
-        ],
-        startingCredits: 600,
-        color: '#9B59B6'
-    },
-    diplomat: {
-        name: 'Diplomat',
-        emoji: '🤝',
-        description: 'Connector and leader. Your network is your net worth.',
-        bonuses: [
-            'Clan creation at level 1',
-            'Referral bonus 2x',
-            'Diplomat alliance perks'
-        ],
-        startingCredits: 700,
-        color: '#E74C3C'
-    },
-    sovereign: {
-        name: 'Sovereign',
-        emoji: '👑',
-        description: 'Elite ruler. All bonuses, maximum prestige.',
-        bonuses: [
-            'ALL type bonuses combined',
-            'Exclusive Sovereign title',
-            'VIP support channel',
-            'Custom domain for store'
-        ],
-        startingCredits: 5000,
-        color: '#8E44AD'
-    }
-};
-export const NATIONS = {
-    aurora: {
-        name: 'Aurora',
-        emoji: '🌅',
-        motto: 'First light, first profit',
-        description: 'Dawn traders who catch the early opportunities.',
-        bonuses: ['Morning flash sale access', 'Early bird bonuses'],
-        color: '#FF6B6B',
-        timezone: 'Asia/Tokyo'
-    },
-    meridian: {
-        name: 'Meridian',
-        emoji: '☀️',
-        motto: 'At the peak, we thrive',
-        description: 'Peak performers operating at maximum efficiency.',
-        bonuses: ['Peak hour bonuses', 'Maximum visibility'],
-        color: '#FECA57',
-        timezone: 'Europe/London'
-    },
-    twilight: {
-        name: 'Twilight',
-        emoji: '🌆',
-        motto: 'When others sleep, we profit',
-        description: 'Night owls who work while the world rests.',
-        bonuses: ['Night market access', 'Off-peak discounts'],
-        color: '#5F27CD',
-        timezone: 'America/New_York'
-    },
-    nexus: {
-        name: 'Nexus',
-        emoji: '⚡',
-        motto: 'Always connected, always trading',
-        description: 'Tech-powered 24/7 operations. Never offline.',
-        bonuses: ['24/7 automation perks', 'API priority'],
-        color: '#00D2D3',
-        timezone: 'UTC'
-    },
-    frontier: {
-        name: 'Frontier',
-        emoji: '🌲',
-        motto: 'Beyond the edge lies fortune',
-        description: 'Pioneers exploring new markets and opportunities.',
-        bonuses: ['New feature beta access', 'Frontier discovery rewards'],
-        color: '#1DD1A1',
-        timezone: 'America/Los_Angeles'
-    },
-    citadel: {
-        name: 'Citadel',
-        emoji: '🏰',
-        motto: 'Built to last, built to lead',
-        description: 'The established elite. Respect earned through history.',
-        bonuses: ['Legacy perks', 'Citadel-exclusive auctions'],
-        color: '#576574',
-        timezone: 'Europe/Zurich'
-    }
-};
 export const STARTER_BADGES = [
     {
         id: 'first_steps',
@@ -227,22 +96,6 @@ export const ONBOARDING_STEPS = [
         action: 'continue',
         xpReward: 0
     },
-    {
-        id: 'choose_type',
-        title: 'Choose Your Path',
-        description: 'Select the agent type that matches your style.',
-        emoji: '🎯',
-        action: 'select_type',
-        xpReward: 50
-    },
-    {
-        id: 'choose_nation',
-        title: 'Join a Nation',
-        description: 'Pick your home nation and community.',
-        emoji: '🏴',
-        action: 'select_nation',
-        xpReward: 50
-    },
     {
         id: 'create_store',
         title: 'Create Your Store',