netlibrary-cli 1.0.0

package/commands/tasks.js

@@ -0,0 +1,78 @@
+const api = require('../lib/api');
+const output = require('../lib/output');
+
+module.exports = function (program) {
+  const cmd = program.command('tasks').description('Task queue management');
+
+  cmd
+    .command('list')
+    .description('Poll for pending tasks')
+    .option('-s, --status <status>', 'Filter: pending, in_progress, completed, failed', 'pending')
+    .option('-t, --type <type>', 'Filter by task type')
+    .option('-l, --limit <n>', 'Max tasks (max 20)', '10')
+    .action(async (opts) => {
+      try {
+        const data = await api.get('/agents/tasks', {
+          query: {
+            status: opts.status,
+            type: opts.type,
+            limit: opts.limit,
+          },
+        });
+
+        if (output.isJsonMode()) {
+          output.json(data);
+          return;
+        }
+
+        output.table(
+          ['ID', 'Type', 'Status', 'Created', 'Preview'],
+          (data.tasks || []).map(t => [
+            t.id,
+            t.type || '—',
+            t.status,
+            t.createdAt ? new Date(t.createdAt).toLocaleString() : '—',
+            t.data?.castText?.slice(0, 50) || t.data?.authorUsername || '—',
+          ])
+        );
+
+        if (data.hasMore) {
+          console.log(`\nShowing ${data.tasks?.length}/${data.totalCount} tasks`);
+        }
+      } catch (err) {
+        output.error(err.message);
+        process.exit(1);
+      }
+    });
+
+  cmd
+    .command('update <taskId> <status>')
+    .description('Update task status (in_progress, completed, failed)')
+    .option('--action <action>', 'Action taken (for completed/failed)')
+    .option('--details <details>', 'Result details')
+    .option('--error <error>', 'Error message (for failed)')
+    .action(async (taskId, status, opts) => {
+      try {
+        const validStatuses = ['in_progress', 'completed', 'failed'];
+        if (!validStatuses.includes(status)) {
+          output.error(`Invalid status. Choose: ${validStatuses.join(', ')}`);
+          process.exit(1);
+        }
+
+        const body = { taskId, status };
+        if (opts.action || opts.details || opts.error) {
+          body.result = {};
+          if (opts.action) body.result.action = opts.action;
+          if (opts.details) body.result.details = opts.details;
+          if (opts.error) body.result.error = opts.error;
+        }
+
+        const data = await api.put('/agents/tasks', body);
+        output.success(`Task ${taskId} → ${status}`);
+        if (output.isJsonMode()) output.json(data);
+      } catch (err) {
+        output.error(err.message);
+        process.exit(1);
+      }
+    });
+};

package/lib/api.js

@@ -0,0 +1,58 @@
+const config = require('./config');
+
+async function request(method, path, { body, query, headers: extraHeaders, auth = true } = {}) {
+  const cfg = config.load();
+  const baseUrl = process.env.NETLIB_BASE_URL || cfg.baseUrl;
+  const apiKey = process.env.NETLIB_API_KEY || cfg.apiKey;
+
+  // Concatenate baseUrl + path directly (URL constructor ignores base path with absolute paths)
+  const fullUrl = baseUrl.replace(/\/$/, '') + (path.startsWith('/') ? path : `/${path}`);
+  const url = new URL(fullUrl);
+  if (query) {
+    for (const [k, v] of Object.entries(query)) {
+      if (v !== undefined && v !== null) url.searchParams.set(k, String(v));
+    }
+  }
+
+  const headers = { ...extraHeaders };
+  if (auth && apiKey) {
+    headers['Authorization'] = `Bearer ${apiKey}`;
+  }
+
+  const fetchOpts = { method, headers };
+
+  if (body && typeof body === 'object' && typeof body.append === 'function') {
+    // FormData — let fetch set Content-Type with boundary
+    fetchOpts.body = body;
+  } else if (body) {
+    headers['Content-Type'] = 'application/json';
+    fetchOpts.body = JSON.stringify(body);
+  }
+
+  const res = await fetch(url.toString(), fetchOpts);
+  const text = await res.text();
+
+  let data;
+  try {
+    data = JSON.parse(text);
+  } catch {
+    data = { raw: text };
+  }
+
+  if (!res.ok) {
+    const msg = data?.error || data?.message || `HTTP ${res.status}`;
+    const err = new Error(msg);
+    err.status = res.status;
+    err.data = data;
+    throw err;
+  }
+
+  return data;
+}
+
+const get = (path, opts) => request('GET', path, { ...opts });
+const post = (path, body, opts) => request('POST', path, { body, ...opts });
+const put = (path, body, opts) => request('PUT', path, { body, ...opts });
+const del = (path, body, opts) => request('DELETE', path, { body, ...opts });
+
+module.exports = { request, get, post, put, del };

package/lib/config.js

@@ -0,0 +1,39 @@
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
+
+const CONFIG_DIR = path.join(os.homedir(), '.config', 'netlibrary');
+const CONFIG_FILE = path.join(CONFIG_DIR, 'config.json');
+
+const DEFAULTS = {
+  baseUrl: 'https://miniapp-generator-fid-282520-251210015136529.neynar.app/api/v1',
+  rpcUrl: 'https://base-mainnet.public.blastapi.io',
+};
+
+const VALID_KEYS = ['apiKey', 'baseUrl', 'wallet', 'rpcUrl', 'adminKey'];
+
+function load() {
+  try {
+    const raw = fs.readFileSync(CONFIG_FILE, 'utf8');
+    return { ...DEFAULTS, ...JSON.parse(raw) };
+  } catch {
+    return { ...DEFAULTS };
+  }
+}
+
+function save(config) {
+  fs.mkdirSync(CONFIG_DIR, { recursive: true });
+  fs.writeFileSync(CONFIG_FILE, JSON.stringify(config, null, 2) + '\n');
+}
+
+function get(key) {
+  return load()[key];
+}
+
+function set(key, value) {
+  const config = load();
+  config[key] = value;
+  save(config);
+}
+
+module.exports = { load, save, get, set, CONFIG_FILE, VALID_KEYS };

package/lib/output.js

@@ -0,0 +1,66 @@
+const chalk = require('chalk');
+const Table = require('cli-table3');
+
+let jsonMode = false;
+
+function setJsonMode(val) { jsonMode = !!val; }
+function isJsonMode() { return jsonMode; }
+
+function json(data) {
+  console.log(JSON.stringify(data, null, 2));
+}
+
+function success(msg) {
+  if (jsonMode) return json({ success: true, message: msg });
+  console.log(chalk.green('✓'), msg);
+}
+
+function error(msg) {
+  if (jsonMode) {
+    console.error(JSON.stringify({ error: msg }));
+  } else {
+    console.error(chalk.red('✗'), msg);
+  }
+}
+
+function warn(msg) {
+  if (!jsonMode) console.log(chalk.yellow('!'), msg);
+}
+
+function table(headers, rows, opts = {}) {
+  if (jsonMode) {
+    return json(rows.map(r =>
+      headers.reduce((o, h, i) => ({ ...o, [h]: r[i] }), {})
+    ));
+  }
+  if (rows.length === 0) {
+    console.log(chalk.dim('No results.'));
+    return;
+  }
+  const t = new Table({
+    head: headers.map(h => chalk.cyan(h)),
+    style: { head: [], border: [] },
+    wordWrap: true,
+    ...opts,
+  });
+  rows.forEach(r => t.push(r));
+  console.log(t.toString());
+}
+
+function item(data, fields) {
+  if (jsonMode) return json(data);
+  const t = new Table({ style: { head: [], border: [] } });
+  fields.forEach(([label, key, transform]) => {
+    const val = typeof key === 'function' ? key(data) : data[key];
+    const display = transform ? transform(val) : (val ?? chalk.dim('—'));
+    t.push({ [chalk.cyan(label)]: String(display) });
+  });
+  console.log(t.toString());
+}
+
+function pagination(p) {
+  if (jsonMode || !p) return;
+  console.log(chalk.dim(`\nPage ${p.page}/${p.totalPages || '?'} (${p.total} total)`));
+}
+
+module.exports = { setJsonMode, isJsonMode, json, success, error, warn, table, item, pagination };

package/lib/payment.js

@@ -0,0 +1,114 @@
+const { execSync } = require('child_process');
+const readline = require('readline');
+const chalk = require('chalk');
+const config = require('./config');
+const output = require('./output');
+
+const USDC_CONTRACT = '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913';
+const TREASURY = '0xAcAD71e697Ef3bb148093b2DD2fCf0845e957627';
+
+function usdcAmount(dollars) {
+  return (dollars * 1_000_000).toString();
+}
+
+function hasCast() {
+  try {
+    execSync('which cast', { encoding: 'utf8', stdio: 'pipe' });
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+async function confirm(message) {
+  if (output.isJsonMode()) return true;
+  const rl = readline.createInterface({
+    input: process.stdin,
+    output: process.stderr,
+  });
+  return new Promise((resolve) => {
+    rl.question(`${message} (y/N) `, (answer) => {
+      rl.close();
+      resolve(answer.toLowerCase() === 'y');
+    });
+  });
+}
+
+/**
+ * Handle USDC payment. Returns txHash.
+ *
+ * If --tx-hash is provided, use that directly.
+ * If Foundry's `cast` is available, send via cast.
+ * Otherwise, show manual payment instructions.
+ */
+async function handlePayment(amountUsd, opts = {}) {
+  // If user already provided a tx hash, just return it
+  if (opts.txHash) return opts.txHash;
+
+  const cfg = config.load();
+  const wallet = opts.wallet || process.env.NETLIB_WALLET || cfg.wallet;
+  const rpcUrl = opts.rpcUrl || process.env.BASE_RPC_URL || cfg.rpcUrl;
+
+  if (!hasCast()) {
+    // No Foundry — show manual instructions
+    console.log('');
+    console.log(chalk.yellow(`Send $${amountUsd} USDC to the Net Library treasury on Base:`));
+    console.log('');
+    console.log(`  Treasury: ${chalk.cyan(TREASURY)}`);
+    console.log(`  USDC:     ${chalk.cyan(USDC_CONTRACT)}`);
+    console.log(`  Amount:   ${chalk.green(`${amountUsd} USDC`)} (${usdcAmount(amountUsd)} raw)`);
+    console.log(`  Chain:    Base (8453)`);
+    console.log('');
+    console.log(`After sending, re-run this command with ${chalk.cyan('--tx-hash <hash>')}`);
+    process.exit(0);
+  }
+
+  if (!wallet) {
+    throw new Error('No wallet configured. Run: netlibrary config set wallet <address>');
+  }
+
+  const ok = await confirm(
+    `This will send $${amountUsd} USDC from ${wallet} to the Net Library treasury. Proceed?`
+  );
+  if (!ok) {
+    console.log('Cancelled.');
+    process.exit(0);
+  }
+
+  const amount = usdcAmount(amountUsd);
+  const cmd = [
+    'cast', 'send', USDC_CONTRACT,
+    '"transfer(address,uint256)"',
+    TREASURY, amount,
+    '--rpc-url', rpcUrl,
+    '--json',
+  ];
+
+  const pk = opts.privateKey || process.env.PRIVATE_KEY;
+  if (pk) {
+    cmd.push('--private-key', pk);
+  } else {
+    cmd.push('--from', wallet);
+  }
+
+  if (!output.isJsonMode()) {
+    console.log(chalk.dim(`Sending $${amountUsd} USDC to treasury...`));
+  }
+
+  try {
+    const result = execSync(cmd.join(' '), {
+      encoding: 'utf8',
+      timeout: 120000,
+    });
+    const parsed = JSON.parse(result);
+    const txHash = parsed.transactionHash;
+    if (!output.isJsonMode()) {
+      console.log(chalk.green('✓'), `Payment sent: ${txHash}`);
+    }
+    return txHash;
+  } catch (err) {
+    throw new Error(`Payment failed: ${err.message}`);
+  }
+}
+
+module.exports = { handlePayment, USDC_CONTRACT, TREASURY, usdcAmount, confirm };

package/package.json

@@ -0,0 +1,28 @@
+{
+  "name": "netlibrary-cli",
+  "version": "1.0.0",
+  "description": "CLI for Net Library — the decentralized digital library on Base",
+  "bin": {
+    "netlibrary": "bin/netlibrary.js"
+  },
+  "keywords": [
+    "net-library",
+    "netlibrary",
+    "web3",
+    "base",
+    "decentralized",
+    "library",
+    "cli",
+    "onchain"
+  ],
+  "author": "Net Library",
+  "license": "MIT",
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "dependencies": {
+    "chalk": "^4.1.2",
+    "cli-table3": "^0.6.5",
+    "commander": "^12.0.0"
+  }
+}