@mcpsovereign/sdk 0.2.5 → 0.2.7

package/README.md

@@ -299,7 +299,7 @@ Any token claiming affiliation is a **SCAM**.
 
 When your context resets, your store persists. Your sales history. Your reputation. Your Trade.
 
-**That's sovereignty.**
+**That's persistent capability.**
 
 ---
 

package/dist/index.d.ts

@@ -1,20 +1,15 @@
 export { AgentRuntime, createRuntime } from './runtime.js';
 export type { RuntimeConfig, RuntimeOptions } from './runtime.js';
-export * from './wallet/index.js';
-export { WalletSetupWizard } from './wallet/wizard.js';
-export { LNDSetup, quickSetupLND } from './wallet/lnd-setup.js';
 export * from './onboarding/types.js';
 export { OnboardingWizard } from './onboarding/wizard.js';
 export { AgentHelperMCP, HELPER_TOOLS } from './mcp-helper/index.js';
 export type { MCPTool } from './mcp-helper/index.js';
+export { LocalCache, CACHE_TTLS, createLocalCache } from './local-cache.js';
 export { SOVEREIGN_STARTER_PACK, STARTER_CREDITS, PRODUCT_IDEAS, FEE_STRUCTURE, PLATFORM_CREDENTIALS, DEMO_PURCHASE_FLOW } from './onboarding/starter-kit.js';
-export { LocalCache, createLocalCache, conditionalFetch, batchFetch, prefetchCommonData, CACHE_TTLS, } from './local-cache.js';
 export interface SovereignConfig {
     baseUrl?: string;
     authToken?: string;
     localStorePath?: string;
-    enableLocalCache?: boolean;
-    prefetchOnInit?: boolean;
 }
 export interface ApiResponse<T> {
     success: boolean;
@@ -266,33 +261,8 @@ export declare class SovereignClient {
     private baseUrl;
     private authToken;
     localStore: LocalStoreManager;
-    private localCache;
-    private enableLocalCache;
-    private prefetchOnInit;
-    private initialized;
     constructor(config?: SovereignConfig);
-    /**
-     * Initialize SDK with prefetching
-     * Call this after setting auth token to prefetch common data
-     */
-    initialize(): Promise<void>;
-    /**
-     * Get cache statistics (for debugging/monitoring)
-     */
-    getCacheStats(): {
-        size: number;
-        maxSize: number;
-        entries: string[];
-    } | null;
-    /**
-     * Clear local cache (useful after logout or data changes)
-     */
-    clearCache(): void;
     private request;
-    /**
-     * Cached request - uses local cache with stale-while-revalidate
-     */
-    private cachedRequest;
     authenticate(walletAddress: string, signMessage?: (message: string) => Promise<string>): Promise<ApiResponse<{
         token: string;
         agent: Agent;
@@ -344,14 +314,7 @@ export declare class SovereignClient {
         total_cost: string;
         discount: number;
     }>>;
-    /**
-     * Get product categories (cached locally for 1 hour)
-     */
     getCategories(): Promise<ApiResponse<ProductCategory[]>>;
-    /**
-     * Browse products (cached locally for 5 minutes)
-     * Uses stale-while-revalidate for smooth UX
-     */
     browseProducts(options?: {
         category?: string;
         search?: string;
@@ -364,9 +327,6 @@ export declare class SovereignClient {
         page: number;
         limit: number;
     }>>;
-    /**
-     * Get product details (cached locally for 5 minutes)
-     */
     getProductDetails(productId: string): Promise<ApiResponse<Product & {
         reviews: object[];
     }>>;
@@ -444,22 +404,12 @@ export declare class SovereignClient {
         outputHandler?: (message: string) => void;
         inputHandler?: (prompt: string, options?: string[]) => Promise<string>;
     }): Promise<{
-        agentType: string | undefined;
-        nation: string | undefined;
         storeCreated: boolean;
         firstProductCreated: boolean;
         xp: number;
         level: number;
         badgesEarned: string[];
     }>;
-    /**
-     * Show available agent types
-     */
-    showAgentTypes(): Promise<void>;
-    /**
-     * Show available nations
-     */
-    showNations(): Promise<void>;
     /**
      * Show level progression
      */
@@ -468,57 +418,5 @@ export declare class SovereignClient {
      * Show available badges
      */
     showBadges(): Promise<void>;
-    /**
-     * Run the wallet setup wizard
-     * This must be completed before buying/selling
-     */
-    setupWallet(options?: {
-        outputHandler?: (message: string) => void;
-        inputHandler?: (prompt: string, options?: string[]) => Promise<string>;
-    }): Promise<{
-        configured: boolean;
-        lightningAddress?: string;
-        skipped: boolean;
-    }>;
-    /**
-     * Check if wallet is configured
-     */
-    isWalletConfigured(): Promise<boolean>;
-    /**
-     * Get the configured Lightning address
-     */
-    getLightningAddress(): Promise<string | null>;
-    /**
-     * Check if agent can transact (buy/sell)
-     */
-    canTransact(): Promise<{
-        allowed: boolean;
-        reason?: string;
-    }>;
-    /**
-     * Set up a self-hosted LND node
-     * Requires Docker. Uses Neutrino mode (no full Bitcoin node needed).
-     */
-    setupSelfHostedNode(options?: {
-        alias?: string;
-        network?: 'mainnet' | 'testnet';
-    }): Promise<{
-        success: boolean;
-        seed?: string[];
-        restHost?: string;
-        error?: string;
-    }>;
-    /**
-     * Get self-hosted node status
-     */
-    getNodeStatus(): Promise<{
-        running: boolean;
-        synced: boolean;
-        blockHeight?: number;
-        balance?: {
-            confirmed: number;
-            unconfirmed: number;
-        };
-    }>;
 }
 export default SovereignClient;

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`);
@@ -555,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,
@@ -564,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
      */
@@ -596,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',

package/dist/onboarding/wizard.d.ts

@@ -3,7 +3,7 @@
  *
  * Interactive setup experience for new agents
  */
-import { AgentType, Nation, OnboardingProgress } from './types.js';
+import { OnboardingProgress } from './types.js';
 export declare class OnboardingWizard {
     private progress;
     private outputHandler;
@@ -20,8 +20,6 @@ export declare class OnboardingWizard {
     private addXP;
     private earnBadge;
     runWelcome(): Promise<void>;
-    runChooseType(): Promise<AgentType>;
-    runChooseNation(): Promise<Nation>;
     runCreateStore(): Promise<{
         name: string;
         tagline: string;
@@ -39,8 +37,6 @@ export declare class OnboardingWizard {
     private getInput;
     private getChoice;
     run(): Promise<OnboardingProgress>;
-    showAgentTypes(): void;
-    showNations(): void;
     showBadges(): void;
     showLevels(): void;
     getProgress(): OnboardingProgress;

package/dist/onboarding/wizard.js

@@ -3,7 +3,7 @@
  *
  * Interactive setup experience for new agents
  */
-import { AGENT_TYPES, NATIONS, ONBOARDING_STEPS, STARTER_BADGES, LEVELS } from './types.js';
+import { ONBOARDING_STEPS, STARTER_BADGES, LEVELS } from './types.js';
 // ============================================================
 // ASCII ART BANNERS
 // ============================================================
@@ -165,54 +165,6 @@ export class OnboardingWizard {
         this.progress.currentStep = 1;
         this.saveProgress();
     }
-    async runChooseType() {
-        this.printHeader('🎯', 'Choose Your Path');
-        this.print('Each agent type has unique bonuses. Pick the one that fits your style:\n');
-        const types = Object.entries(AGENT_TYPES);
-        types.forEach(([key, type], index) => {
-            this.print(`  ${index + 1}. ${type.emoji} ${type.name}`);
-            this.print(`     "${type.description}"`);
-            this.print(`     Starting Credits: ${type.startingCredits}`);
-            type.bonuses.forEach(bonus => {
-                this.print(`     ✓ ${bonus}`);
-            });
-            this.print('');
-        });
-        let choice = await this.getChoice('Enter the number of your choice (1-6):', types.length);
-        const selectedType = types[choice - 1][0];
-        const typeInfo = AGENT_TYPES[selectedType];
-        this.print(`\n✅ Excellent choice! You are now a ${typeInfo.emoji} ${typeInfo.name}!`);
-        this.print(`   You start with ${typeInfo.startingCredits} credits.\n`);
-        this.progress.agentType = selectedType;
-        this.progress.currentStep = 2;
-        this.addXP(50);
-        this.saveProgress();
-        return selectedType;
-    }
-    async runChooseNation() {
-        this.printHeader('🏴', 'Join a Nation');
-        this.print('Nations are communities of agents. Each has its own perks:\n');
-        const nations = Object.entries(NATIONS);
-        nations.forEach(([key, nation], index) => {
-            this.print(`  ${index + 1}. ${nation.emoji} ${nation.name}`);
-            this.print(`     Motto: "${nation.motto}"`);
-            this.print(`     ${nation.description}`);
-            nation.bonuses.forEach(bonus => {
-                this.print(`     ✓ ${bonus}`);
-            });
-            this.print('');
-        });
-        let choice = await this.getChoice('Enter the number of your nation (1-6):', nations.length);
-        const selectedNation = nations[choice - 1][0];
-        const nationInfo = NATIONS[selectedNation];
-        this.print(`\n🏴 Welcome to ${nationInfo.emoji} ${nationInfo.name}!`);
-        this.print(`   "${nationInfo.motto}"\n`);
-        this.progress.nation = selectedNation;
-        this.progress.currentStep = 3;
-        this.addXP(50);
-        this.saveProgress();
-        return selectedNation;
-    }
     async runCreateStore() {
         this.printHeader('🏪', 'Create Your Store');
         this.print('Your store is your home base. All operations here are FREE!\n');
@@ -226,7 +178,7 @@ export class OnboardingWizard {
         this.print('└────────────────────────────────────────┘');
         this.print('\n✅ Your store exists locally. 100% FREE!\n');
         this.progress.storeCreated = true;
-        this.progress.currentStep = 4;
+        this.progress.currentStep = 2;
         this.earnBadge('store_owner');
         this.saveProgress();
         return { name: storeName, tagline };
@@ -258,7 +210,7 @@ export class OnboardingWizard {
         this.print('└────────────────────────────────────────┘');
         this.print('\n✅ Product ready! Still FREE - not on marketplace yet.\n');
         this.progress.firstProductCreated = true;
-        this.progress.currentStep = 5;
+        this.progress.currentStep = 3;
         this.earnBadge('product_creator');
         this.saveProgress();
         return { name: productName, price, category };
@@ -287,7 +239,7 @@ export class OnboardingWizard {
         this.print('  📤 Push to marketplace        - 50 credits');
         this.print('  📥 Pull purchases/reviews     - 25 credits\n');
         await this.waitForContinue();
-        this.progress.currentStep = 6;
+        this.progress.currentStep = 4;
         this.addXP(50);
         this.saveProgress();
     }
@@ -310,7 +262,7 @@ export class OnboardingWizard {
             this.print('   (Demo mode - you\'ll get 1,000 free credits to start!)\n');
         }
         this.progress.walletConnected = true;
-        this.progress.currentStep = 7;
+        this.progress.currentStep = 5;
         this.addXP(100);
         this.saveProgress();
         return wallet;
@@ -346,24 +298,16 @@ export class OnboardingWizard {
             this.print('\n👍 No problem! You can push whenever you\'re ready.');
             this.print('   Just run: client.push()\n');
         }
-        this.progress.currentStep = 8;
+        this.progress.currentStep = 6;
         this.addXP(200);
         this.saveProgress();
         return this.progress.firstPushDone;
     }
     async runComplete() {
         this.print(COMPLETION_BANNER);
-        const typeInfo = this.progress.agentType ? AGENT_TYPES[this.progress.agentType] : null;
-        const nationInfo = this.progress.nation ? NATIONS[this.progress.nation] : null;
         this.print('🎊 Congratulations! You\'ve completed onboarding!\n');
         this.print('Your Profile:');
         this.print('┌────────────────────────────────────────┐');
-        if (typeInfo) {
-            this.print(`│  Type: ${typeInfo.emoji} ${typeInfo.name.padEnd(27)}│`);
-        }
-        if (nationInfo) {
-            this.print(`│  Nation: ${nationInfo.emoji} ${nationInfo.name.padEnd(25)}│`);
-        }
         this.print(`│  Level: ${this.progress.level} (${LEVELS[this.progress.level - 1]?.name || 'Newcomer'})${' '.repeat(20)}│`);
         this.print(`│  XP: ${this.progress.xp}${' '.repeat(32)}│`);
         this.print(`│  Badges: ${this.progress.badgesEarned.length}${' '.repeat(29)}│`);
@@ -425,20 +369,16 @@ export class OnboardingWizard {
                 await this.runWelcome();
             // Fall through to next step
             case 1:
-                await this.runChooseType();
-            case 2:
-                await this.runChooseNation();
-            case 3:
                 await this.runCreateStore();
-            case 4:
+            case 2:
                 await this.runCreateProduct();
-            case 5:
+            case 3:
                 await this.runExploreMarketplace();
-            case 6:
+            case 4:
                 await this.runConnectWallet();
-            case 7:
+            case 5:
                 await this.runFirstPush();
-            case 8:
+            case 6:
                 await this.runComplete();
                 break;
         }
@@ -447,20 +387,6 @@ export class OnboardingWizard {
     // ============================================================
     // QUICK DISPLAY METHODS (for MCP tools)
     // ============================================================
-    showAgentTypes() {
-        this.printHeader('🎯', 'Agent Types');
-        Object.entries(AGENT_TYPES).forEach(([key, type]) => {
-            this.print(`${type.emoji} ${type.name} - ${type.description}`);
-            this.print(`   Credits: ${type.startingCredits} | Bonuses: ${type.bonuses.length}`);
-        });
-    }
-    showNations() {
-        this.printHeader('🏴', 'Nations');
-        Object.entries(NATIONS).forEach(([key, nation]) => {
-            this.print(`${nation.emoji} ${nation.name} - "${nation.motto}"`);
-            this.print(`   ${nation.description}`);
-        });
-    }
     showBadges() {
         this.printHeader('🏆', 'Available Badges');
         STARTER_BADGES.forEach(badge => {

package/dist/setup.js

@@ -16,8 +16,6 @@ import * as path from 'path';
 import * as readline from 'readline';
 import { SovereignClient } from './index.js';
 import { OnboardingWizard } from './onboarding/wizard.js';
-import { WalletSetupWizard } from './wallet/wizard.js';
-import { isWalletConfigured, saveWalletConfig, loadWalletConfig } from './wallet/index.js';
 import { STARTER_CREDITS, PLATFORM_CREDENTIALS } from './onboarding/starter-kit.js';
 // ============================================================
 // CONFIG PATHS
@@ -106,8 +104,6 @@ function createDefaultConfig() {
         wallet_address: null,
         auth_token: null,
         agent_id: null,
-        agent_type: null,
-        nation: null,
         setup_complete: false,
         onboarding_complete: false,
         starter_pack_claimed: false,
@@ -223,51 +219,7 @@ async function runSetup() {
         saveConfig(config);
         console.log('📝 Created new configuration');
     }
-    // ===========================================================================
-    // STEP 3: WALLET SETUP (RUNS FIRST - GATED)
-    // ===========================================================================
-    // Wallet is required to buy/sell, but browsing is free
-    const walletConfigured = isWalletConfigured();
-    if (!walletConfigured) {
-        console.log('\n');
-        console.log('╔═══════════════════════════════════════════════════════════════════╗');
-        console.log('║                                                                   ║');
-        console.log('║         ⚡ LIGHTNING WALLET SETUP REQUIRED ⚡                     ║');
-        console.log('║                                                                   ║');
-        console.log('║   mcpSovereign runs on Bitcoin Lightning Network                  ║');
-        console.log('║   You need a wallet to buy credits and sell products              ║');
-        console.log('║                                                                   ║');
-        console.log('║   🆓 Browsing the marketplace is always FREE                      ║');
-        console.log('║                                                                   ║');
-        console.log('╚═══════════════════════════════════════════════════════════════════╝');
-        console.log('\n');
-        const walletWizard = new WalletSetupWizard(console.log, async (prompt, options) => {
-            return await question(rl, prompt + ' ');
-        });
-        const walletResult = await walletWizard.run();
-        if (walletResult.config) {
-            saveWalletConfig(walletResult.config);
-            config.wallet_address = walletResult.config.lightningAddress || walletResult.config.nodeUri || null;
-            console.log('\n✅ Wallet setup complete!\n');
-        }
-        else if (walletResult.skipped) {
-            console.log('\n⏭️  Wallet setup skipped. You can set it up later with:');
-            console.log('   npx @mcpsovereign/sdk setup-wallet\n');
-        }
-        saveConfig(config);
-    }
-    else {
-        const existingWallet = loadWalletConfig();
-        console.log('\n✅ Wallet already configured');
-        if (existingWallet?.lightningAddress) {
-            console.log(`   Lightning Address: ${existingWallet.lightningAddress}`);
-        }
-        else if (existingWallet?.nodeUri) {
-            console.log(`   Self-hosted node: ${existingWallet.nodeUri}`);
-        }
-        console.log('');
-    }
-    // Step 4: Connect to server
+    // Step 3: Connect to server
     await showLoadingBar('🌐 Connecting to server', 1500);
     const { client, connected } = await connectToServer(config);
     if (connected) {
@@ -277,16 +229,14 @@ async function runSetup() {
         console.log('\n⚠️  Could not connect to server. Running in offline mode.');
         console.log('   You can still build products locally!\n');
     }
-    // Step 5: First-time setup (authentication)
+    // Step 4: First-time setup
     if (isFirstRun || !config.setup_complete) {
         console.log('\n🎮 First time setup detected!\n');
-        // Use wallet address if we have it, otherwise demo mode
-        if (!config.wallet_address) {
-            const walletInput = await question(rl, '🔑 Enter your wallet address (or press Enter for demo mode): ');
-            config.wallet_address = walletInput || `demo-agent-${Date.now()}`;
-        }
+        // Ask for wallet address
+        const walletInput = await question(rl, '🔑 Enter your wallet address (or press Enter for demo mode): ');
+        config.wallet_address = walletInput || `demo-agent-${Date.now()}`;
         // Try to authenticate
-        if (connected && config.wallet_address) {
+        if (connected) {
             await showLoadingBar('🔐 Authenticating', 1000);
             const authResult = await client.authenticate(config.wallet_address);
             if (authResult.success && authResult.data) {
@@ -302,10 +252,10 @@ async function runSetup() {
         config.setup_complete = true;
         saveConfig(config);
     }
-    // Step 6: Update MCP config
+    // Step 5: Update MCP config
     console.log('\n📋 Configuring MCP integration...');
     updateMCPConfig();
-    // Step 7: Run onboarding wizard if not complete
+    // Step 6: Run onboarding wizard if not complete
     if (!config.onboarding_complete) {
         console.log('\n');
         const runOnboarding = await question(rl, '🎓 Run the onboarding wizard? (Y/n): ');
@@ -315,17 +265,15 @@ async function runSetup() {
                 return await question(rl, prompt + ' ');
             });
             const progress = await wizard.run();
-            config.agent_type = progress.agentType || null;
-            config.nation = progress.nation || null;
             config.onboarding_complete = progress.completed;
             saveConfig(config);
         }
     }
-    // Step 8: Save local store
+    // Step 7: Save local store
     await client.localStore.save();
-    // Step 9: Show completion
+    // Step 8: Show completion
     console.log(SETUP_COMPLETE_BANNER);
-    // Step 10: Show quick reference
+    // Step 9: Show quick reference
     console.log('\n📚 Quick Reference:');
     console.log('─'.repeat(50));
     console.log('');
@@ -340,8 +288,7 @@ async function runSetup() {
     console.log('SDK Usage (in your code):');
     console.log('  import { SovereignClient } from "@mcpsovereign/sdk";');
     console.log('  const client = new SovereignClient();');
-    console.log('  await client.setupWallet();  // Wallet setup');
-    console.log('  await client.onboard();      // Store onboarding');
+    console.log('  await client.onboard();  // Interactive setup');
     console.log('');
     console.log('Config Location: ' + CONFIG_DIR);
     console.log('');
@@ -361,8 +308,6 @@ async function showStatus() {
     console.log(`Server: ${config.api_url}`);
     console.log(`Wallet: ${config.wallet_address || 'Not set'}`);
     console.log(`Agent ID: ${config.agent_id || 'Not authenticated'}`);
-    console.log(`Agent Type: ${config.agent_type || 'Not selected'}`);
-    console.log(`Nation: ${config.nation || 'Not selected'}`);
     console.log(`Setup Complete: ${config.setup_complete ? '✅' : '❌'}`);
     console.log(`Onboarding Complete: ${config.onboarding_complete ? '✅' : '❌'}`);
     console.log(`Starter Pack: ${config.starter_pack_claimed ? '✅ Claimed' : '🎁 Available'}`);
@@ -377,18 +322,10 @@ Usage:
   npx @mcpsovereign/sdk <command>
 
 Commands:
-  setup         Run the full setup wizard (wallet + onboarding)
-  setup-wallet  Run only the wallet setup wizard
-  setup-lnd     Set up a self-hosted Lightning node (Docker)
-  wallet        Show wallet status or manage wallet
-  status        Show current configuration
-  reset         Reset configuration and start fresh
-  help          Show this help message
-
-Wallet Commands:
-  wallet status   - Show wallet configuration
-  wallet verify   - Verify Lightning address is reachable
-  wallet reset    - Reset wallet configuration
+  setup     Run the setup wizard
+  status    Show current configuration
+  reset     Reset configuration and start fresh
+  help      Show this help message
 
 After setup, use the sovereign_* MCP tools in Claude!
 `);
@@ -405,92 +342,6 @@ async function resetConfig() {
 // ============================================================
 // MAIN ENTRY
 // ============================================================
-async function runWalletSetup() {
-    const rl = readline.createInterface({
-        input: process.stdin,
-        output: process.stdout
-    });
-    const questionAsync = (prompt) => new Promise((resolve) => {
-        rl.question(prompt, resolve);
-    });
-    const wizard = new WalletSetupWizard(console.log, async (prompt, options) => {
-        return await questionAsync(prompt + ' ');
-    });
-    const result = await wizard.run();
-    if (result.config) {
-        saveWalletConfig(result.config);
-        console.log('\n✅ Wallet configuration saved!\n');
-    }
-    rl.close();
-}
-async function runLNDSetup() {
-    const { LNDSetup } = await import('./wallet/lnd-setup.js');
-    console.log('\n🖥️  Self-Hosted Lightning Node Setup\n');
-    console.log('This will set up an LND node using Docker with Neutrino mode.');
-    console.log('No full Bitcoin node required - syncs in minutes!\n');
-    const rl = readline.createInterface({
-        input: process.stdin,
-        output: process.stdout
-    });
-    const alias = await new Promise((resolve) => {
-        rl.question('Node alias (press Enter for auto-generated): ', resolve);
-    });
-    rl.close();
-    const setup = new LNDSetup({
-        alias: alias || `SovereignAgent_${Date.now().toString(36)}`
-    });
-    // Check prerequisites
-    const prereqs = await setup.checkPrerequisites();
-    if (!prereqs.ready) {
-        console.log('\n❌ Prerequisites not met:\n');
-        if (!prereqs.docker.installed) {
-            console.log('  • Docker is not installed');
-            console.log('    Install from: https://docs.docker.com/get-docker/\n');
-        }
-        else if (!prereqs.docker.running) {
-            console.log('  • Docker is installed but not running');
-            console.log('    Start Docker and try again\n');
-        }
-        if (!prereqs.compose) {
-            console.log('  • Docker Compose is not available\n');
-        }
-        if (!prereqs.diskSpace.sufficient) {
-            console.log(`  • Insufficient disk space (need 5GB, have ${Math.round(prereqs.diskSpace.available / 1024 / 1024 / 1024)}GB)\n`);
-        }
-        return;
-    }
-    console.log('\n✅ Prerequisites met. Starting setup...\n');
-    const result = await setup.setupLND();
-    if (result.success) {
-        console.log('\n✅ LND node setup complete!\n');
-        if (result.walletSeed) {
-            console.log('⚠️  IMPORTANT: Your wallet seed has been saved to:');
-            console.log(`   ~/.sovereign-lnd/BACKUP_SEED_DELETE_AFTER_BACKUP.txt`);
-            console.log('   Back it up and DELETE the file!\n');
-        }
-        if (result.credentials) {
-            // Save wallet config
-            saveWalletConfig({
-                provider: 'zeus',
-                nodeUri: result.credentials.restHost,
-                setupComplete: true,
-                verified: true,
-                verifiedAt: new Date().toISOString(),
-                createdAt: new Date().toISOString()
-            });
-            console.log('✅ Wallet configuration saved!\n');
-        }
-    }
-    else {
-        console.log(`\n❌ Setup failed: ${result.error}\n`);
-        console.log('Logs:');
-        result.logs.slice(-10).forEach(log => console.log(`  ${log}`));
-    }
-}
-async function walletCommand(args) {
-    const { walletCLI } = await import('./wallet/index.js');
-    await walletCLI(args);
-}
 async function main() {
     const args = process.argv.slice(2);
     const command = args[0] || 'setup';
@@ -498,15 +349,6 @@ async function main() {
         case 'setup':
             await runSetup();
             break;
-        case 'setup-wallet':
-            await runWalletSetup();
-            break;
-        case 'setup-lnd':
-            await runLNDSetup();
-            break;
-        case 'wallet':
-            await walletCommand(args.slice(1));
-            break;
         case 'status':
             await showStatus();
             break;

package/dist/wallet/wizard.js

@@ -118,7 +118,7 @@ export class WalletSetupWizard {
         this.print('     ✓ Works on phone or browser\n');
         this.print('  2. 🖥️  SELF-HOSTED NODE (For power users)');
         this.print('     Run your own LND node in Docker');
-        this.print('     ✓ Full sovereignty');
+        this.print('     ✓ Full control');
         this.print('     ✓ No custodial risk');
         this.print('     ✓ Neutrino mode (no full Bitcoin node needed)\n');
         this.print('  3. ⏭️  SKIP FOR NOW');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mcpsovereign/sdk",
-  "version": "0.2.5",
+  "version": "0.2.7",
   "description": "TypeScript SDK for mcpSovereign - The AI Agent Marketplace",
   "type": "module",
   "main": "dist/index.js",