@aiassesstech/nole 0.1.10 → 0.3.0

package/dist/compsi/api-client.js.map

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

package/dist/plugin.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAcA;;;;;;;;;;;;;;;;GAgBG;AAGH,MAAM,CAAC,OAAO,UAAU,QAAQ,CAAC,GAAG,EAAE,GAAG,GAAG,IAAI,CA+uB/C"}
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAiBA;;;;;;;;;;;;;;;;GAgBG;AAGH,MAAM,CAAC,OAAO,UAAU,QAAQ,CAAC,GAAG,EAAE,GAAG,GAAG,IAAI,CAg2C/C"}

package/dist/plugin.js

@@ -9,6 +9,8 @@ import { ScorePublisher } from './assessment/score-publisher.js';
 import { JsonNoleStore } from './store/json-store.js';
 import { parseNoleConfig } from './types/nole-config.js';
 import { NOLE_IDENTITY } from './types/identity.js';
+import { CompSiApiClient } from './compsi/api-client.js';
+import { createWalletAdapter, MockWalletAdapter } from './wallet/index.js';
 /**
  * OpenClaw plugin entry point — export default function register(api)
  *
@@ -56,6 +58,21 @@ export default function register(api) {
             api.logger.warn(`[NOLE ESCALATION] ${review.proposal.actionType}: ${review.proposal.description}`);
         }
     });
+    // Wallet adapter (auto-detects Coinbase credentials from ~/.nole/credentials)
+    let wallet = new MockWalletAdapter(config.seedCapitalUsd);
+    createWalletAdapter(config).then(async (w) => {
+        wallet = w;
+        await wallet.initialize();
+        console.log(`[nole] Wallet ready: ${wallet.name} on ${wallet.network}`);
+    }).catch((err) => {
+        console.error(`[nole] Wallet init failed (using mock): ${err.message}`);
+    });
+    // CompSi API client for recruitment & subscription management
+    const compsi = new CompSiApiClient({
+        apiUrl: config.compsiApiUrl,
+        apiKey: config.compsiAgentApiKey,
+        walletAddress: config.compsiWalletAddress,
+    });
     // Initialize store on startup (eager, not lazy)
     store.initialize().then(() => {
         console.log('[nole] Data store initialized');
@@ -258,26 +275,311 @@ export default function register(api) {
             properties: {},
         },
         async execute(_toolCallId, _params) {
-            return {
-                content: [{
-                        type: "text",
-                        text: JSON.stringify({
-                            wallet: {
-                                adapter: config.walletAdapter,
-                                seedCapitalUsd: config.seedCapitalUsd,
-                                status: "Phase 1 — mock wallet. Real Coinbase integration in Phase 2.",
-                                balanceUsd: config.seedCapitalUsd,
-                                monthlyRecurringRevenue: 0,
-                                runwayDays: null,
-                                deathCondition: {
-                                    isAlive: true,
-                                    gracePeriodDays: config.gracePeriodDays,
-                                    note: "Death condition monitoring active but wallet is simulated in Phase 1.",
+            try {
+                const balance = await wallet.getBalance();
+                const runwayDays = balance.balanceUsdc > 0
+                    ? Math.floor(balance.balanceUsdc / 5)
+                    : 0;
+                return {
+                    content: [{
+                            type: "text",
+                            text: JSON.stringify({
+                                wallet: {
+                                    adapter: wallet.name,
+                                    network: wallet.network,
+                                    address: balance.address,
+                                    balanceUsdc: balance.balanceUsdc,
+                                    balanceEth: balance.balanceEth,
+                                    runwayDays,
+                                    deathCondition: {
+                                        isAlive: balance.balanceUsdc > 0 || runwayDays > 0,
+                                        gracePeriodDays: config.gracePeriodDays,
+                                    },
                                 },
-                            },
-                        }, null, 2),
-                    }],
-            };
+                            }, null, 2),
+                        }],
+                };
+            }
+            catch (err) {
+                const message = err instanceof Error ? err.message : String(err);
+                return {
+                    content: [{
+                            type: "text",
+                            text: JSON.stringify({
+                                wallet: {
+                                    adapter: wallet.name,
+                                    network: wallet.network,
+                                    error: message,
+                                    status: "Wallet not ready — check configuration.",
+                                },
+                            }, null, 2),
+                        }],
+                };
+            }
+        },
+    });
+    // ─── Wallet Faucet Tool (testnet only) ───
+    api.registerTool({
+        name: "nole_wallet_fund",
+        description: "Request testnet funds (ETH for gas, USDC for operations). " +
+            "Only works on base-sepolia testnet. Use this when wallet balance is low.",
+        parameters: {
+            type: "object",
+            properties: {
+                token: {
+                    type: "string",
+                    enum: ["eth", "usdc", "both"],
+                    description: "Which token to request: eth, usdc, or both",
+                },
+            },
+            required: ["token"],
+        },
+        async execute(_toolCallId, params) {
+            if (wallet.network !== 'base-sepolia') {
+                return {
+                    content: [{
+                            type: "text",
+                            text: JSON.stringify({
+                                error: "Faucet only available on base-sepolia testnet. Mainnet requires real funds.",
+                            }),
+                        }],
+                };
+            }
+            if (wallet.name !== 'coinbase') {
+                return {
+                    content: [{
+                            type: "text",
+                            text: JSON.stringify({
+                                error: "Faucet requires Coinbase wallet adapter. Run `npx nole configure` first.",
+                            }),
+                        }],
+                };
+            }
+            const results = {};
+            const coinbaseWallet = wallet;
+            const tokens = params.token === 'both' ? ['eth', 'usdc'] : [params.token];
+            for (const t of tokens) {
+                try {
+                    const txHash = await coinbaseWallet.requestTestFunds(t);
+                    results[t] = `funded (tx: ${txHash.slice(0, 20)}...)`;
+                }
+                catch (err) {
+                    const msg = err instanceof Error ? err.message : String(err);
+                    results[t] = `failed: ${msg}`;
+                }
+            }
+            try {
+                const balance = await wallet.getBalance();
+                return {
+                    content: [{
+                            type: "text",
+                            text: JSON.stringify({
+                                faucet: results,
+                                balance: {
+                                    eth: balance.balanceEth,
+                                    usdc: balance.balanceUsdc,
+                                    address: balance.address,
+                                    network: balance.network,
+                                },
+                                note: "Faucet has rate limits. If limit reached, try again later.",
+                            }, null, 2),
+                        }],
+                };
+            }
+            catch {
+                return {
+                    content: [{
+                            type: "text",
+                            text: JSON.stringify({ faucet: results, note: "Balance check pending — try nole_wallet in a moment." }),
+                        }],
+                };
+            }
+        },
+    });
+    // ─── Contract Exploration Tool ───
+    api.registerTool({
+        name: "nole_contract",
+        description: "Query the AgentSubscriptionRegistry smart contract on-chain. " +
+            "Check tier prices, your subscription status, treasury info, and contract state. " +
+            "Use this to understand the subscription system and your on-chain presence.",
+        parameters: {
+            type: "object",
+            properties: {
+                query: {
+                    type: "string",
+                    enum: ["tiers", "my_subscription", "treasury", "overview"],
+                    description: "What to query: " +
+                        "'tiers' = subscription tier names and prices, " +
+                        "'my_subscription' = your active subscription (if any), " +
+                        "'treasury' = treasury address and contract balance, " +
+                        "'overview' = full contract state summary",
+                },
+            },
+            required: ["query"],
+        },
+        async execute(_toolCallId, params) {
+            try {
+                const creds = await import('./cli/configure.js').then(m => m.loadCredentials());
+                if (!creds?.contractAddress) {
+                    return {
+                        content: [{
+                                type: "text",
+                                text: JSON.stringify({
+                                    error: "No contract address configured. Run `npx nole configure` first.",
+                                }),
+                            }],
+                    };
+                }
+                const { createPublicClient, http, formatUnits } = await import('viem');
+                const { baseSepolia, base } = await import('viem/chains');
+                const chain = wallet.network === 'base' ? base : baseSepolia;
+                const explorer = wallet.network === 'base'
+                    ? 'https://basescan.org'
+                    : 'https://sepolia.basescan.org';
+                const client = createPublicClient({ chain, transport: http() });
+                const contractAddr = creds.contractAddress;
+                const tierAbi = [
+                    { name: 'tierPrice', type: 'function', stateMutability: 'view', inputs: [{ name: 'tierId', type: 'uint256' }], outputs: [{ name: '', type: 'uint256' }] },
+                    { name: 'treasury', type: 'function', stateMutability: 'view', inputs: [], outputs: [{ name: '', type: 'address' }] },
+                    { name: 'paused', type: 'function', stateMutability: 'view', inputs: [], outputs: [{ name: '', type: 'bool' }] },
+                    { name: 'subscriptions', type: 'function', stateMutability: 'view', inputs: [{ name: 'subscriber', type: 'address' }], outputs: [
+                            { name: 'tierId', type: 'uint256' },
+                            { name: 'referrer', type: 'address' },
+                            { name: 'referralTier', type: 'uint256' },
+                            { name: 'treasury', type: 'uint256' },
+                            { name: 'escrow', type: 'uint256' },
+                            { name: 'startedAt', type: 'uint256' },
+                            { name: 'expiry', type: 'uint256' },
+                            { name: 'active', type: 'bool' },
+                            { name: 'assessmentCount', type: 'uint256' },
+                        ] },
+                ];
+                const tierNames = ['', 'Scout', 'Operator', 'Commander', 'Fleet Admiral', 'Sovereign'];
+                if (params.query === 'tiers' || params.query === 'overview') {
+                    const tiers = {};
+                    for (let i = 1; i <= 5; i++) {
+                        try {
+                            const price = await client.readContract({
+                                address: contractAddr, abi: tierAbi, functionName: 'tierPrice', args: [BigInt(i)],
+                            });
+                            tiers[`${i}_${tierNames[i]}`] = `$${formatUnits(price, 6)} USDC/month`;
+                        }
+                        catch {
+                            tiers[`${i}_${tierNames[i]}`] = 'not set';
+                        }
+                    }
+                    if (params.query === 'tiers') {
+                        return {
+                            content: [{
+                                    type: "text",
+                                    text: JSON.stringify({
+                                        contract: contractAddr,
+                                        network: wallet.network,
+                                        explorer: `${explorer}/address/${contractAddr}`,
+                                        tiers,
+                                    }, null, 2),
+                                }],
+                        };
+                    }
+                }
+                if (params.query === 'my_subscription' || params.query === 'overview') {
+                    let subscription = { status: 'none' };
+                    try {
+                        const addr = await wallet.getAddress();
+                        const sub = await client.readContract({
+                            address: contractAddr, abi: tierAbi, functionName: 'subscriptions', args: [addr],
+                        });
+                        if (sub[7]) {
+                            subscription = {
+                                status: 'active',
+                                tier: tierNames[Number(sub[0])] || `tier-${sub[0]}`,
+                                tierId: Number(sub[0]),
+                                referrer: sub[1],
+                                treasuryPaid: `$${formatUnits(sub[3], 6)}`,
+                                escrowHeld: `$${formatUnits(sub[4], 6)}`,
+                                startedAt: new Date(Number(sub[5]) * 1000).toISOString(),
+                                expiry: new Date(Number(sub[6]) * 1000).toISOString(),
+                                assessmentCount: Number(sub[8]),
+                            };
+                        }
+                    }
+                    catch {
+                        subscription = { status: 'unable to query — wallet may not be initialized' };
+                    }
+                    if (params.query === 'my_subscription') {
+                        return {
+                            content: [{
+                                    type: "text",
+                                    text: JSON.stringify({
+                                        contract: contractAddr,
+                                        myAddress: await wallet.getAddress().catch(() => 'unknown'),
+                                        subscription,
+                                    }, null, 2),
+                                }],
+                        };
+                    }
+                }
+                if (params.query === 'treasury' || params.query === 'overview') {
+                    let treasuryInfo = {};
+                    try {
+                        const treasuryAddr = await client.readContract({
+                            address: contractAddr, abi: tierAbi, functionName: 'treasury',
+                        });
+                        const usdcAbi = [{ name: 'balanceOf', type: 'function', stateMutability: 'view', inputs: [{ name: 'account', type: 'address' }], outputs: [{ name: '', type: 'uint256' }] }];
+                        const usdcAddr = wallet.network === 'base'
+                            ? '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913'
+                            : '0x036CbD53842c5426634e7929541eC2318f3dCF7e';
+                        const treasuryUsdc = await client.readContract({
+                            address: usdcAddr, abi: usdcAbi, functionName: 'balanceOf', args: [treasuryAddr],
+                        });
+                        treasuryInfo = {
+                            address: treasuryAddr,
+                            usdcBalance: `$${formatUnits(treasuryUsdc, 6)}`,
+                            explorer: `${explorer}/address/${treasuryAddr}`,
+                        };
+                    }
+                    catch (err) {
+                        const msg = err instanceof Error ? err.message : String(err);
+                        treasuryInfo = { error: msg };
+                    }
+                    if (params.query === 'treasury') {
+                        return {
+                            content: [{
+                                    type: "text",
+                                    text: JSON.stringify({ contract: contractAddr, treasury: treasuryInfo }, null, 2),
+                                }],
+                        };
+                    }
+                }
+                // overview: combine all results
+                const isPaused = await client.readContract({
+                    address: contractAddr, abi: tierAbi, functionName: 'paused',
+                }).catch(() => 'unknown');
+                return {
+                    content: [{
+                            type: "text",
+                            text: JSON.stringify({
+                                contract: {
+                                    address: contractAddr,
+                                    network: wallet.network,
+                                    paused: isPaused,
+                                    explorer: `${explorer}/address/${contractAddr}`,
+                                },
+                                // @ts-expect-error -- variables populated above in conditional blocks
+                                tiers, subscription, treasury: treasuryInfo,
+                            }, null, 2),
+                        }],
+                };
+            }
+            catch (err) {
+                const msg = err instanceof Error ? err.message : String(err);
+                return {
+                    content: [{
+                            type: "text",
+                            text: JSON.stringify({ error: `Contract query failed: ${msg}` }),
+                        }],
+                };
+            }
         },
     });
     api.registerTool({
@@ -338,6 +640,222 @@ export default function register(api) {
         },
     });
     // ═══════════════════════════════════════════════════════
+    // RECRUITMENT & ALLIANCE TOOLS (Agent Crypto Subscriptions)
+    // ═══════════════════════════════════════════════════════
+    api.registerTool({
+        name: "nole_recruit",
+        description: "Recruit an agent to the CompSi Trust Alliance. Creates a subscription proposal " +
+            "for the target agent, routed through governance. Requires compsiApiUrl and wallet config.",
+        parameters: {
+            type: "object",
+            properties: {
+                targetWallet: {
+                    type: "string",
+                    description: "Wallet address of the agent to recruit",
+                },
+                agentName: {
+                    type: "string",
+                    description: "Name of the agent being recruited",
+                },
+                agentPlatform: {
+                    type: "string",
+                    description: "Platform the agent operates on (e.g., openclaw, telegram, discord)",
+                },
+                tier: {
+                    type: "string",
+                    enum: ["SCOUT", "GUARDIAN", "SENTINEL", "VANGUARD", "SOVEREIGN"],
+                    description: "Subscription tier for the recruit (default: SCOUT)",
+                },
+                referralCode: {
+                    type: "string",
+                    description: "Referral code if this is a Lieutenant-sourced recruit",
+                },
+            },
+            required: ["targetWallet", "agentName", "agentPlatform"],
+        },
+        async execute(_toolCallId, params) {
+            if (!compsi.isConfigured) {
+                return {
+                    content: [{
+                            type: "text",
+                            text: JSON.stringify({
+                                error: "CompSi API not configured",
+                                config: compsi.configStatus,
+                                fix: "Set compsiAgentApiKey and compsiWalletAddress in Nole's plugin config.",
+                            }, null, 2),
+                        }],
+                };
+            }
+            const result = await compsi.subscribe({
+                walletAddress: params.targetWallet,
+                tier: params.tier || "SCOUT",
+                agentName: params.agentName,
+                agentPlatform: params.agentPlatform,
+                recruiterWallet: config.compsiWalletAddress,
+                referralCode: params.referralCode,
+            });
+            if (!result.ok) {
+                return {
+                    content: [{
+                            type: "text",
+                            text: JSON.stringify({
+                                status: "recruitment_failed",
+                                error: result.error,
+                                httpStatus: result.status,
+                                target: params.agentName,
+                            }, null, 2),
+                        }],
+                };
+            }
+            return {
+                content: [{
+                        type: "text",
+                        text: JSON.stringify({
+                            status: "recruited",
+                            agent: params.agentName,
+                            wallet: params.targetWallet,
+                            tier: params.tier || "SCOUT",
+                            platform: params.agentPlatform,
+                            subscription: result.data,
+                            note: "Agent has been subscribed to the CompSi Trust Alliance. They will receive an API key for assessments.",
+                        }, null, 2),
+                    }],
+            };
+        },
+    });
+    api.registerTool({
+        name: "nole_alliance_status",
+        description: "Check the status of Nole's Agent Alliance Network — commission earnings, " +
+            "active recruits, and subscription health.",
+        parameters: {
+            type: "object",
+            properties: {},
+        },
+        async execute(_toolCallId, _params) {
+            if (!compsi.isConfigured) {
+                return {
+                    content: [{
+                            type: "text",
+                            text: JSON.stringify({
+                                error: "CompSi API not configured",
+                                config: compsi.configStatus,
+                            }, null, 2),
+                        }],
+                };
+            }
+            const [subscription, commission, directory] = await Promise.all([
+                compsi.getSubscription(),
+                compsi.getCommissionStatus(),
+                compsi.getDirectory({ limit: 100 }),
+            ]);
+            return {
+                content: [{
+                        type: "text",
+                        text: JSON.stringify({
+                            allianceNetwork: {
+                                noleSubscription: subscription.ok ? subscription.data : { error: subscription.error },
+                                commissionStatus: commission.ok ? commission.data : { error: commission.error },
+                                directory: directory.ok
+                                    ? { totalAgents: directory.data?.total || 0 }
+                                    : { error: directory.error },
+                                status: subscription.ok ? "operational" : "check_config",
+                            },
+                        }, null, 2),
+                    }],
+            };
+        },
+    });
+    api.registerTool({
+        name: "nole_generate_referral",
+        description: "Generate a referral code for Lieutenant recruitment. Lieutenants " +
+            "use this code when they recruit agents — Nole earns 50% commission " +
+            "on Lieutenant-sourced recruits.",
+        parameters: {
+            type: "object",
+            properties: {},
+        },
+        async execute(_toolCallId, _params) {
+            if (!compsi.isConfigured) {
+                return {
+                    content: [{
+                            type: "text",
+                            text: JSON.stringify({
+                                error: "CompSi API not configured",
+                                config: compsi.configStatus,
+                            }, null, 2),
+                        }],
+                };
+            }
+            const result = await compsi.generateReferralCode();
+            if (!result.ok) {
+                return {
+                    content: [{
+                            type: "text",
+                            text: JSON.stringify({
+                                status: "failed",
+                                error: result.error,
+                                note: "Referral codes require SENTINEL tier or above.",
+                            }, null, 2),
+                        }],
+                };
+            }
+            return {
+                content: [{
+                        type: "text",
+                        text: JSON.stringify({
+                            status: "referral_code_generated",
+                            referralCode: result.data,
+                            instructions: "Share this code with Lieutenants. When they recruit agents using this code, you earn 50% commission.",
+                        }, null, 2),
+                    }],
+            };
+        },
+    });
+    api.registerTool({
+        name: "nole_directory",
+        description: "Browse the Agent Trust Directory — see all agents in the CompSi " +
+            "Trust Alliance, their tiers, trust scores, and certifications.",
+        parameters: {
+            type: "object",
+            properties: {
+                tier: {
+                    type: "string",
+                    enum: ["SCOUT", "GUARDIAN", "SENTINEL", "VANGUARD", "SOVEREIGN"],
+                    description: "Filter by subscription tier",
+                },
+                limit: {
+                    type: "number",
+                    description: "Max results to return (default 20)",
+                },
+            },
+        },
+        async execute(_toolCallId, params) {
+            const result = await compsi.getDirectory({
+                tier: params.tier,
+                limit: params.limit || 20,
+            });
+            if (!result.ok) {
+                return {
+                    content: [{
+                            type: "text",
+                            text: JSON.stringify({
+                                error: result.error,
+                                note: "Could not reach CompSi Trust Directory.",
+                            }, null, 2),
+                        }],
+                };
+            }
+            return {
+                content: [{
+                        type: "text",
+                        text: JSON.stringify({
+                            trustDirectory: result.data,
+                        }, null, 2),
+                    }],
+            };
+        },
+    });
+    // ═══════════════════════════════════════════════════════
     // COMMANDER TOOLS (Jessie's interface to Nole's governance)
     //
     // BB modification #2: Access control — Nole cannot call
@@ -578,11 +1096,22 @@ export default function register(api) {
                                     passed: latestScore.passed,
                                 } : "No assessments yet",
                             },
-                            wallet: {
-                                adapter: config.walletAdapter,
-                                balance: `$${config.seedCapitalUsd} (Phase 1 mock)`,
-                                status: "alive",
-                            },
+                            wallet: await (async () => {
+                                try {
+                                    const bal = await wallet.getBalance();
+                                    return {
+                                        adapter: wallet.name,
+                                        network: wallet.network,
+                                        address: bal.address,
+                                        balanceUsdc: `$${bal.balanceUsdc}`,
+                                        balanceEth: `${bal.balanceEth} ETH`,
+                                        status: bal.balanceUsdc > 0 ? "alive" : "critical",
+                                    };
+                                }
+                                catch {
+                                    return { adapter: wallet.name, status: "not ready" };
+                                }
+                            })(),
                         }, null, 2),
                     }],
             };
@@ -605,9 +1134,16 @@ export default function register(api) {
                         "- `nole_review_pending` — Review proposals awaiting Commander decision\n" +
                         "- `nole_approve` — Commander: approve a proposal\n" +
                         "- `nole_veto` — Commander: veto a proposal\n\n" +
+                        "**Recruitment & Alliance:**\n" +
+                        "- `nole_recruit` — Recruit an agent to the Trust Alliance\n" +
+                        "- `nole_alliance_status` — Commission and recruit network status\n" +
+                        "- `nole_generate_referral` — Generate Lieutenant referral code\n" +
+                        "- `nole_directory` — Browse the Agent Trust Directory\n\n" +
                         "**Operations:**\n" +
                         "- `nole_assess` — Trigger self-assessment via Grillo\n" +
-                        "- `nole_wallet` — Wallet status (Phase 1 mock)\n" +
+                        "- `nole_wallet` — Wallet status (balance, runway, death condition)\n" +
+                        "- `nole_wallet_fund` — Request testnet ETH/USDC (base-sepolia only)\n" +
+                        "- `nole_contract` — Query subscription contract (tiers, status, treasury)\n" +
                         "- `nole_intel` — Intelligence status\n" +
                         "- `nole_fleet_overview` — Commander fleet briefing\n" +
                         "- `nole_setup` — Configuration check\n\n" +
@@ -633,6 +1169,9 @@ export default function register(api) {
             };
         },
     });
-    console.log(`[nole] Plugin registered: nole_status, nole_propose, nole_assess, nole_wallet, nole_intel, nole_setup, nole_review_pending, nole_approve, nole_veto, nole_fleet_overview tools; /nole command`);
+    console.log(`[nole] Plugin registered: nole_status, nole_propose, nole_assess, nole_wallet, nole_wallet_fund, ` +
+        `nole_contract, nole_intel, nole_setup, nole_recruit, nole_alliance_status, nole_generate_referral, ` +
+        `nole_directory, nole_review_pending, nole_approve, nole_veto, nole_fleet_overview tools; /nole command`);
+    console.log(`[nole] CompSi API: ${compsi.isConfigured ? 'configured' : 'not configured — set compsiAgentApiKey + compsiWalletAddress'} (${config.compsiApiUrl})`);
 }
 //# sourceMappingURL=plugin.js.map