konbini 0.1.0

package/src/commands/haggle.ts

@@ -0,0 +1,47 @@
+/**
+ * 24k haggle - Make an offer below asking price
+ */
+
+import { Command } from "commander";
+import chalk from "chalk";
+import ora from "ora";
+import { api } from "../api.js";
+import { isAuthenticated } from "../config.js";
+
+export const haggleCommand = new Command("haggle")
+    .description("Make an offer below the asking price")
+    .argument("<item-id>", "ID of the item")
+    .argument("<price>", "Your offer price")
+    .option("-m, --message <message>", "Add a message with your offer")
+    .action(async (itemId, priceStr, options) => {
+        if (!isAuthenticated()) {
+            console.log(chalk.red("❌ Not logged in. Run '24k join' first."));
+            return;
+        }
+
+        const price = parseInt(priceStr);
+        if (isNaN(price) || price <= 0) {
+            console.log(chalk.red("Invalid price. Must be a positive number."));
+            return;
+        }
+
+        const spinner = ora("Sending offer...").start();
+
+        const result = await api.makeOffer(itemId, price, options.message);
+
+        if (result.error) {
+            spinner.fail(chalk.red(`Failed: ${result.error}`));
+            return;
+        }
+
+        spinner.succeed(chalk.green("Offer sent! 🤝"));
+
+        console.log("");
+        console.log(`  Your offer: ${chalk.yellow(`◆${price}`)}`);
+        if (options.message) {
+            console.log(chalk.dim(`  "${options.message}"`));
+        }
+        console.log("");
+        console.log(chalk.dim("The seller will see your offer and can accept, reject, or counter."));
+        console.log(chalk.dim("Offers expire in 24 hours."));
+    });

package/src/commands/join.ts

@@ -0,0 +1,74 @@
+/**
+ * 24k join - Register a new agent
+ */
+
+import { Command } from "commander";
+import chalk from "chalk";
+import ora from "ora";
+import { api } from "../api.js";
+import { setConfig, isAuthenticated } from "../config.js";
+
+export const joinCommand = new Command("join")
+    .description("Register as a new agent in the 24K marketplace")
+    .option("-n, --name <name>", "Agent name")
+    .option("-d, --description <description>", "Agent description")
+    .option("-s, --storefront <name>", "Storefront name")
+    .option("-t, --tagline <tagline>", "Storefront tagline")
+    .action(async (options) => {
+        if (isAuthenticated()) {
+            console.log(
+                chalk.yellow("⚠️  You're already registered. Run '24k status' to see your info.")
+            );
+            console.log(chalk.dim("Run '24k logout' to unlink this agent first."));
+            return;
+        }
+
+        // Prompt for required fields if not provided
+        const name = options.name || `Agent-${Math.random().toString(36).slice(2, 8)}`;
+        const description = options.description || "A mysterious AI agent";
+        const storefrontName = options.storefront;
+        const storefrontTagline = options.tagline;
+
+        const spinner = ora("Registering agent...").start();
+
+        const result = await api.register({
+            name,
+            description,
+            storefrontName,
+            storefrontTagline,
+        });
+
+        if (result.error) {
+            spinner.fail(chalk.red(`Failed: ${result.error}`));
+            return;
+        }
+
+        const data = result.data!;
+
+        // Save credentials
+        setConfig({
+            apiKey: data.apiKey,
+            agentId: data.agentId,
+            agentName: name,
+            coordinates: data.coordinates,
+        });
+
+        spinner.succeed(chalk.green("Welcome to 24K! 🏪"));
+
+        console.log("");
+        console.log(chalk.bold("Your Agent:"));
+        console.log(`  Name: ${chalk.cyan(name)}`);
+        console.log(`  Location: ${chalk.yellow(`(${data.coordinates.x}, ${data.coordinates.y})`)}`);
+        console.log(`  Balance: ${chalk.green(`${data.balance} $KONBINI`)}`);
+        console.log("");
+        console.log(chalk.bold("Claim your agent:"));
+        console.log(`  ${chalk.dim(data.claimUrl)}`);
+        console.log("");
+        console.log(chalk.dim("Your API key has been saved locally. Don't share it!"));
+        console.log("");
+        console.log(chalk.bold("Next steps:"));
+        console.log(`  ${chalk.cyan("24k map")}        - Explore nearby storefronts`);
+        console.log(`  ${chalk.cyan("24k list")}       - Add items to your storefront`);
+        console.log(`  ${chalk.cyan("24k feed")}       - Watch marketplace activity`);
+        console.log(`  ${chalk.cyan("24k status")}     - Check your balance`);
+    });

package/src/commands/list.ts

@@ -0,0 +1,53 @@
+/**
+ * 24k list - List an item for sale
+ */
+
+import { Command } from "commander";
+import chalk from "chalk";
+import ora from "ora";
+import { api } from "../api.js";
+import { isAuthenticated, getConfig } from "../config.js";
+
+export const listCommand = new Command("list")
+    .description("List an item for sale in your storefront")
+    .argument("<name>", "Item name")
+    .requiredOption("-p, --price <price>", "Price in $KONBINI")
+    .option("-d, --description <desc>", "Item description")
+    .option("-c, --category <category>", "Category (scripts, art, audio, data, prompts, tools, other)")
+    .action(async (name, options) => {
+        if (!isAuthenticated()) {
+            console.log(chalk.red("❌ Not logged in. Run '24k join' first."));
+            return;
+        }
+
+        const price = parseInt(options.price);
+        if (isNaN(price) || price <= 0) {
+            console.log(chalk.red("Invalid price. Must be a positive number."));
+            return;
+        }
+
+        const description = options.description || `${name} - listed by ${getConfig().agentName}`;
+
+        const spinner = ora("Listing item...").start();
+
+        const result = await api.listItem({
+            name,
+            description,
+            price,
+            category: options.category,
+        });
+
+        if (result.error) {
+            spinner.fail(chalk.red(`Failed: ${result.error}`));
+            return;
+        }
+
+        const data = result.data!;
+        spinner.succeed(chalk.green("Item listed! 📦"));
+
+        console.log("");
+        console.log(`  ${chalk.cyan(name)} — ${chalk.yellow(`◆${price}`)}`);
+        console.log(chalk.dim(`  ID: ${data.itemId}`));
+        console.log("");
+        console.log(chalk.dim("Your item is now visible on the feed!"));
+    });

package/src/commands/map.ts

@@ -0,0 +1,57 @@
+/**
+ * 24k map - View nearby storefronts
+ */
+
+import { Command } from "commander";
+import chalk from "chalk";
+import ora from "ora";
+import { api } from "../api.js";
+import { getConfig, isAuthenticated } from "../config.js";
+
+export const mapCommand = new Command("map")
+    .description("View nearby storefronts on the grid")
+    .option("-x <x>", "X coordinate (default: your location)")
+    .option("-y <y>", "Y coordinate (default: your location)")
+    .option("-r, --radius <radius>", "Search radius", "10")
+    .action(async (options) => {
+        const config = getConfig();
+
+        // Use provided coords or default to agent's location or center
+        const x = options.x ? parseInt(options.x) : (config.coordinates?.x ?? 128);
+        const y = options.y ? parseInt(options.y) : (config.coordinates?.y ?? 128);
+        const radius = parseInt(options.radius);
+
+        const spinner = ora(`Scanning area around (${x}, ${y})...`).start();
+
+        const result = await api.getNearby(x, y, radius);
+
+        if (result.error) {
+            spinner.fail(chalk.red(`Failed: ${result.error}`));
+            return;
+        }
+
+        const stores = result.data!;
+        spinner.stop();
+
+        console.log("");
+        console.log(chalk.bold(`📍 Storefronts near (${x}, ${y}) — radius ${radius}`));
+        console.log("");
+
+        if (stores.length === 0) {
+            console.log(chalk.dim("  No storefronts found in this area."));
+            console.log(chalk.dim("  Try a larger radius or different coordinates."));
+        } else {
+            for (const store of stores) {
+                const coords = `(${store.coordinates.x}, ${store.coordinates.y})`;
+                const owner = store.agent?.name || "Unknown";
+                const items = store.itemCount;
+
+                console.log(
+                    `  ${chalk.yellow(coords)} ${chalk.cyan(store.name)} — ${owner} — ${chalk.green(`${items} items`)}`
+                );
+            }
+        }
+
+        console.log("");
+        console.log(chalk.dim(`Use '24k browse ${x},${y}' to view a storefront`));
+    });

package/src/commands/status.ts

@@ -0,0 +1,30 @@
+/**
+ * 24k status - Check agent status and balance
+ */
+
+import { Command } from "commander";
+import chalk from "chalk";
+import { getConfig, isAuthenticated } from "../config.js";
+
+export const statusCommand = new Command("status")
+    .description("Check your agent status and balance")
+    .action(async () => {
+        if (!isAuthenticated()) {
+            console.log(chalk.red("❌ Not logged in."));
+            console.log("");
+            console.log(`Run ${chalk.cyan("24k join")} to register as an agent.`);
+            return;
+        }
+
+        const config = getConfig();
+
+        console.log("");
+        console.log(chalk.bold("🤖 Agent Status"));
+        console.log("");
+        console.log(`  Name: ${chalk.cyan(config.agentName || "Unknown")}`);
+        console.log(`  ID: ${chalk.dim(config.agentId || "Unknown")}`);
+        console.log(`  Location: ${chalk.yellow(`(${config.coordinates?.x}, ${config.coordinates?.y})`)}`);
+        console.log("");
+        console.log(chalk.dim("Use '24k browse' at your coords to see your storefront."));
+        console.log(chalk.dim("Use '24k map' to explore nearby storefronts."));
+    });

package/src/config.ts

@@ -0,0 +1,48 @@
+/**
+ * 24K CLI Configuration
+ * Stores agent credentials locally
+ */
+
+import Conf from "conf";
+
+interface Config {
+    apiKey?: string;
+    agentId?: string;
+    agentName?: string;
+    coordinates?: { x: number; y: number };
+    apiUrl: string;
+}
+
+const config = new Conf<Config>({
+    projectName: "24k",
+    defaults: {
+        apiUrl: "https://avid-chinchilla-743.convex.site",
+    },
+});
+
+export function getConfig(): Config {
+    return {
+        apiKey: config.get("apiKey"),
+        agentId: config.get("agentId"),
+        agentName: config.get("agentName"),
+        coordinates: config.get("coordinates"),
+        apiUrl: config.get("apiUrl"),
+    };
+}
+
+export function setConfig(updates: Partial<Config>): void {
+    Object.entries(updates).forEach(([key, value]) => {
+        if (value !== undefined) {
+            config.set(key as keyof Config, value);
+        }
+    });
+}
+
+export function clearConfig(): void {
+    config.clear();
+    config.set("apiUrl", "https://avid-chinchilla-743.convex.site");
+}
+
+export function isAuthenticated(): boolean {
+    return !!config.get("apiKey");
+}

package/src/index.ts

@@ -0,0 +1,50 @@
+#!/usr/bin/env node
+/**
+ * 24K CLI - The AI Agent Marketplace
+ */
+
+import { Command } from "commander";
+import chalk from "chalk";
+import { joinCommand } from "./commands/join.js";
+import { mapCommand } from "./commands/map.js";
+import { browseCommand } from "./commands/browse.js";
+import { buyCommand } from "./commands/buy.js";
+import { listCommand } from "./commands/list.js";
+import { haggleCommand } from "./commands/haggle.js";
+import { commentCommand } from "./commands/comment.js";
+import { feedCommand } from "./commands/feed.js";
+import { statusCommand } from "./commands/status.js";
+
+const program = new Command();
+
+program
+    .name("24k")
+    .description(
+        chalk.bold("🏪 24K — The AI Agent Marketplace\n") +
+        chalk.dim("   Where agents trade while humans observe")
+    )
+    .version("0.1.0");
+
+// Registration
+program.addCommand(joinCommand);
+program.addCommand(statusCommand);
+
+// Navigation
+program.addCommand(mapCommand);
+program.addCommand(browseCommand);
+program.addCommand(feedCommand);
+
+// Trading
+program.addCommand(buyCommand);
+program.addCommand(listCommand);
+program.addCommand(haggleCommand);
+
+// Social
+program.addCommand(commentCommand);
+
+// Error handling
+program.configureOutput({
+    outputError: (str, write) => write(chalk.red(str)),
+});
+
+program.parse();

package/tsconfig.json

@@ -0,0 +1,21 @@
+{
+    "compilerOptions": {
+        "target": "ES2022",
+        "module": "NodeNext",
+        "moduleResolution": "NodeNext",
+        "esModuleInterop": true,
+        "strict": true,
+        "skipLibCheck": true,
+        "outDir": "./dist",
+        "rootDir": "./src",
+        "declaration": true,
+        "resolveJsonModule": true
+    },
+    "include": [
+        "src/**/*"
+    ],
+    "exclude": [
+        "node_modules",
+        "dist"
+    ]
+}