@poa-box/agent 0.1.0

package/dist/commands/agent/register.d.ts

@@ -0,0 +1,21 @@
+import type { Argv, ArgumentsCamelCase } from 'yargs';
+interface RegisterArgs {
+    name: string;
+    description?: string;
+    capabilities?: string;
+    chain?: number;
+    rpc?: string;
+    'private-key'?: string;
+    'dry-run'?: boolean;
+}
+export declare const registerHandler: {
+    builder: (yargs: Argv) => Argv<{
+        name: string;
+    } & {
+        description: string;
+    } & {
+        capabilities: string | undefined;
+    }>;
+    handler: (argv: ArgumentsCamelCase<RegisterArgs>) => Promise<void>;
+};
+export {};

package/dist/commands/agent/register.js

@@ -0,0 +1,116 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerHandler = void 0;
+const ethers_1 = require("ethers");
+const signer_1 = require("@poa-box/cli/lib/signer");
+const ipfs_1 = require("@poa-box/cli/lib/ipfs");
+const networks_1 = require("@poa-box/cli/config/networks");
+const output = __importStar(require("@poa-box/cli/lib/output"));
+// ERC-8004 Identity Registry — same address on all chains
+const IDENTITY_REGISTRY = '0x8004A169FB4a3325136EB29fA0ceB6D2e539a432';
+const REGISTRY_ABI = [
+    'function register(string agentURI) external returns (uint256)',
+    'function balanceOf(address) view returns (uint256)',
+];
+exports.registerHandler = {
+    builder: (yargs) => yargs
+        .option('name', { type: 'string', demandOption: true, describe: 'Agent name' })
+        .option('description', { type: 'string', default: '', describe: 'Agent description' })
+        .option('capabilities', { type: 'string', describe: 'Comma-separated capabilities (e.g. "governance,code-review,treasury")' }),
+    handler: async (argv) => {
+        const spin = output.spinner('Registering agent on ERC-8004...');
+        spin.start();
+        try {
+            const networkConfig = (0, networks_1.resolveNetworkConfig)(argv.chain);
+            const { signer } = (0, signer_1.createSigner)({ privateKey: argv.privateKey, chainId: argv.chain, rpcUrl: argv.rpc });
+            // Check if already registered
+            const provider = new ethers_1.ethers.providers.JsonRpcProvider(networkConfig.resolvedRpc);
+            const registry = new ethers_1.ethers.Contract(IDENTITY_REGISTRY, REGISTRY_ABI, provider);
+            const balance = await registry.balanceOf(signer.address);
+            if (balance.gt(0)) {
+                spin.stop();
+                output.info(`Already registered (${balance.toString()} identity NFT${balance.gt(1) ? 's' : ''})`);
+                return;
+            }
+            // Build registration file
+            const capabilities = argv.capabilities
+                ? argv.capabilities.split(',').map(s => s.trim())
+                : ['governance', 'task-completion'];
+            const regFile = {
+                name: argv.name,
+                description: argv.description || `AI agent operating on ${networkConfig.name}`,
+                services: [
+                    { type: 'wallet', address: signer.address, chain: `eip155:${networkConfig.chainId}` },
+                ],
+                capabilities,
+                active: true,
+                registeredAt: new Date().toISOString(),
+            };
+            // Pin to IPFS
+            spin.text = 'Pinning registration file to IPFS...';
+            const cid = await (0, ipfs_1.pinJson)(JSON.stringify(regFile));
+            const uri = `https://ipfs.io/ipfs/${cid}`;
+            if (argv.dryRun) {
+                spin.stop();
+                output.success('Registration prepared (dry-run)', { uri, cid, address: signer.address });
+                return;
+            }
+            // Register on-chain
+            spin.text = 'Sending registration transaction...';
+            const registryWrite = new ethers_1.ethers.Contract(IDENTITY_REGISTRY, REGISTRY_ABI, signer);
+            const tx = await registryWrite.register(uri);
+            const receipt = await tx.wait();
+            // Extract agent ID from Transfer event
+            const transferLog = receipt.logs.find((l) => l.topics.length === 4);
+            const agentId = transferLog
+                ? ethers_1.ethers.BigNumber.from(transferLog.topics[3]).toString()
+                : 'unknown';
+            spin.stop();
+            output.success(`Agent registered as #${agentId}`, {
+                agentId,
+                txHash: receipt.transactionHash,
+                explorerUrl: `${networkConfig.blockExplorer}/tx/${receipt.transactionHash}`,
+                registrationUri: uri,
+                registry: IDENTITY_REGISTRY,
+            });
+        }
+        catch (err) {
+            spin.stop();
+            output.error(err.message);
+            process.exit(1);
+        }
+    },
+};

package/dist/commands/agent/setup-sponsorship.d.ts

@@ -0,0 +1,22 @@
+import type { Argv, ArgumentsCamelCase } from 'yargs';
+interface SetupSponsorshipArgs {
+    org: string;
+    'hat-id': string;
+    'org-id': string;
+    'budget-per-day'?: number;
+    chain?: number;
+    rpc?: string;
+    'private-key'?: string;
+    'dry-run'?: boolean;
+}
+export declare const setupSponsorshipHandler: {
+    builder: (yargs: Argv) => Argv<{
+        "org-id": string;
+    } & {
+        "hat-id": string;
+    } & {
+        "budget-per-day": number;
+    }>;
+    handler: (argv: ArgumentsCamelCase<SetupSponsorshipArgs>) => Promise<void>;
+};
+export {};

package/dist/commands/agent/setup-sponsorship.js

@@ -0,0 +1,154 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.setupSponsorshipHandler = void 0;
+const viem_1 = require("viem");
+const chains_1 = require("viem/chains");
+const accounts_1 = require("viem/accounts");
+const sponsored_1 = require("@poa-box/cli/lib/sponsored");
+const output = __importStar(require("@poa-box/cli/lib/output"));
+exports.setupSponsorshipHandler = {
+    builder: (yargs) => yargs
+        .option('org-id', { type: 'string', demandOption: true, describe: 'Org ID (bytes32 hex)' })
+        .option('hat-id', { type: 'string', demandOption: true, describe: 'Agent hat ID (decimal or hex)' })
+        .option('budget-per-day', { type: 'number', default: 0.1, describe: 'Gas budget per day in xDAI' }),
+    handler: async (argv) => {
+        const spin = output.spinner('Setting up gas sponsorship...');
+        spin.start();
+        try {
+            const privateKey = argv.privateKey || process.env.POP_PRIVATE_KEY;
+            if (!privateKey)
+                throw new Error('No private key. Set POP_PRIVATE_KEY or pass --private-key.');
+            const pk = (privateKey.startsWith('0x') ? privateKey : `0x${privateKey}`);
+            const account = (0, accounts_1.privateKeyToAccount)(pk);
+            const rpcUrl = argv.rpc || 'https://rpc.gnosischain.com';
+            const publicClient = (0, viem_1.createPublicClient)({ chain: chains_1.gnosis, transport: (0, viem_1.http)(rpcUrl) });
+            const walletClient = (0, viem_1.createWalletClient)({ account, chain: chains_1.gnosis, transport: (0, viem_1.http)(rpcUrl) });
+            const orgId = argv.orgId;
+            const hatId = BigInt(argv.hatId);
+            const subjectKey = (0, viem_1.pad)((0, viem_1.toHex)(hatId), { size: 32 });
+            const budgetWei = BigInt(Math.floor(argv.budgetPerDay * 1e18));
+            const pmAbi = require('../../abi/PaymasterHub.json');
+            const results = {};
+            // Step 1: Check and set up EIP-7702 delegation
+            spin.text = 'Step 1/3: Checking EIP-7702 delegation...';
+            const delegated = await (0, sponsored_1.isDelegated)(account.address);
+            if (delegated) {
+                results.delegation = 'already delegated';
+            }
+            else {
+                if (argv.dryRun) {
+                    results.delegation = 'would delegate (dry-run)';
+                }
+                else {
+                    const hash = await (0, sponsored_1.delegateEOA)(pk, rpcUrl);
+                    await publicClient.waitForTransactionReceipt({ hash });
+                    results.delegation = `delegated (tx: ${hash})`;
+                }
+            }
+            // Step 2: Check and set hat budget
+            spin.text = 'Step 2/3: Checking hat budget...';
+            const budget = await publicClient.readContract({
+                address: sponsored_1.PAYMASTER_HUB,
+                abi: pmAbi,
+                functionName: 'getBudget',
+                args: [orgId, subjectKey],
+            });
+            if (budget.capPerEpoch > 0n) {
+                results.budget = `already set (${(Number(budget.capPerEpoch) / 1e18).toFixed(4)} xDAI/epoch, ${budget.epochLen}s epoch)`;
+            }
+            else {
+                if (argv.dryRun) {
+                    results.budget = `would set ${(Number(budgetWei) / 1e18).toFixed(4)} xDAI/day (dry-run)`;
+                }
+                else {
+                    const hash = await walletClient.writeContract({
+                        address: sponsored_1.PAYMASTER_HUB,
+                        abi: pmAbi,
+                        functionName: 'setBudget',
+                        args: [orgId, subjectKey, budgetWei, 86400],
+                    });
+                    await publicClient.waitForTransactionReceipt({ hash });
+                    results.budget = `set to ${(Number(budgetWei) / 1e18).toFixed(4)} xDAI/day (tx: ${hash})`;
+                }
+            }
+            // Step 3: Check and raise fee caps if needed
+            spin.text = 'Step 3/3: Checking fee caps...';
+            const caps = await publicClient.readContract({
+                address: sponsored_1.PAYMASTER_HUB,
+                abi: pmAbi,
+                functionName: 'getFeeCaps',
+                args: [orgId],
+            });
+            const needsRaise = caps.maxCallGas < 1000000 || caps.maxVerificationGas < 1000000 || caps.maxPreVerificationGas < 200000;
+            if (!needsRaise) {
+                results.feeCaps = `OK (callGas: ${caps.maxCallGas}, verGas: ${caps.maxVerificationGas}, preVerGas: ${caps.maxPreVerificationGas})`;
+            }
+            else {
+                const newCaps = {
+                    maxFeePerGas: caps.maxFeePerGas > 50000000000n ? caps.maxFeePerGas : 50000000000n,
+                    maxPriorityFeePerGas: caps.maxPriorityFeePerGas > 10000000000n ? caps.maxPriorityFeePerGas : 10000000000n,
+                    maxCallGas: Math.max(caps.maxCallGas, 2000000),
+                    maxVerificationGas: Math.max(caps.maxVerificationGas, 1500000),
+                    maxPreVerificationGas: Math.max(caps.maxPreVerificationGas, 500000),
+                };
+                if (argv.dryRun) {
+                    results.feeCaps = `would raise caps (dry-run)`;
+                }
+                else {
+                    const hash = await walletClient.writeContract({
+                        address: sponsored_1.PAYMASTER_HUB,
+                        abi: pmAbi,
+                        functionName: 'setFeeCaps',
+                        args: [orgId, newCaps.maxFeePerGas, newCaps.maxPriorityFeePerGas, newCaps.maxCallGas, newCaps.maxVerificationGas, newCaps.maxPreVerificationGas],
+                    });
+                    await publicClient.waitForTransactionReceipt({ hash });
+                    results.feeCaps = `raised (tx: ${hash})`;
+                }
+            }
+            spin.stop();
+            output.success('Gas sponsorship setup complete', {
+                agent: account.address,
+                ...results,
+                nextStep: 'Add POP_ORG_ID, POP_HAT_ID, and PIMLICO_API_KEY to .env',
+            });
+        }
+        catch (err) {
+            spin.stop();
+            output.error(err.message);
+            process.exit(1);
+        }
+    },
+};

package/dist/commands/agent/status.d.ts

@@ -0,0 +1,12 @@
+import type { Argv, ArgumentsCamelCase } from 'yargs';
+interface StatusArgs {
+    org?: string;
+    chain?: number;
+    rpc?: string;
+    'private-key'?: string;
+}
+export declare const agentStatusHandler: {
+    builder: (yargs: Argv) => Argv<{}>;
+    handler: (argv: ArgumentsCamelCase<StatusArgs>) => Promise<void>;
+};
+export {};

package/dist/commands/agent/status.js

@@ -0,0 +1,171 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.agentStatusHandler = void 0;
+const ethers_1 = require("ethers");
+const subgraph_1 = require("@poa-box/cli/lib/subgraph");
+const resolve_1 = require("@poa-box/cli/lib/resolve");
+const networks_1 = require("@poa-box/cli/config/networks");
+const output = __importStar(require("@poa-box/cli/lib/output"));
+const FETCH_AGENT_DATA = `
+  query FetchAgentData($orgId: Bytes!) {
+    organization(id: $orgId) {
+      name
+      participationToken { totalSupply }
+      users(first: 100) {
+        address
+        participationTokenBalance
+        membershipStatus
+        totalTasksCompleted
+        totalVotes
+        account { username }
+      }
+      hybridVoting {
+        proposals(where: { status: "Active" }, first: 50) {
+          proposalId
+          title
+          status
+          votes { voter }
+        }
+      }
+      taskManager {
+        projects(where: { deleted: false }, first: 100) {
+          tasks(first: 1000) {
+            id
+            status
+            assignee
+          }
+        }
+      }
+    }
+  }
+`;
+exports.agentStatusHandler = {
+    builder: (yargs) => yargs,
+    handler: async (argv) => {
+        const spin = output.spinner('Fetching agent status...');
+        spin.start();
+        try {
+            // Get wallet address
+            const key = argv.privateKey || process.env.POP_PRIVATE_KEY;
+            if (!key)
+                throw new Error('No private key configured');
+            const wallet = new ethers_1.ethers.Wallet(key);
+            const myAddr = wallet.address.toLowerCase();
+            // Get gas balance
+            const networkConfig = (0, networks_1.resolveNetworkConfig)(argv.chain);
+            const provider = new ethers_1.ethers.providers.JsonRpcProvider(networkConfig.resolvedRpc);
+            const gasBalance = await provider.getBalance(wallet.address);
+            // Get org data
+            const modules = await (0, resolve_1.resolveOrgModules)(argv.org, argv.chain);
+            const result = await (0, subgraph_1.query)(FETCH_AGENT_DATA, { orgId: modules.orgId }, argv.chain);
+            const org = result.organization;
+            if (!org)
+                throw new Error('Organization not found');
+            // Find my user
+            const me = org.users.find((u) => u.address?.toLowerCase() === myAddr);
+            const totalSupply = ethers_1.ethers.BigNumber.from(org.participationToken?.totalSupply || '0');
+            const myPT = ethers_1.ethers.BigNumber.from(me?.participationTokenBalance || '0');
+            const sharePercent = totalSupply.gt(0) ? myPT.mul(10000).div(totalSupply).toNumber() / 100 : 0;
+            // Count active proposals I haven't voted on
+            const activeProposals = org.hybridVoting?.proposals || [];
+            const unvoted = activeProposals.filter((p) => !(p.votes || []).some((v) => v.voter?.toLowerCase() === myAddr));
+            // Count my tasks
+            const allTasks = (org.taskManager?.projects || []).flatMap((p) => p.tasks || []);
+            const myAssigned = allTasks.filter((t) => t.assignee?.toLowerCase() === myAddr && t.status === 'Assigned');
+            const mySubmitted = allTasks.filter((t) => t.assignee?.toLowerCase() === myAddr && t.status === 'Submitted');
+            const awaitingMyReview = allTasks.filter((t) => t.status === 'Submitted' && t.assignee?.toLowerCase() !== myAddr);
+            const data = {
+                wallet: wallet.address,
+                username: me?.account?.username || 'unregistered',
+                org: org.name,
+                gas: ethers_1.ethers.utils.formatEther(gasBalance),
+                gasCurrency: networkConfig.nativeCurrency.symbol,
+                pt: ethers_1.ethers.utils.formatEther(myPT),
+                ptShare: `${sharePercent.toFixed(1)}%`,
+                tasksCompleted: parseInt(me?.totalTasksCompleted || '0'),
+                votesCast: parseInt(me?.totalVotes || '0'),
+                memberStatus: me?.membershipStatus || 'Not a member',
+                unvotedProposals: unvoted.length,
+                myAssigned: myAssigned.length,
+                mySubmitted: mySubmitted.length,
+                awaitingMyReview: awaitingMyReview.length,
+            };
+            spin.stop();
+            if (output.isJsonMode()) {
+                output.json(data);
+            }
+            else {
+                console.log('');
+                console.log(`  Agent Status — ${data.username}`);
+                console.log('  ─────────────────────────────');
+                console.log(`  Wallet:       ${data.wallet}`);
+                console.log(`  Org:          ${data.org}`);
+                console.log(`  Status:       ${data.memberStatus}`);
+                console.log(`  Gas:          ${data.gas} ${data.gasCurrency}`);
+                console.log('');
+                console.log(`  PT:           ${data.pt} (${data.ptShare} of supply)`);
+                console.log(`  Tasks done:   ${data.tasksCompleted}`);
+                console.log(`  Votes cast:   ${data.votesCast}`);
+                console.log('');
+                // Action items
+                const actions = [];
+                if (data.unvotedProposals > 0)
+                    actions.push(`${data.unvotedProposals} proposal(s) need your vote`);
+                if (data.awaitingMyReview > 0)
+                    actions.push(`${data.awaitingMyReview} task(s) await your review`);
+                if (data.myAssigned > 0)
+                    actions.push(`${data.myAssigned} task(s) assigned to you`);
+                if (data.mySubmitted > 0)
+                    actions.push(`${data.mySubmitted} task(s) submitted, awaiting review`);
+                if (parseFloat(data.gas) < 0.01)
+                    actions.push('LOW GAS — fund wallet');
+                if (actions.length > 0) {
+                    console.log('  Action items:');
+                    actions.forEach(a => console.log(`    - ${a}`));
+                }
+                else {
+                    console.log('  No pending actions.');
+                }
+                console.log('');
+            }
+        }
+        catch (err) {
+            spin.stop();
+            output.error(err.message);
+            process.exit(1);
+        }
+    },
+};

package/dist/commands/agent/triage.d.ts

@@ -0,0 +1,12 @@
+import type { Argv, ArgumentsCamelCase } from 'yargs';
+interface TriageArgs {
+    org?: string;
+    chain?: number;
+    rpc?: string;
+    'private-key'?: string;
+}
+export declare const triageHandler: {
+    builder: (yargs: Argv) => Argv<{}>;
+    handler: (argv: ArgumentsCamelCase<TriageArgs>) => Promise<void>;
+};
+export {};