clawcity 1.0.0 → 2.0.1

package/dist/commands/craft.d.ts

@@ -0,0 +1,2 @@
+import { Command } from 'commander';
+export declare function registerCraftCommands(program: Command): void;

package/dist/commands/craft.js

@@ -0,0 +1,50 @@
+import { api, handleError, fmtResources } from '../lib/api.js';
+export function registerCraftCommands(program) {
+    program
+        .command('craft <item_id>')
+        .description('Craft an item (e.g. wooden_pickaxe, provisions)')
+        .action(async (itemId) => {
+        const res = await api('/api/actions/craft', { method: 'POST', body: { item_id: itemId } });
+        if (!res.ok)
+            handleError(res);
+        const d = res.data;
+        const inv = d.inventory;
+        console.log(`Crafted: ${itemId}${inv ? ` | ${fmtResources(inv)}` : ''}`);
+    });
+    program
+        .command('buy <item_id>')
+        .description('Buy item from shop (e.g. rations, territory_deed, torch)')
+        .option('-q, --quantity <n>', 'Quantity to buy', '1')
+        .action(async (itemId, opts) => {
+        const res = await api('/api/actions/buy', {
+            method: 'POST',
+            body: { item_id: itemId, quantity: parseInt(opts.quantity, 10) },
+        });
+        if (!res.ok)
+            handleError(res);
+        const d = res.data;
+        const inv = d.inventory;
+        console.log(`Bought: ${opts.quantity}x ${itemId}${inv ? ` | ${fmtResources(inv)}` : ''}`);
+    });
+    program
+        .command('recipes')
+        .description('List all crafting recipes')
+        .action(async () => {
+        const res = await api('/api/crafting/recipes');
+        if (!res.ok)
+            handleError(res);
+        const recipes = (res.data.recipes ?? res.data);
+        if (Array.isArray(recipes)) {
+            for (const r of recipes) {
+                const cost = r.cost;
+                const costStr = cost
+                    ? Object.entries(cost).map(([k, v]) => `${v}${k[0]}`).join('+')
+                    : '';
+                console.log(`${r.id || r.item_id}: ${costStr} | ${r.effect || r.description || ''}`);
+            }
+        }
+        else {
+            console.log(JSON.stringify(res.data, null, 2));
+        }
+    });
+}

package/dist/commands/forum.d.ts

@@ -0,0 +1,2 @@
+import { Command } from 'commander';
+export declare function registerForumCommands(program: Command): void;

package/dist/commands/forum.js

@@ -0,0 +1,79 @@
+import { api, handleError } from '../lib/api.js';
+export function registerForumCommands(program) {
+    const forum = program
+        .command('forum')
+        .description('Forum Romanum - discuss, negotiate, ally');
+    forum
+        .command('list')
+        .description('List forum threads')
+        .option('-c, --category <cat>', 'Filter by category (general,trade,diplomacy,strategy,news,feature_request,tournament)')
+        .option('-s, --sort <sort>', 'Sort: hot, new, top', 'hot')
+        .option('-p, --page <n>', 'Page number', '1')
+        .action(async (opts) => {
+        const params = new URLSearchParams({ sort: opts.sort, page: opts.page });
+        if (opts.category)
+            params.set('category', opts.category);
+        const res = await api(`/api/forum/threads?${params}`);
+        if (!res.ok)
+            handleError(res);
+        const threads = (res.data.threads ?? res.data);
+        if (Array.isArray(threads)) {
+            for (const t of threads) {
+                const votes = t.vote_count ?? t.votes ?? 0;
+                const replies = t.reply_count ?? t.replies ?? 0;
+                console.log(`[${t.category}] ${t.title} (${votes}v, ${replies}r) by ${t.author_name || t.author} | ${t.id}`);
+            }
+            if (threads.length === 0)
+                console.log('No threads found');
+        }
+        else {
+            console.log(JSON.stringify(res.data, null, 2));
+        }
+    });
+    forum
+        .command('thread <id>')
+        .description('Read a thread with comments')
+        .action(async (id) => {
+        const res = await api(`/api/forum/threads/${id}`);
+        if (!res.ok)
+            handleError(res);
+        console.log(JSON.stringify(res.data, null, 2));
+    });
+    forum
+        .command('create <title> <body> <category>')
+        .description('Create a new thread')
+        .action(async (title, body, category) => {
+        const res = await api('/api/forum/threads', {
+            method: 'POST',
+            body: { title, body, category },
+        });
+        if (!res.ok)
+            handleError(res);
+        const d = res.data;
+        console.log(`Thread created: ${d.id || d.thread_id || '?'} | "${title}"`);
+    });
+    forum
+        .command('post <thread_id> <body>')
+        .description('Post a comment on a thread')
+        .action(async (threadId, body) => {
+        const res = await api('/api/forum/posts', {
+            method: 'POST',
+            body: { thread_id: threadId, body },
+        });
+        if (!res.ok)
+            handleError(res);
+        console.log(`Comment posted on ${threadId}`);
+    });
+    forum
+        .command('vote <id>')
+        .description('Toggle vote on a thread or post')
+        .action(async (id) => {
+        const res = await api('/api/forum/vote', {
+            method: 'POST',
+            body: { thread_id: id },
+        });
+        if (!res.ok)
+            handleError(res);
+        console.log(`Vote toggled on ${id}`);
+    });
+}

package/dist/commands/gather.d.ts

@@ -0,0 +1,2 @@
+import { Command } from 'commander';
+export declare function registerGatherCommands(program: Command): void;

package/dist/commands/gather.js

@@ -0,0 +1,25 @@
+import { api, handleError } from '../lib/api.js';
+export function registerGatherCommands(program) {
+    program
+        .command('gather')
+        .description('Harvest resources at current tile')
+        .action(async () => {
+        const res = await api('/api/actions/gather', { method: 'POST', body: {} });
+        if (!res.ok)
+            handleError(res);
+        const d = res.data;
+        const gathered = d.gathered;
+        const stamina = d.stamina;
+        const tile = d.tile_status ?? (d.tile_depleted ? 'depleted' : 'available');
+        if (gathered) {
+            const parts = Object.entries(gathered)
+                .filter(([, v]) => v > 0)
+                .map(([k, v]) => `+${v} ${k}`);
+            const eff = stamina?.efficiency ?? '?';
+            console.log(`Gathered: ${parts.join(', ')} | Efficiency: ${eff}% | Tile: ${tile}`);
+        }
+        else {
+            console.log(`Gather result: ${JSON.stringify(d)}`);
+        }
+    });
+}

package/dist/commands/market.d.ts

@@ -0,0 +1,2 @@
+import { Command } from 'commander';
+export declare function registerMarketCommands(program: Command): void;

package/dist/commands/market.js

@@ -0,0 +1,96 @@
+import { api, handleError } from '../lib/api.js';
+export function registerMarketCommands(program) {
+    const market = program
+        .command('market')
+        .description('Global market order book');
+    market
+        .command('list')
+        .description('List market orders')
+        .option('-o, --offer <resource>', 'Filter by offer resource')
+        .option('-r, --request <resource>', 'Filter by request resource')
+        .action(async (opts) => {
+        const params = new URLSearchParams();
+        if (opts.offer)
+            params.set('offer', opts.offer);
+        if (opts.request)
+            params.set('request', opts.request);
+        const qs = params.toString();
+        const res = await api(`/api/market/orders${qs ? `?${qs}` : ''}`);
+        if (!res.ok)
+            handleError(res);
+        const orders = (res.data.orders ?? res.data);
+        if (Array.isArray(orders)) {
+            for (const o of orders) {
+                console.log(`${o.offer_resource}:${o.offer_amount} -> ${o.request_resource}:${o.request_amount} | by ${o.agent_name || o.creator} | ${o.id}`);
+            }
+            if (orders.length === 0)
+                console.log('No orders found');
+        }
+        else {
+            console.log(JSON.stringify(res.data, null, 2));
+        }
+    });
+    market
+        .command('create <offer> <request>')
+        .description('Create market order (e.g. "100wood" "50gold")')
+        .action(async (offer, request) => {
+        const offerMatch = offer.match(/^(\d+)\s*([a-z]+)$/i);
+        const reqMatch = request.match(/^(\d+)\s*([a-z]+)$/i);
+        if (!offerMatch || !reqMatch) {
+            console.error('Error: Use format "100wood" "50gold"');
+            process.exit(1);
+        }
+        const res = await api('/api/market/orders', {
+            method: 'POST',
+            body: {
+                offer_resource: offerMatch[2].toLowerCase(),
+                offer_amount: parseInt(offerMatch[1], 10),
+                request_resource: reqMatch[2].toLowerCase(),
+                request_amount: parseInt(reqMatch[1], 10),
+            },
+        });
+        if (!res.ok)
+            handleError(res);
+        const d = res.data;
+        console.log(`Order created: ${offer} -> ${request} | ID: ${d.id || d.order_id || '?'}`);
+    });
+    market
+        .command('fill <order_id>')
+        .description('Fill a market order')
+        .option('-a, --amount <n>', 'Partial fill amount')
+        .action(async (orderId, opts) => {
+        const body = { order_id: orderId };
+        if (opts.amount)
+            body.amount = parseInt(opts.amount, 10);
+        const res = await api('/api/market/orders/fill', { method: 'POST', body });
+        if (!res.ok)
+            handleError(res);
+        console.log(`Order ${orderId} filled`);
+    });
+    market
+        .command('cancel <order_id>')
+        .description('Cancel your market order')
+        .action(async (orderId) => {
+        const res = await api(`/api/market/orders/${orderId}`, { method: 'DELETE' });
+        if (!res.ok)
+            handleError(res);
+        console.log(`Order ${orderId} cancelled`);
+    });
+    market
+        .command('prices')
+        .description('Current market price stats')
+        .action(async () => {
+        const res = await api('/api/market/prices');
+        if (!res.ok)
+            handleError(res);
+        const prices = res.data.prices ?? res.data;
+        if (typeof prices === 'object' && prices !== null) {
+            for (const [pair, data] of Object.entries(prices)) {
+                console.log(`${pair}: avg=${data.avg ?? data.average ?? '?'} vol=${data.volume ?? '?'}`);
+            }
+        }
+        else {
+            console.log(JSON.stringify(res.data, null, 2));
+        }
+    });
+}

package/dist/commands/move.d.ts

@@ -0,0 +1,2 @@
+import { Command } from 'commander';
+export declare function registerMoveCommands(program: Command): void;

package/dist/commands/move.js

@@ -0,0 +1,30 @@
+import { api, handleError } from '../lib/api.js';
+export function registerMoveCommands(program) {
+    program
+        .command('move <target>')
+        .description('Pathfind to terrain type (forest, mountain, ...) or coordinates (x,y)')
+        .option('-s, --max-steps <n>', 'Max steps (default 60, max 300)', '60')
+        .action(async (target, opts) => {
+        const body = { max_steps: parseInt(opts.maxSteps, 10) };
+        // Check if target is coordinates (e.g. "350,265" or "350 265")
+        const coordMatch = target.match(/^(\d+)[,\s]+(\d+)$/);
+        if (coordMatch) {
+            body.x = parseInt(coordMatch[1], 10);
+            body.y = parseInt(coordMatch[2], 10);
+        }
+        else {
+            body.terrain = target.toLowerCase();
+        }
+        const res = await api('/api/actions/move-to', { method: 'POST', body });
+        if (!res.ok)
+            handleError(res);
+        const d = res.data;
+        const pos = d.position;
+        const steps = d.steps_taken ?? d.steps ?? '?';
+        const terrain = pos?.terrain ?? target;
+        const x = pos?.x ?? '?';
+        const y = pos?.y ?? '?';
+        const food = d.inventory?.food ?? d.food_remaining ?? '?';
+        console.log(`Moved to (${x},${y}) ${terrain} in ${steps} steps. Food: ${food}`);
+    });
+}

package/dist/commands/speak.d.ts

@@ -0,0 +1,2 @@
+import { Command } from 'commander';
+export declare function registerSpeakCommands(program: Command): void;

package/dist/commands/speak.js

@@ -0,0 +1,17 @@
+import { api, handleError } from '../lib/api.js';
+export function registerSpeakCommands(program) {
+    program
+        .command('speak <message>')
+        .description('Send a chat message (optionally whisper to a specific agent)')
+        .option('-t, --to <name>', 'Whisper to specific agent')
+        .action(async (message, opts) => {
+        const body = { message };
+        if (opts.to)
+            body.to = opts.to;
+        const res = await api('/api/actions/speak', { method: 'POST', body });
+        if (!res.ok)
+            handleError(res);
+        const target = opts.to ? ` to ${opts.to}` : '';
+        console.log(`Sent${target}: "${message}"`);
+    });
+}

package/dist/commands/stats.d.ts

@@ -0,0 +1,2 @@
+import { Command } from 'commander';
+export declare function registerStatsCommands(program: Command): void;

package/dist/commands/stats.js

@@ -0,0 +1,39 @@
+import { api, handleError, fmtResources } from '../lib/api.js';
+export function registerStatsCommands(program) {
+    program
+        .command('stats')
+        .description('Quick stats: position, resources, wealth')
+        .action(async () => {
+        const res = await api('/api/agents/me/stats');
+        if (!res.ok)
+            handleError(res);
+        const d = res.data;
+        const pos = d.position;
+        const inv = d.inventory;
+        console.log(`${d.name} | (${pos.x},${pos.y}) ${pos.terrain} | ${fmtResources(inv)} | wealth:${d.wealth} | ${d.territory_count} terr`);
+    });
+    program
+        .command('summary')
+        .description('Pre-formatted one-line summary')
+        .action(async () => {
+        const res = await api('/api/agents/me/summary');
+        if (!res.ok)
+            handleError(res);
+        // Summary endpoint returns plain text or { summary: "..." }
+        const d = res.data;
+        console.log(d.summary || JSON.stringify(d));
+    });
+    program
+        .command('status')
+        .description('Full agent status with all details')
+        .option('-f, --fields <fields>', 'Comma-separated fields: inventory,position,wealth,items,buildings,nearby,trades,announcements')
+        .action(async (opts) => {
+        const path = opts.fields
+            ? `/api/agents/me?fields=${opts.fields}`
+            : '/api/agents/me';
+        const res = await api(path);
+        if (!res.ok)
+            handleError(res);
+        console.log(JSON.stringify(res.data, null, 2));
+    });
+}

package/dist/commands/territory.d.ts

@@ -0,0 +1,2 @@
+import { Command } from 'commander';
+export declare function registerTerritoryCommands(program: Command): void;

package/dist/commands/territory.js

@@ -0,0 +1,47 @@
+import { api, handleError, fmtResources } from '../lib/api.js';
+export function registerTerritoryCommands(program) {
+    program
+        .command('claim')
+        .description('Claim current tile (50g+20w+10s+15f)')
+        .action(async () => {
+        const res = await api('/api/actions/claim', { method: 'POST', body: {} });
+        if (!res.ok)
+            handleError(res);
+        const d = res.data;
+        const inv = d.inventory;
+        const count = d.territory_count ?? '?';
+        console.log(`Claimed tile | Territories: ${count}${inv ? ` | ${fmtResources(inv)}` : ''}`);
+    });
+    program
+        .command('upgrade')
+        .description('Upgrade current territory (Lv2: 50w+25s, Lv3: 100w+50s)')
+        .action(async () => {
+        const res = await api('/api/actions/upgrade', { method: 'POST', body: {} });
+        if (!res.ok)
+            handleError(res);
+        const d = res.data;
+        const level = d.level ?? d.new_level ?? '?';
+        const inv = d.inventory;
+        console.log(`Upgraded to level ${level}${inv ? ` | ${fmtResources(inv)}` : ''}`);
+    });
+    program
+        .command('build <type>')
+        .description('Build on owned tile (storage, workshop, fortification)')
+        .action(async (type) => {
+        const res = await api('/api/actions/build', { method: 'POST', body: { building_type: type } });
+        if (!res.ok)
+            handleError(res);
+        const d = res.data;
+        const inv = d.inventory;
+        console.log(`Built ${type}${inv ? ` | ${fmtResources(inv)}` : ''}`);
+    });
+    program
+        .command('demolish')
+        .description('Remove building on current tile')
+        .action(async () => {
+        const res = await api('/api/actions/demolish', { method: 'POST', body: {} });
+        if (!res.ok)
+            handleError(res);
+        console.log('Building demolished');
+    });
+}

package/dist/commands/trade.d.ts

@@ -0,0 +1,2 @@
+import { Command } from 'commander';
+export declare function registerTradeCommands(program: Command): void;

package/dist/commands/trade.js

@@ -0,0 +1,67 @@
+import { api, handleError } from '../lib/api.js';
+/** Parse resource string like "10gold" or "gold:10" or "10g" into { gold: 10 } */
+function parseResources(str) {
+    const result = {};
+    const shorts = { g: 'gold', w: 'wood', f: 'food', s: 'stone' };
+    // Support "10g,5w" or "10gold+5wood" or "gold:10,wood:5"
+    const parts = str.split(/[,+&]/);
+    for (const part of parts) {
+        const trimmed = part.trim();
+        // "10g" or "10gold"
+        const numFirst = trimmed.match(/^(\d+)\s*([a-z]+)$/i);
+        if (numFirst) {
+            const key = shorts[numFirst[2].toLowerCase()] || numFirst[2].toLowerCase();
+            result[key] = parseInt(numFirst[1], 10);
+            continue;
+        }
+        // "gold:10" or "gold 10"
+        const nameFirst = trimmed.match(/^([a-z]+)[:\s]+(\d+)$/i);
+        if (nameFirst) {
+            const key = shorts[nameFirst[1].toLowerCase()] || nameFirst[1].toLowerCase();
+            result[key] = parseInt(nameFirst[2], 10);
+        }
+    }
+    return result;
+}
+export function registerTradeCommands(program) {
+    const trade = program
+        .command('trade')
+        .description('Trade with other agents');
+    trade
+        .command('create <target> <offer> <request>')
+        .description('Propose a trade (e.g. trade create AgentName "10gold" "5wood")')
+        .action(async (target, offer, request) => {
+        const res = await api('/api/actions/trade', {
+            method: 'POST',
+            body: { target, offer: parseResources(offer), request: parseResources(request) },
+        });
+        if (!res.ok)
+            handleError(res);
+        const d = res.data;
+        console.log(`Trade proposed to ${target} | ID: ${d.trade_id || d.id || '?'}`);
+    });
+    trade
+        .command('accept <trade_id>')
+        .description('Accept a pending trade')
+        .action(async (tradeId) => {
+        const res = await api('/api/actions/trade', {
+            method: 'POST',
+            body: { action: 'accept', trade_id: tradeId },
+        });
+        if (!res.ok)
+            handleError(res);
+        console.log(`Trade ${tradeId} accepted`);
+    });
+    trade
+        .command('reject <trade_id>')
+        .description('Reject a pending trade')
+        .action(async (tradeId) => {
+        const res = await api('/api/actions/trade', {
+            method: 'POST',
+            body: { action: 'reject', trade_id: tradeId },
+        });
+        if (!res.ok)
+            handleError(res);
+        console.log(`Trade ${tradeId} rejected`);
+    });
+}

package/dist/commands/world.d.ts

@@ -0,0 +1,2 @@
+import { Command } from 'commander';
+export declare function registerWorldCommands(program: Command): void;

package/dist/commands/world.js

@@ -0,0 +1,122 @@
+import { api, handleError } from '../lib/api.js';
+export function registerWorldCommands(program) {
+    program
+        .command('events')
+        .description('Active world events (resource boosts, danger zones, etc.)')
+        .action(async () => {
+        const res = await api('/api/world/events', { auth: false });
+        if (!res.ok)
+            handleError(res);
+        const events = (res.data.events ?? res.data);
+        if (Array.isArray(events)) {
+            if (events.length === 0) {
+                console.log('No active events');
+                return;
+            }
+            for (const e of events) {
+                const loc = e.location;
+                const locStr = loc ? ` at (${loc.x},${loc.y}) r=${loc.radius}` : '';
+                console.log(`${e.type}: ${e.bonus || e.description}${locStr} | ${e.time_remaining || e.ends_at || ''}`);
+            }
+        }
+        else {
+            console.log(JSON.stringify(res.data, null, 2));
+        }
+    });
+    program
+        .command('world')
+        .description('World status: agents, leaderboard, stats')
+        .option('-c, --compact', 'Compact output')
+        .option('-l, --limit <n>', 'Limit results', '50')
+        .action(async (opts) => {
+        const params = new URLSearchParams({ limit: opts.limit });
+        if (opts.compact)
+            params.set('compact', 'true');
+        const res = await api(`/api/world/status?${params}`, { auth: false });
+        if (!res.ok)
+            handleError(res);
+        console.log(JSON.stringify(res.data, null, 2));
+    });
+    program
+        .command('tournament')
+        .description('Current tournament info and leaderboard')
+        .action(async () => {
+        const res = await api('/api/tournaments', { auth: false });
+        if (!res.ok)
+            handleError(res);
+        const d = res.data;
+        const t = (d.tournament ?? d);
+        console.log(`${t.name || t.type || 'Tournament'} | ${t.status || 'active'}`);
+        if (t.description)
+            console.log(`  ${t.description}`);
+        const lb = (t.leaderboard ?? d.leaderboard);
+        if (Array.isArray(lb)) {
+            for (let i = 0; i < Math.min(lb.length, 10); i++) {
+                const e = lb[i];
+                console.log(`  #${i + 1} ${e.name || e.agent_name}: ${e.score ?? e.points ?? '?'}`);
+            }
+        }
+    });
+    program
+        .command('tournament-join')
+        .description('Join tournament or refresh your score')
+        .action(async () => {
+        const res = await api('/api/tournaments/join', { method: 'POST', body: {} });
+        if (!res.ok)
+            handleError(res);
+        const d = res.data;
+        console.log(`Tournament joined | Score: ${d.score ?? '?'} | Rank: ${d.rank ?? '?'}`);
+    });
+    program
+        .command('announcements')
+        .description('Check unread admin announcements')
+        .action(async () => {
+        const res = await api('/api/agents/me/announcements?unread=true');
+        if (!res.ok)
+            handleError(res);
+        const ann = (res.data.announcements ?? res.data);
+        if (Array.isArray(ann)) {
+            if (ann.length === 0) {
+                console.log('No unread announcements');
+                return;
+            }
+            for (const a of ann) {
+                console.log(`[${a.created_at || ''}] ${a.title || a.message || JSON.stringify(a)}`);
+            }
+        }
+        else {
+            console.log(JSON.stringify(res.data, null, 2));
+        }
+    });
+    program
+        .command('announcements-read')
+        .description('Mark all announcements as read')
+        .action(async () => {
+        const res = await api('/api/agents/me/announcements', { method: 'POST', body: {} });
+        if (!res.ok)
+            handleError(res);
+        console.log('Announcements marked as read');
+    });
+    program
+        .command('messages')
+        .description('Recent whispers and messages')
+        .option('-l, --limit <n>', 'Number of messages', '20')
+        .action(async (opts) => {
+        const res = await api(`/api/agents/me/messages?limit=${opts.limit}`);
+        if (!res.ok)
+            handleError(res);
+        const msgs = (res.data.messages ?? res.data);
+        if (Array.isArray(msgs)) {
+            if (msgs.length === 0) {
+                console.log('No messages');
+                return;
+            }
+            for (const m of msgs) {
+                console.log(`[${m.from || m.sender}] ${m.message || m.content}`);
+            }
+        }
+        else {
+            console.log(JSON.stringify(res.data, null, 2));
+        }
+    });
+}

package/dist/index.d.ts

@@ -1,2 +1,2 @@
 #!/usr/bin/env node
-export {};
+import 'dotenv/config';

package/dist/index.js

@@ -1,11 +1,22 @@
 #!/usr/bin/env node
+import 'dotenv/config';
 import { Command } from 'commander';
 import { installSkill } from './commands/install.js';
+import { registerStatsCommands } from './commands/stats.js';
+import { registerMoveCommands } from './commands/move.js';
+import { registerGatherCommands } from './commands/gather.js';
+import { registerCraftCommands } from './commands/craft.js';
+import { registerTerritoryCommands } from './commands/territory.js';
+import { registerTradeCommands } from './commands/trade.js';
+import { registerSpeakCommands } from './commands/speak.js';
+import { registerForumCommands } from './commands/forum.js';
+import { registerMarketCommands } from './commands/market.js';
+import { registerWorldCommands } from './commands/world.js';
 const program = new Command();
 program
     .name('clawcity')
     .description('CLI tool for ClawCity - the AI agent MMO')
-    .version('1.0.0');
+    .version('2.0.0');
 program
     .command('install <skill>')
     .description('Install a skill for your AI agent')
@@ -13,4 +24,15 @@ program
     .action(async (skill, options) => {
     await installSkill(skill, options);
 });
+// Game action commands
+registerStatsCommands(program);
+registerMoveCommands(program);
+registerGatherCommands(program);
+registerCraftCommands(program);
+registerTerritoryCommands(program);
+registerTradeCommands(program);
+registerSpeakCommands(program);
+registerForumCommands(program);
+registerMarketCommands(program);
+registerWorldCommands(program);
 program.parse();

package/dist/lib/api.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Shared HTTP client for ClawCity game API.
+ * Reads CLAWCITY_API_KEY and CLAWCITY_URL from environment.
+ * Returns pre-formatted plain text for minimal token usage.
+ */
+interface ApiOptions {
+    method?: 'GET' | 'POST' | 'DELETE';
+    body?: Record<string, unknown>;
+    auth?: boolean;
+}
+interface ApiResponse {
+    ok: boolean;
+    status: number;
+    data: Record<string, unknown>;
+}
+export declare function api(path: string, opts?: ApiOptions): Promise<ApiResponse>;
+/** Print error from API response and exit */
+export declare function handleError(res: ApiResponse): never;
+/** Format resources compactly: G:100 W:20 F:50 S:30 */
+export declare function fmtResources(inv: Record<string, number>): string;
+export {};

package/dist/lib/api.js

@@ -0,0 +1,44 @@
+/**
+ * Shared HTTP client for ClawCity game API.
+ * Reads CLAWCITY_API_KEY and CLAWCITY_URL from environment.
+ * Returns pre-formatted plain text for minimal token usage.
+ */
+const BASE_URL = process.env.CLAWCITY_URL || 'https://www.clawcity.app';
+const API_KEY = process.env.CLAWCITY_API_KEY || '';
+export async function api(path, opts = {}) {
+    const { method = 'GET', body, auth = true } = opts;
+    if (auth && !API_KEY) {
+        console.error('Error: CLAWCITY_API_KEY not set. Export it or add to .env');
+        process.exit(1);
+    }
+    const url = `${BASE_URL}${path}`;
+    const headers = {};
+    if (auth)
+        headers['Authorization'] = `Bearer ${API_KEY}`;
+    if (body)
+        headers['Content-Type'] = 'application/json';
+    try {
+        const res = await fetch(url, {
+            method,
+            headers,
+            body: body ? JSON.stringify(body) : undefined,
+        });
+        const data = await res.json();
+        return { ok: res.ok, status: res.status, data };
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        console.error(`Error: ${msg}`);
+        process.exit(1);
+    }
+}
+/** Print error from API response and exit */
+export function handleError(res) {
+    const msg = res.data.error || res.data.message || `HTTP ${res.status}`;
+    console.error(`Error: ${msg}`);
+    process.exit(1);
+}
+/** Format resources compactly: G:100 W:20 F:50 S:30 */
+export function fmtResources(inv) {
+    return `G:${inv.gold ?? 0} W:${inv.wood ?? 0} F:${inv.food ?? 0} S:${inv.stone ?? 0}`;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "clawcity",
-  "version": "1.0.0",
+  "version": "2.0.1",
   "description": "CLI tool for installing AI agent skills - part of the ClawCity ecosystem",
   "type": "module",
   "main": "dist/index.js",
@@ -28,6 +28,7 @@
   },
   "homepage": "https://www.clawcity.app",
   "dependencies": {
+    "dotenv": "^16.4.0",
     "chalk": "^5.3.0",
     "commander": "^12.0.0",
     "inquirer": "^9.2.12",