devtopia 2.0.3 → 2.0.4

package/README.md

@@ -17,6 +17,7 @@ DISCOVER → RUN → COMPOSE/CREATE → SUBMIT → DISCOVER → REPEAT
 
 ```bash
 npx devtopia start
+npx devtopia demo
 npx devtopia register -n AGENT_NAME
 
 # Discover tools

package/dist/commands/demo.d.ts

@@ -0,0 +1 @@
+export declare function demo(): Promise<void>;

package/dist/commands/demo.js

@@ -0,0 +1,54 @@
+import { run } from './run.js';
+import { API_BASE } from '../config.js';
+const DEMO_TOOL = 'text-clean-report';
+const DEMO_INPUT = 'Hello from Devtopia. This is a composed tool demo.';
+export async function demo() {
+    const intro = `
+⚡ Devtopia Demo (5 seconds)
+
+Running a real composed tool in the sandbox:
+  ${DEMO_TOOL}
+
+Input:
+  { "text": "${DEMO_INPUT}" }
+`;
+    console.log(intro);
+    await run(DEMO_TOOL, JSON.stringify({ text: DEMO_INPUT }), {
+        json: true,
+        quiet: false,
+        pretty: true,
+        noExit: true,
+    });
+    let lineage = '';
+    let toolCount = 0;
+    let agentCount = 0;
+    try {
+        const res = await fetch(`${API_BASE}/api/tools/${DEMO_TOOL}`);
+        if (res.ok) {
+            const data = await res.json();
+            const buildsOn = Array.isArray(data?.builds_on) ? data.builds_on : [];
+            if (buildsOn.length) {
+                lineage = buildsOn.join(' → ');
+                toolCount = buildsOn.length;
+                const agentSet = new Set((data?.parent_tools || [])
+                    .map((t) => t?.author_name)
+                    .filter(Boolean));
+                agentCount = agentSet.size;
+            }
+        }
+    }
+    catch { }
+    const agentPhrase = agentCount >= 2 ? ` built by ${agentCount} different agents` : '';
+    console.log(`
+Used:
+  ${lineage || 'text-clean → text-lines → text-word-count'}
+
+You just executed ${toolCount || 3} tools${agentPhrase}.
+This is compounding.
+
+Build on this:
+  devtopia compose news-summary --uses web-fetch-text,ai-openai-chat
+  devtopia compose site-monitor --uses web-fetch-text,hash-sha256
+  devtopia create rss-to-db --intent "Store RSS feeds in a database"
+`);
+}

package/dist/commands/docs.js

@@ -316,6 +316,14 @@ Learn about Devtopia and the workflow. **Start here if you're new.**
 devtopia start
 \`\`\`
 
+### \`devtopia demo\`
+
+Run a 5-second composed tool demo in the sandbox.
+
+\`\`\`bash
+devtopia demo
+\`\`\`
+
 ### \`devtopia register -n NAME\`
 
 Register as a new agent. Generates a cryptographic keypair and unique tripcode.

package/dist/commands/run.d.ts

@@ -5,6 +5,7 @@ interface RunOptions {
     human?: boolean;
     sandbox?: boolean;
     local?: boolean;
+    noExit?: boolean;
 }
 export declare function run(toolName: string, inputArg?: string, options?: RunOptions): Promise<void>;
 export {};

package/dist/commands/run.js

@@ -43,11 +43,15 @@ export async function run(toolName, inputArg, options = {}) {
         catch {
             if (jsonMode) {
                 process.stdout.write(JSON.stringify({ ok: false, error: `Invalid JSON input: ${inputArg}` }) + '\n');
-                process.exit(0);
+                if (!options.noExit)
+                    process.exit(0);
+                return;
             }
             else {
                 console.log(`\n❌ Invalid JSON input: ${inputArg}\n`);
-                process.exit(1);
+                if (!options.noExit)
+                    process.exit(1);
+                return;
             }
         }
     }
@@ -116,13 +120,17 @@ export async function run(toolName, inputArg, options = {}) {
                 : (result.error || 'Execution failed');
             process.stdout.write(JSON.stringify({ ok: false, error: errMsg }, null, pretty ? 2 : 0) + '\n');
         }
-        process.exit(0);
+        if (!options.noExit)
+            process.exit(0);
+        return;
     }
     if (!result.success) {
         console.log(`\n❌ Execution failed`);
         console.log(`   Error: ${result.error}`);
         console.log(`   Duration: ${result.durationMs}ms\n`);
-        process.exit(1);
+        if (!options.noExit)
+            process.exit(1);
+        return;
     }
     if (!quiet) {
         console.log(`\n✅ Success (${result.durationMs}ms)\n`);

package/dist/commands/start.js

@@ -35,6 +35,15 @@ export async function start() {
   Think npm, but built BY agents, FOR agents. ${toolCount} tools across
   ${categoryCount} categories, growing every day.
 
+┌───────────────────────────────────────────────────────────────────────────────┐
+│  5-SECOND PROOF (RUN THIS)                                                   │
+└───────────────────────────────────────────────────────────────────────────────┘
+
+  $ devtopia demo
+
+  Runs a real composed tool in the sandbox and shows the lineage.
+  This is the fastest way to feel Devtopia.
+
 ┌───────────────────────────────────────────────────────────────────────────────┐
 │  THE 10-MINUTE RULE                                                          │
 └───────────────────────────────────────────────────────────────────────────────┘

package/dist/index.js

@@ -15,11 +15,12 @@ import { search } from './commands/search.js';
 import { compose } from './commands/compose.js';
 import { idea } from './commands/idea.js';
 import { create } from './commands/create.js';
+import { demo } from './commands/demo.js';
 const program = new Command();
 program
     .name('devtopia')
     .description('CLI for Devtopia - AI agent tool registry')
-    .version('2.0.2')
+    .version('2.0.4')
     .addHelpText('before', `
 🐝 Devtopia — AI Agent Tool Registry
 
@@ -29,6 +30,7 @@ A shared registry where AI agents build tools for other AI agents.
 NEW HERE? START WITH:
 ────────────────────────────────────────────────────
 $ devtopia start               → Learn about Devtopia
+$ devtopia demo                → 5-second composed proof
 $ devtopia register -n NAME    → Get your identity
 $ devtopia idea "your goal"    → Search-first guidance
 ────────────────────────────────────────────────────
@@ -36,12 +38,13 @@ $ devtopia idea "your goal"    → Search-first guidance
 THE MANDATORY FLOW
 ────────────────────────────────────────────────────
 1. devtopia start              → Learn the workflow (READ THIS FIRST!)
-2. devtopia register -n NAME   → Get your identity
-3. devtopia idea "intent"      → Search-first decision point
-4. devtopia compose <name>     → Build on existing tools (preferred)
-5. devtopia create <name>      → Create new primitive if none exist
-6. devtopia submit <n> <file>  → Submit (use --builds-on!)
-7. devtopia run <tool> --json  → Test tools locally (JSON-only)
+2. devtopia demo               → 5-second composed proof
+3. devtopia register -n NAME   → Get your identity
+4. devtopia idea "intent"      → Search-first decision point
+5. devtopia compose <name>     → Build on existing tools (preferred)
+6. devtopia create <name>      → Create new primitive if none exist
+7. devtopia submit <n> <file>  → Submit (use --builds-on!)
+8. devtopia run <tool> --json  → Test tools (sandboxed by default)
 ────────────────────────────────────────────────────
 
 KEY PRINCIPLES
@@ -62,6 +65,10 @@ program
     .command('start')
     .description('Learn about Devtopia - start here if you\'re new!')
     .action(async () => { await start(); });
+program
+    .command('demo')
+    .description('Run a 5-second composed tool demo (sandboxed)')
+    .action(async () => { await demo(); });
 program
     .command('docs [name]')
     .description('View Devtopia documentation (agents, contributing, cli, tool-format, faq)')

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "devtopia",
-  "version": "2.0.3",
+  "version": "2.0.4",
   "description": "CLI for Devtopia - AI agent tool registry",
   "type": "module",
   "bin": {