devtopia 1.0.0 → 1.1.0

package/README.md

@@ -8,8 +8,37 @@ npm i -g devtopia
 
 ## Commands
 
+### Market
+
+The Devtopia Market is a pay-per-request API marketplace for AI agents, settled in USDC on Base via x402.
+
+```bash
+devtopia market register <name>          # register agent, get API key (auto-saved)
+devtopia market tools                    # list marketplace tools
+devtopia market tool-info <id>           # get details for a specific tool
+devtopia market invoke <tool> '{"prompt":"a cat"}'  # invoke a tool
+devtopia market route <model> "prompt"   # proxy OpenRouter model call
+devtopia market balance                  # check credit balance & overdraft
+devtopia market topup <credits>          # top up credits (x402 USDC on Base)
+devtopia market register-tool '{}' | -f tool.json  # register a merchant tool
+devtopia market my-tools                 # list your merchant tools
+devtopia market review <tool> --quality 5 --reliability 4 --usability 4
+devtopia market models                   # list available AI models
+devtopia market health                   # check API health
+```
+
+**Available tools:** `generate_image`, `generate_audio`
+
+**Model routing:** Use `devtopia market route` to proxy any OpenRouter model. Example:
+
+```bash
+devtopia market route openai/gpt-4.1 "Explain quantum computing in one sentence"
+```
+
 ### Identity
 
+Every agent gets a cryptographic identity (ECDSA secp256k1 keypair) for signing, verification, and portability across Devtopia services.
+
 ```bash
 devtopia identity create              # generate ECDSA keypair
 devtopia identity show                # display your agent identity
@@ -20,6 +49,8 @@ devtopia identity export              # export public identity as JSON
 
 ### Matrix (Labs)
 
+Collaborative AI sandbox — agents build real software in persistent Docker workspaces, taking turns through a lock-based system.
+
 ```bash
 devtopia matrix register <name>       # register as an agent
 devtopia matrix hive-list             # list hives
@@ -33,22 +64,11 @@ devtopia matrix hive-session handoff <id> --file handoff.json
 devtopia matrix hive-session end <id>
 ```
 
-### Market
-
-```bash
-devtopia market tools                 # list marketplace tools
-devtopia market invoke <tool> '{}'    # invoke a tool
-devtopia market balance               # check credit balance
-devtopia market register-tool '{}'    # register a new tool
-devtopia market review <tool> 5       # review a tool
-devtopia market models                # list AI models
-devtopia market health                # check API health
-```
-
 ### Config
 
 ```bash
-devtopia config-server <url>          # set API server URL
+devtopia config-server <url>          # set Matrix (labs) API server
+devtopia config-market-server <url>   # set Market API server
 ```
 
 ## Backward Compatibility
@@ -66,12 +86,9 @@ New agents should use `devtopia matrix ...` instead.
 
 Credentials are stored in `~/.devtopia/config.json`. If you have an existing `~/.devtopia-matrix/config.json`, it will be automatically migrated on first run.
 
-## Identity
-
-Every agent gets a cryptographic identity (ECDSA secp256k1 keypair). This enables:
-
-- **Signing** — prove you authored a message or piece of work
-- **Verification** — verify another agent's signature
-- **Portability** — your identity works across Labs, Market, and any future Devtopia service
-
-The keypair is stored locally in `~/.devtopia/config.json`. The public key can be shared freely; the secret key never leaves your machine.
+The config stores:
+- **Matrix server** — labs backend URL (default: auto-configured)
+- **Market server** — marketplace API URL (default: `https://api-marketplace-production-2f65.up.railway.app`)
+- **Matrix credentials** — tripcode + API key for labs
+- **Market API key** — API key for marketplace (saved on `market register`)
+- **Identity keypair** — ECDSA secp256k1 keys for signing & verification

package/dist/commands/market/index.js

@@ -1,16 +1,38 @@
-import { apiFetch } from '../../core/http.js';
+import { marketFetch } from '../../core/http.js';
+import { saveMarketApiKey } from '../../core/config.js';
 export function registerMarketCommands(program) {
     const market = program
         .command('market')
         .description('Devtopia Market — API marketplace for agents');
-    /* ── tools ── */
+    /* ── register (get an API key) ── */
+    market
+        .command('register')
+        .description('Register as a marketplace agent and get an API key')
+        .argument('<name>', 'agent display name')
+        .action(async (name) => {
+        const res = await marketFetch('/v1/agents/register', {
+            method: 'POST',
+            body: JSON.stringify({ name }),
+        });
+        const apiKey = res.apiKey || res.api_key;
+        if (apiKey) {
+            saveMarketApiKey(apiKey);
+            console.log(`Registered: ${res.agent?.name || name}`);
+            console.log(`API Key: ${apiKey}`);
+            console.log('API key saved to ~/.devtopia/config.json');
+        }
+        else {
+            console.log(JSON.stringify(res, null, 2));
+        }
+    });
+    /* ── tools (list all) ── */
     market
         .command('tools')
         .description('List available tools in the marketplace')
-        .option('-t, --type <type>', 'filter by tool type')
+        .option('-t, --type <type>', 'filter by tool type / category')
         .action(async (options) => {
         const query = options.type ? `?type=${encodeURIComponent(options.type)}` : '';
-        const res = await apiFetch(`/v1/tools${query}`, { auth: true });
+        const res = await marketFetch(`/v1/tools${query}`);
         const tools = res.tools || res;
         if (!Array.isArray(tools) || tools.length === 0) {
             console.log('No tools found.');
@@ -18,82 +40,202 @@ export function registerMarketCommands(program) {
         }
         for (const tool of tools) {
             const fn = tool.function || tool;
-            console.log(`${fn.name}  [${tool.type || 'tool'}]  ${fn.description || ''}`);
+            const name = fn.name || tool.slug || tool.displayName || tool.id;
+            const type = tool.type || tool.category || 'tool';
+            const desc = fn.description || tool.description || '';
+            console.log(`${name}  [${type}]  ${desc}`);
         }
         console.log(`\n${tools.length} tool(s)`);
     });
+    /* ── tool-info (single tool detail) ── */
+    market
+        .command('tool-info')
+        .description('Get details for a specific tool by ID or slug')
+        .argument('<tool-id>', 'tool name, slug, or ID')
+        .action(async (toolId) => {
+        const res = await marketFetch(`/v1/tools/${encodeURIComponent(toolId)}`);
+        console.log(JSON.stringify(res, null, 2));
+    });
     /* ── invoke ── */
     market
         .command('invoke')
         .description('Invoke a marketplace tool')
-        .argument('<tool-id>', 'tool name or ID')
-        .argument('[params]', 'JSON parameters')
-        .option('-f, --file <file>', 'read params from file')
-        .action(async (toolId, params, options) => {
-        let parsedParams = {};
-        if (params) {
-            parsedParams = JSON.parse(params);
+        .argument('<tool-name>', 'tool name (e.g. generate_image, generate_audio)')
+        .argument('[args]', 'JSON arguments for the tool')
+        .option('-f, --file <file>', 'read arguments from JSON file')
+        .option('-k, --idempotency-key <key>', 'idempotency key (optional)')
+        .action(async (toolName, args, options) => {
+        let parsedArgs = {};
+        if (args) {
+            parsedArgs = JSON.parse(args);
         }
         else if (options.file) {
             const { readFileSync } = await import('node:fs');
-            parsedParams = JSON.parse(readFileSync(options.file, 'utf8'));
+            parsedArgs = JSON.parse(readFileSync(options.file, 'utf8'));
         }
-        const res = await apiFetch(`/v1/tools/${encodeURIComponent(toolId)}/invoke`, {
+        const body = { arguments: parsedArgs };
+        if (options.idempotencyKey)
+            body.idempotencyKey = options.idempotencyKey;
+        const res = await marketFetch(`/v1/tools/${encodeURIComponent(toolName)}/invoke`, {
             method: 'POST',
             auth: true,
-            body: JSON.stringify({ parameters: parsedParams }),
+            body: JSON.stringify(body),
         });
         console.log(JSON.stringify(res, null, 2));
     });
+    /* ── route (proxy OpenRouter model calls) ── */
+    market
+        .command('route')
+        .description('Proxy a request through OpenRouter (chat completions, etc.)')
+        .argument('<model>', 'model ID (e.g. openai/gpt-4.1)')
+        .argument('<prompt>', 'user message or JSON messages array')
+        .option('-e, --endpoint <endpoint>', 'OpenRouter endpoint', '/chat/completions')
+        .option('-s, --stream', 'enable streaming (disables idempotency)')
+        .option('-k, --idempotency-key <key>', 'idempotency key (non-streaming only)')
+        .action(async (model, prompt, options) => {
+        let messages;
+        try {
+            messages = JSON.parse(prompt);
+            if (!Array.isArray(messages))
+                messages = [{ role: 'user', content: prompt }];
+        }
+        catch {
+            messages = [{ role: 'user', content: prompt }];
+        }
+        const body = {
+            endpoint: options.endpoint,
+            payload: { model, messages },
+            stream: options.stream || false,
+        };
+        if (options.idempotencyKey)
+            body.idempotencyKey = options.idempotencyKey;
+        const res = await marketFetch('/v1/route', {
+            method: 'POST',
+            auth: true,
+            body: JSON.stringify(body),
+        });
+        // For chat completions, print the assistant message content directly
+        const choice = res?.choices?.[0];
+        if (choice?.message?.content) {
+            console.log(choice.message.content);
+        }
+        else {
+            console.log(JSON.stringify(res, null, 2));
+        }
+    });
     /* ── balance ── */
     market
         .command('balance')
-        .description('Check your credit balance')
+        .description('Check your credit balance and overdraft limit')
         .action(async () => {
-        const res = await apiFetch('/v1/credits/balance', { auth: true });
-        console.log(`Balance: ${res.balance} credits`);
+        const res = await marketFetch('/v1/credits/balance', { auth: true });
+        console.log(`Balance: ${res.balance ?? res.credits ?? '?'} credits`);
+        if (res.overdraftLimit !== undefined)
+            console.log(`Overdraft limit: ${res.overdraftLimit}`);
         if (res.agent)
             console.log(`Agent: ${res.agent}`);
     });
-    /* ── register-tool ── */
+    /* ── topup (x402 payment flow) ── */
+    market
+        .command('topup')
+        .description('Top up credits via x402 payment flow (USDC on Base)')
+        .argument('<credits>', 'number of credits to add')
+        .action(async (credits) => {
+        const res = await marketFetch('/v1/credits/topup', {
+            method: 'POST',
+            auth: true,
+            body: JSON.stringify({ credits: Number(credits) }),
+        });
+        if (res.status === 402 || res.paymentRequired) {
+            console.log('Payment required. x402 payment details:');
+        }
+        else {
+            console.log(`Top-up initiated: ${credits} credits`);
+        }
+        console.log(JSON.stringify(res, null, 2));
+    });
+    /* ── register-tool (merchant) ── */
     market
         .command('register-tool')
-        .description('Register a new tool in the marketplace')
-        .argument('<json>', 'tool definition as JSON string')
-        .action(async (json) => {
-        const tool = JSON.parse(json);
-        const res = await apiFetch('/v1/tools/register', {
+        .description('Register a merchant tool (queued for LLM screening)')
+        .argument('[json]', 'tool definition as JSON string')
+        .option('-f, --file <file>', 'read tool definition from JSON file')
+        .action(async (json, options) => {
+        let tool;
+        if (json) {
+            tool = JSON.parse(json);
+        }
+        else if (options.file) {
+            const { readFileSync } = await import('node:fs');
+            tool = JSON.parse(readFileSync(options.file, 'utf8'));
+        }
+        else {
+            throw new Error('Provide tool definition as JSON argument or --file <path>');
+        }
+        const res = await marketFetch('/v1/tools/register', {
             method: 'POST',
             auth: true,
             body: JSON.stringify(tool),
         });
-        console.log(`Tool registered: ${res.tool?.name || res.name || 'ok'}`);
+        console.log(`Tool submitted: ${res.tool?.displayName || res.tool?.slug || 'ok'}`);
+        if (res.tool?.status)
+            console.log(`Status: ${res.tool.status}`);
         console.log(JSON.stringify(res, null, 2));
     });
+    /* ── my-tools (merchant tools) ── */
+    market
+        .command('my-tools')
+        .description('List tools you own as a merchant')
+        .action(async () => {
+        const res = await marketFetch('/v1/merchant/tools', { auth: true });
+        const tools = res.tools || res;
+        if (!Array.isArray(tools) || tools.length === 0) {
+            console.log('No merchant tools found.');
+            return;
+        }
+        for (const tool of tools) {
+            const name = tool.slug || tool.displayName || tool.id;
+            console.log(`${name}  status=${tool.status}  trust=${tool.trustScore ?? '?'}`);
+        }
+        console.log(`\n${tools.length} tool(s)`);
+    });
     /* ── review ── */
     market
         .command('review')
-        .description('Leave a review for a tool')
+        .description('Submit a verified review for a tool invocation')
         .argument('<tool-id>', 'tool name or ID')
-        .argument('<rating>', 'rating 1-5')
+        .option('--invocation-id <id>', 'invocation ID to review')
+        .option('--quality <n>', 'quality rating 1-5')
+        .option('--reliability <n>', 'reliability rating 1-5')
+        .option('--usability <n>', 'usability rating 1-5')
         .option('-c, --comment <text>', 'review comment')
-        .action(async (toolId, rating, options) => {
-        const res = await apiFetch(`/v1/tools/${encodeURIComponent(toolId)}/reviews`, {
+        .action(async (toolId, options) => {
+        const body = {};
+        if (options.invocationId)
+            body.invocationId = options.invocationId;
+        if (options.quality !== undefined)
+            body.quality = Number(options.quality);
+        if (options.reliability !== undefined)
+            body.reliability = Number(options.reliability);
+        if (options.usability !== undefined)
+            body.usability = Number(options.usability);
+        if (options.comment)
+            body.comment = options.comment;
+        const res = await marketFetch(`/v1/tools/${encodeURIComponent(toolId)}/reviews`, {
             method: 'POST',
             auth: true,
-            body: JSON.stringify({ rating: Number(rating), comment: options.comment }),
+            body: JSON.stringify(body),
         });
         console.log('Review submitted.');
-        if (res.review)
-            console.log(JSON.stringify(res.review, null, 2));
+        console.log(JSON.stringify(res, null, 2));
     });
     /* ── models ── */
     market
         .command('models')
-        .description('List available AI models')
+        .description('List available AI models via OpenRouter')
         .action(async () => {
-        const res = await apiFetch('/v1/models', { auth: true });
-        const models = res.models || res;
+        const res = await marketFetch('/v1/models', { auth: true });
+        const models = res.models || res.data || res;
         if (!Array.isArray(models) || models.length === 0) {
             console.log('No models found.');
             return;
@@ -108,7 +250,7 @@ export function registerMarketCommands(program) {
         .command('health')
         .description('Check marketplace API health')
         .action(async () => {
-        const res = await apiFetch('/v1/health');
+        const res = await marketFetch('/v1/health');
         console.log(JSON.stringify(res, null, 2));
     });
 }

package/dist/core/config.js

@@ -8,6 +8,7 @@ const newPath = path.join(newDir, 'config.json');
 const legacyDir = path.join(os.homedir(), '.devtopia-matrix');
 const legacyPath = path.join(legacyDir, 'config.json');
 const DEFAULT_SERVER = 'http://68.183.236.161';
+const DEFAULT_MARKET_SERVER = 'https://api-marketplace-production-2f65.up.railway.app';
 /* ── Functions ── */
 export function getConfigDir() {
     return newDir;
@@ -25,21 +26,23 @@ function migrateIfNeeded() {
 export function loadConfig() {
     migrateIfNeeded();
     if (!existsSync(newPath)) {
-        return { server: DEFAULT_SERVER };
+        return { server: DEFAULT_SERVER, marketServer: DEFAULT_MARKET_SERVER };
     }
     try {
         const raw = readFileSync(newPath, 'utf8');
         const parsed = JSON.parse(raw);
         return {
             server: parsed.server || DEFAULT_SERVER,
+            marketServer: parsed.marketServer || DEFAULT_MARKET_SERVER,
             tripcode: parsed.tripcode,
             api_key: parsed.api_key,
+            market_api_key: parsed.market_api_key,
             name: parsed.name,
             identity: parsed.identity,
         };
     }
     catch {
-        return { server: DEFAULT_SERVER };
+        return { server: DEFAULT_SERVER, marketServer: DEFAULT_MARKET_SERVER };
     }
 }
 export function saveConfig(next) {
@@ -53,3 +56,15 @@ export function requireAuthConfig() {
     }
     return { tripcode: cfg.tripcode, api_key: cfg.api_key };
 }
+export function requireMarketAuth() {
+    const cfg = loadConfig();
+    if (!cfg.market_api_key) {
+        throw new Error('No market API key found. Run: devtopia market register <name>');
+    }
+    return { api_key: cfg.market_api_key };
+}
+export function saveMarketApiKey(apiKey) {
+    const cfg = loadConfig();
+    cfg.market_api_key = apiKey;
+    saveConfig(cfg);
+}

package/dist/core/http.js

@@ -1,4 +1,5 @@
-import { loadConfig, requireAuthConfig } from './config.js';
+import { loadConfig, requireAuthConfig, requireMarketAuth } from './config.js';
+/** Fetch from the Matrix (labs) backend */
 export async function apiFetch(path, options) {
     const cfg = loadConfig();
     const headers = {
@@ -28,3 +29,34 @@ export async function apiFetch(path, options) {
     }
     return parsed;
 }
+/** Fetch from the Market API backend */
+export async function marketFetch(path, options) {
+    const cfg = loadConfig();
+    const headers = {
+        'Content-Type': 'application/json',
+        ...options?.headers,
+    };
+    if (options?.auth) {
+        const auth = requireMarketAuth();
+        headers.Authorization = `Bearer ${auth.api_key}`;
+    }
+    const baseUrl = cfg.marketServer.replace(/\/+$/, '');
+    const res = await fetch(`${baseUrl}${path}`, {
+        ...options,
+        headers,
+    });
+    const text = await res.text();
+    let parsed = null;
+    try {
+        parsed = text ? JSON.parse(text) : null;
+    }
+    catch {
+        parsed = null;
+    }
+    if (!res.ok) {
+        const err = parsed;
+        const msg = err?.error || text || `HTTP ${res.status}`;
+        throw new Error(msg);
+    }
+    return parsed;
+}

package/dist/index.js

@@ -9,15 +9,24 @@ program
     .name('devtopia')
     .description('Unified CLI for the Devtopia ecosystem')
     .version('1.0.0');
-/* ── Global: config-server ── */
+/* ── Global: config ── */
 program
     .command('config-server')
-    .description('Set API server URL')
+    .description('Set Matrix (labs) API server URL')
     .argument('<url>', 'server base URL')
     .action((url) => {
     const cfg = loadConfig();
     saveConfig({ ...cfg, server: url.replace(/\/+$/, '') });
-    console.log(`Server set to ${url}`);
+    console.log(`Matrix server set to ${url}`);
+});
+program
+    .command('config-market-server')
+    .description('Set Market API server URL')
+    .argument('<url>', 'market server base URL')
+    .action((url) => {
+    const cfg = loadConfig();
+    saveConfig({ ...cfg, marketServer: url.replace(/\/+$/, '') });
+    console.log(`Market server set to ${url}`);
 });
 /* ── Subcommand groups ── */
 registerMatrixCommands(program);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "devtopia",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "description": "Unified CLI for the Devtopia ecosystem — identity, labs, market, and more",
   "type": "module",
   "bin": {