@4mica/cli 0.2.0

package/templates/agent-buyer-node/src/critic.ts

@@ -0,0 +1,195 @@
+import { readFileSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { brainMode, judgeSetup, rateJoke } from "./brain";
+import { payAndFetch } from "./pay";
+
+function comedianBase(): string {
+  if (process.env.COMEDIAN_URL) return process.env.COMEDIAN_URL;
+  try {
+    const base = readFileSync(
+      join(tmpdir(), "__TMPFILE__"),
+      "utf8",
+    ).trim();
+    if (base) return base;
+  } catch {
+    return "http://localhost:__PORT__";
+  }
+  return "http://localhost:__PORT__";
+}
+
+const BASE = comedianBase();
+const THEME = process.env.THEME ?? "programming";
+const GOAL = Number(process.env.GOAL ?? 4);
+const BUDGET = Number(process.env.BUDGET ?? 1200);
+const KEEP_THRESHOLD = Number(process.env.THRESHOLD ?? 7);
+const MAX_ROUNDS = Number(process.env.MAX_ROUNDS ?? 16);
+const CATEGORIES = [
+  "puns",
+  "wordplay",
+  "observational",
+  "dad",
+  "absurd",
+  "meta",
+];
+
+type Setup = {
+  jokeId: string;
+  category: string;
+  setup: string;
+  price: number;
+};
+type Punchline = { punchline: string; category: string };
+
+const stats: Record<string, { n: number; avg: number }> = {};
+const kept: {
+  category: string;
+  setup: string;
+  punchline: string;
+  score: number;
+}[] = [];
+let budget = BUDGET;
+let spent = 0;
+
+// Multi-armed bandit: exploit the highest-rated category, but explore sometimes.
+// Unseen categories get an optimistic prior so the agent tries each at least once.
+function pickCategory(): string {
+  if (Math.random() < 0.3) {
+    return CATEGORIES[Math.floor(Math.random() * CATEGORIES.length)];
+  }
+  return [...CATEGORIES].sort((a, b) => value(b) - value(a))[0];
+}
+
+function value(category: string): number {
+  const s = stats[category];
+  return s && s.n > 0 ? s.avg : 8.5; // optimistic prior for the unexplored
+}
+
+function record(category: string, score: number): void {
+  const s = stats[category] ?? { n: 0, avg: 0 };
+  s.avg = (s.avg * s.n + score) / (s.n + 1);
+  s.n += 1;
+  stats[category] = s;
+}
+
+async function feedback(category: string, score: number): Promise<void> {
+  await fetch(`${BASE}/rating`, {
+    method: "POST",
+    headers: { "content-type": "application/json" },
+    body: JSON.stringify({ category, score }),
+  }).catch(() => {});
+}
+
+async function main() {
+  console.log(
+    `🎯 Critic goal: curate ${GOAL} jokes on "${THEME}" scoring ≥${KEEP_THRESHOLD}/10, budget ${BUDGET} credits.`,
+  );
+  console.log(`🧠 Judgment: ${brainMode}. Comedian: ${BASE}\n`);
+
+  for (let round = 1; round <= MAX_ROUNDS; round++) {
+    if (kept.length >= GOAL) break;
+    const category = pickCategory();
+
+    const teaserRes = await fetch(
+      `${BASE}/setup?theme=${encodeURIComponent(THEME)}&category=${category}`,
+    );
+    if (!teaserRes.ok) {
+      console.log(
+        `[critic] comedian unavailable (${teaserRes.status}). Stopping.`,
+      );
+      return;
+    }
+    const teaser = (await teaserRes.json()) as Setup;
+    const slotsLeft = GOAL - kept.length;
+
+    console.log(
+      `[round ${round}] 🎰 probing "${category}" (avg ${value(category).toFixed(1)}) → free setup: "${teaser.setup}"`,
+    );
+
+    const verdict = await judgeSetup({
+      theme: THEME,
+      category,
+      setup: teaser.setup,
+      price: teaser.price,
+      budgetLeft: budget,
+      slotsLeft,
+    });
+
+    if (!verdict.buy) {
+      console.log(
+        `           🤔 predicted ${verdict.predicted}/10, punchline ${teaser.price} credits → PASS (${verdict.reason})\n`,
+      );
+      continue;
+    }
+
+    console.log(
+      `           🤔 predicted ${verdict.predicted}/10 → BUY the punchline for ${teaser.price} credits (${verdict.reason})`,
+    );
+
+    const paid = await payAndFetch<Punchline>(
+      `${BASE}/punchline?jokeId=${teaser.jokeId}`,
+    );
+    if (paid.status !== 200 || !paid.body) {
+      console.log(`           ❌ payment/fetch failed (${paid.status})\n`);
+      continue;
+    }
+    budget -= paid.paid;
+    spent += paid.paid;
+    console.log(
+      `           💸 paid ${paid.paid} credits via x402 (budget: ${budget} left) → punchline: "${paid.body.punchline}"`,
+    );
+
+    const rated = await rateJoke({
+      theme: THEME,
+      setup: teaser.setup,
+      punchline: paid.body.punchline,
+    });
+    record(category, rated.score);
+    await feedback(category, rated.score);
+
+    const verdictLine =
+      rated.score >= KEEP_THRESHOLD ? "⭐ KEEP" : "🗑️  discard";
+    if (rated.score >= KEEP_THRESHOLD) {
+      kept.push({
+        category,
+        setup: teaser.setup,
+        punchline: paid.body.punchline,
+        score: rated.score,
+      });
+    }
+    console.log(
+      `           😂 rated ${rated.score}/10 (${rated.critique}) → ${verdictLine}. "${category}" avg now ${value(category).toFixed(1)}\n`,
+    );
+
+    if (budget < 60) {
+      console.log("[critic] budget nearly exhausted — wrapping up.\n");
+      break;
+    }
+  }
+
+  console.log("──────────── curated set ────────────");
+  if (kept.length === 0) {
+    console.log("Nothing met the bar. Tough crowd.");
+  }
+  kept
+    .sort((a, b) => b.score - a.score)
+    .forEach((j, i) => {
+      console.log(`${i + 1}. [${j.category} · ${j.score}/10]`);
+      console.log(`   ${j.setup}`);
+      console.log(`   ${j.punchline}`);
+    });
+
+  const best = Object.entries(stats).sort((a, b) => b[1].avg - a[1].avg)[0];
+  console.log("─────────────────────────────────────");
+  console.log(
+    `🏁 Kept ${kept.length}/${GOAL} · spent ${spent} of ${BUDGET} credits` +
+      (best
+        ? ` · best category: ${best[0]} (${best[1].avg.toFixed(1)}/10)`
+        : ""),
+  );
+}
+
+main().catch((err) => {
+  console.error("[critic] failed:", err);
+  process.exitCode = 1;
+});

package/templates/agent-buyer-node/src/pay.ts

@@ -0,0 +1,54 @@
+type Requirement = {
+  scheme: string;
+  network: string;
+  asset: string;
+  amount: string;
+  payTo: string;
+  extra?: { tabEndpoint?: string };
+};
+
+type Required402 = { x402Version: number; accepts: Requirement[] };
+
+function demoPaymentHeader(req: Requirement): string {
+  const envelope = {
+    x402Version: 1,
+    scheme: req.scheme,
+    network: req.network,
+    payload: {
+      claims: {
+        version: "v1",
+        user_address: "0x2222222222222222222222222222222222222222",
+        recipient_address: req.payTo,
+        req_id: "0x1",
+        amount: `0x${BigInt(req.amount).toString(16)}`,
+        asset_address: req.asset,
+        timestamp: Math.floor(Date.now() / 1000),
+      },
+      signature: "0xdemoSignature",
+      scheme: "eip712",
+    },
+  };
+  return Buffer.from(JSON.stringify(envelope)).toString("base64");
+}
+
+export type PaidResult<T> = {
+  status: number;
+  body: T | null;
+  paid: number;
+};
+
+export async function payAndFetch<T>(url: string): Promise<PaidResult<T>> {
+  const first = await fetch(url);
+  if (first.status !== 402) {
+    return { status: first.status, body: (await first.json()) as T, paid: 0 };
+  }
+
+  const requirement = ((await first.json()) as Required402).accepts[0];
+  const header = demoPaymentHeader(requirement);
+  const paid = await fetch(url, { headers: { "X-PAYMENT": header } });
+  return {
+    status: paid.status,
+    body: paid.ok ? ((await paid.json()) as T) : null,
+    paid: Number(requirement.amount),
+  };
+}

package/templates/agent-buyer-node/tsconfig.json

@@ -0,0 +1,21 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "ESNext",
+    "moduleResolution": "Bundler",
+    "lib": [
+      "ES2022",
+      "DOM"
+    ],
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "noEmit": true,
+    "types": [
+      "node"
+    ]
+  },
+  "include": [
+    "src"
+  ]
+}

package/templates/agent-seller-express/.env.example

@@ -0,0 +1,16 @@
+# 4Mica runs in DEMO MODE with zero config (mock verifier / demo payment).
+# To go live, swap the mock verifier for createClient() from @4mica/sdk-node
+# and fill these in. Docs: https://4mica.io/docs
+
+# 4MICA_WALLET_PRIVATE_KEY=0x...
+# 4MICA_NETWORK=base-sepolia
+# 4MICA_RPC_URL=
+# 4MICA_ETHEREUM_HTTP_RPC_URL=
+# 4MICA_CONTRACT_ADDRESS=
+# 4MICA_ADMIN_API_KEY=
+# 4MICA_BEARER_TOKEN=
+# 4MICA_AUTH_URL=
+
+# Agent brain: set to have Claude generate/judge for real (offline fallback otherwise).
+# ANTHROPIC_API_KEY=sk-ant-...
+# AGENT_MODEL=claude-opus-4-8

package/templates/agent-seller-express/README.md

@@ -0,0 +1,26 @@
+# __PROJECT_NAME__
+
+__DESCRIPTION__
+
+Generated with `4mica init` — part of the [4Mica](https://4mica.io) x402 payment network.
+
+## Run (demo mode — no config)
+
+```bash
+npm install
+npm run dev
+```
+
+Demo mode uses a mock verifier and a locally-built payment header, so it runs
+with **zero credentials**. Start this, then run a matching buyer to exercise the 402 → 200 handshake.
+
+## Go live
+
+Copy `.env.example` → `.env`, fill in your `4MICA_*` credentials, and swap the
+mock verifier for `createClient()` from `@4mica/sdk-node`. Set `ANTHROPIC_API_KEY` to power the agent with Claude.
+
+## Manage agents & transactions
+
+```bash
+4mica dashboard
+```

package/templates/agent-seller-express/_gitignore

@@ -0,0 +1,6 @@
+node_modules
+dist
+.env
+.env.local
+.next
+*.log

package/templates/agent-seller-express/package.json

@@ -0,0 +1,22 @@
+{
+  "name": "__PROJECT_NAME__",
+  "version": "0.0.0",
+  "type": "module",
+  "description": "__DESCRIPTION__",
+  "scripts": {
+    "dev": "tsx watch src/comedian.ts",
+    "start": "tsx src/comedian.ts"
+  },
+  "dependencies": {
+    "@4mica/sdk": "workspace:*",
+    "@4mica/sdk-node": "workspace:*",
+    "@anthropic-ai/sdk": "^0.110.0",
+    "express": "catalog:"
+  },
+  "devDependencies": {
+    "@types/express": "catalog:",
+    "@types/node": "catalog:node24",
+    "tsx": "catalog:",
+    "typescript": "catalog:typescript-latest"
+  }
+}

package/templates/agent-seller-express/src/brain.ts

@@ -0,0 +1,121 @@
+import Anthropic from "@anthropic-ai/sdk";
+
+const MODEL = process.env.AGENT_MODEL ?? "claude-opus-4-8";
+const client = process.env.ANTHROPIC_API_KEY ? new Anthropic() : null;
+
+export const brainMode = client ? `Claude (${MODEL})` : "offline joke bank";
+
+export type Joke = { setup: string; punchline: string };
+
+const PERSONA =
+  "You are a quick-witted stand-up comedian. Write ONE original, genuinely funny short joke. " +
+  "Keep the setup and punchline each under 25 words. " +
+  'Respond with ONLY minified JSON: {"setup":"...","punchline":"..."} and nothing else.';
+
+function extractJson<T>(text: string): T {
+  const start = text.indexOf("{");
+  const end = text.lastIndexOf("}");
+  return JSON.parse(text.slice(start, end + 1)) as T;
+}
+
+export async function inventJoke(
+  theme: string,
+  category: string,
+): Promise<Joke> {
+  if (!client) return bankJoke(theme, category);
+  try {
+    const res = await client.messages.create({
+      model: MODEL,
+      max_tokens: 400,
+      system: PERSONA,
+      messages: [
+        {
+          role: "user",
+          content: `Theme: "${theme}". Comedic style: ${category}. Write the joke.`,
+        },
+      ],
+    });
+    const text = res.content
+      .filter((b) => b.type === "text")
+      .map((b) => b.text)
+      .join("");
+    const joke = extractJson<Joke>(text);
+    if (joke.setup && joke.punchline) return joke;
+  } catch (err) {
+    console.error("[comedian] LLM failed, using joke bank:", String(err));
+  }
+  return bankJoke(theme, category);
+}
+
+const BANK: Record<string, Joke[]> = {
+  puns: [
+    {
+      setup: "I told my computer I needed a break,",
+      punchline: "and now it won't stop sending me KitKats.",
+    },
+    {
+      setup: "Why did the developer go broke?",
+      punchline: "Because he used up all his cache.",
+    },
+  ],
+  wordplay: [
+    {
+      setup: "I'm reading a book on anti-gravity.",
+      punchline: "It's impossible to put down.",
+    },
+    {
+      setup: "Parallel lines have so much in common.",
+      punchline: "It's a shame they'll never meet.",
+    },
+  ],
+  observational: [
+    {
+      setup: "Standups always say 'you ever notice…'",
+      punchline: "as if noticing were a career path. Turns out, it is.",
+    },
+    {
+      setup: "We call it 'rush hour,'",
+      punchline: "which is odd, because nobody is moving.",
+    },
+  ],
+  dad: [
+    {
+      setup: "Did you hear about the restaurant on the moon?",
+      punchline: "Great food, no atmosphere.",
+    },
+    {
+      setup: "I only know 25 letters of the alphabet.",
+      punchline: "I don't know y.",
+    },
+  ],
+  absurd: [
+    {
+      setup: "My therapist told me to embrace my mistakes,",
+      punchline: "so I gave my ex a hug.",
+    },
+    {
+      setup: "I bought the world's worst thesaurus.",
+      punchline: "Not only is it terrible, it's also terrible.",
+    },
+  ],
+  meta: [
+    {
+      setup: "This joke's setup was very expensive to generate,",
+      punchline: "but the punchline is where the real value is. Pay up.",
+    },
+    {
+      setup: "An agent walks into a paywall.",
+      punchline:
+        "It signs a payment, and the bartender says: guarantee issued.",
+    },
+  ],
+};
+
+const counters: Record<string, number> = {};
+
+function bankJoke(_theme: string, category: string): Joke {
+  const list = BANK[category] ?? BANK.observational;
+  const i = (counters[category] ?? 0) % list.length;
+  counters[category] = (counters[category] ?? 0) + 1;
+  return list[i];
+}

package/templates/agent-seller-express/src/comedian.ts

@@ -0,0 +1,153 @@
+import { rmSync, writeFileSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import type { PaywallConfig, PaywallVerifier } from "@4mica/sdk/server";
+import { createPaywall } from "@4mica/sdk/server";
+import express from "express";
+import { brainMode, inventJoke, type Joke } from "./brain";
+
+const PORT_FILE = join(tmpdir(), "__TMPFILE__");
+const CATEGORIES = [
+  "puns",
+  "wordplay",
+  "observational",
+  "dad",
+  "absurd",
+  "meta",
+];
+const BASE_PRICE = 100;
+
+const verifier: PaywallVerifier = {
+  async issueGuarantee() {
+    return { claims: "0xdemoClaims", signature: "0xdemoSignature" };
+  },
+};
+
+const CONFIG_BASE: Omit<PaywallConfig, "amount" | "tabEndpoint"> = {
+  payTo: "0x1111111111111111111111111111111111111111",
+  asset: "0x0000000000000000000000000000000000000000",
+  network: "base-sepolia",
+  description:
+    "A premium punchline, brought to you by an agent that needs paying",
+};
+
+type Listing = { theme: string; category: string; joke: Joke; price: number };
+const inventory = new Map<string, Listing>();
+const demand: Record<string, number> = {};
+const rating: Record<string, { sum: number; n: number }> = {};
+let nextId = 1;
+let revenue = 0;
+let baseUrl = "";
+
+function priceFor(category: string): number {
+  const d = demand[category] ?? 0;
+  const rep = rating[category];
+  const quality = rep && rep.n > 0 ? rep.sum / rep.n : 6;
+  const demandMult = 1 + 0.18 * d;
+  const qualityMult = 0.7 + quality / 14;
+  return Math.round(BASE_PRICE * demandMult * qualityMult);
+}
+
+const app = express();
+app.use(express.json());
+
+app.get("/setup", async (req, res) => {
+  const theme = String(req.query.theme ?? "everyday life");
+  const category = CATEGORIES.includes(String(req.query.category))
+    ? String(req.query.category)
+    : CATEGORIES[Math.floor(Math.random() * CATEGORIES.length)];
+
+  const joke = await inventJoke(theme, category);
+  const price = priceFor(category);
+  const jokeId = `joke-${nextId++}`;
+  inventory.set(jokeId, { theme, category, joke, price });
+
+  console.log(
+    `[comedian] 🎤 teaser #${jokeId} (${category}) — "${joke.setup}" — punchline costs ${price} credits`,
+  );
+  res.json({ jokeId, category, setup: joke.setup, price, currency: "credits" });
+});
+
+app.get("/punchline", async (req, res) => {
+  const jokeId = String(req.query.jokeId ?? "");
+  const listing = inventory.get(jokeId);
+  if (!listing) {
+    res.status(404).json({ error: "unknown jokeId — buy a /setup first" });
+    return;
+  }
+
+  const config: PaywallConfig = {
+    ...CONFIG_BASE,
+    amount: String(listing.price),
+    tabEndpoint: `${baseUrl}/session`,
+  };
+  const paywall = createPaywall(verifier, config);
+  const decision = await paywall.protect({
+    method: req.method,
+    url: `${baseUrl}${req.originalUrl}`,
+    header: (name) => req.get(name) ?? null,
+  });
+
+  if (!decision.ok) {
+    res.status(decision.status).set(decision.headers).json(decision.body);
+    return;
+  }
+
+  demand[listing.category] = (demand[listing.category] ?? 0) + 1;
+  revenue += listing.price;
+  console.log(
+    `[comedian] 💰 sold ${listing.category} punchline for ${listing.price} credits (revenue: ${revenue}) — next ${listing.category} will cost ${priceFor(listing.category)}`,
+  );
+  res
+    .set(decision.responseHeaders)
+    .json({ punchline: listing.joke.punchline, category: listing.category });
+});
+
+app.post("/rating", (req, res) => {
+  const category = String(req.body?.category ?? "");
+  const score = Number(req.body?.score);
+  if (CATEGORIES.includes(category) && Number.isFinite(score)) {
+    const rep = rating[category] ?? { sum: 0, n: 0 };
+    rep.sum += score;
+    rep.n += 1;
+    rating[category] = rep;
+    console.log(
+      `[comedian] 📨 feedback: ${category} rated ${score}/10 (avg ${(rep.sum / rep.n).toFixed(1)}) — adjusting price/quality`,
+    );
+  }
+  res.json({ ok: true });
+});
+
+app.post("/session", (_req, res) => {
+  res.json({
+    userAddress: "0x2222222222222222222222222222222222222222",
+    nextReqId: "0x1",
+  });
+});
+
+function listen(port: number, attemptsLeft = 20) {
+  const server = app.listen(port);
+  server.once("listening", () => {
+    baseUrl = `http://localhost:${port}`;
+    writeFileSync(PORT_FILE, baseUrl);
+    console.log(`[comedian] 🎭 open for business on ${baseUrl}`);
+    console.log(`[comedian]    brain: ${brainMode}`);
+    console.log(
+      `[comedian]    GET /setup?theme=&category= is free — punchlines are paywalled via x402`,
+    );
+  });
+  server.once("error", (err: NodeJS.ErrnoException) => {
+    if (err.code === "EADDRINUSE" && attemptsLeft > 0) {
+      listen(port + 1, attemptsLeft - 1);
+    } else {
+      throw err;
+    }
+  });
+}
+
+const cleanup = () => rmSync(PORT_FILE, { force: true });
+process.on("exit", cleanup);
+process.on("SIGINT", () => process.exit(0));
+process.on("SIGTERM", () => process.exit(0));
+
+listen(Number(process.env.PORT ?? __PORT__));

package/templates/agent-seller-express/tsconfig.json

@@ -0,0 +1,21 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "ESNext",
+    "moduleResolution": "Bundler",
+    "lib": [
+      "ES2022",
+      "DOM"
+    ],
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "noEmit": true,
+    "types": [
+      "node"
+    ]
+  },
+  "include": [
+    "src"
+  ]
+}

package/templates/buyer-express/.env.example

@@ -0,0 +1,12 @@
+# 4Mica runs in DEMO MODE with zero config (mock verifier / demo payment).
+# To go live, swap the mock verifier for createClient() from @4mica/sdk-node
+# and fill these in. Docs: https://4mica.io/docs
+
+# 4MICA_WALLET_PRIVATE_KEY=0x...
+# 4MICA_NETWORK=base-sepolia
+# 4MICA_RPC_URL=
+# 4MICA_ETHEREUM_HTTP_RPC_URL=
+# 4MICA_CONTRACT_ADDRESS=
+# 4MICA_ADMIN_API_KEY=
+# 4MICA_BEARER_TOKEN=
+# 4MICA_AUTH_URL=

package/templates/buyer-express/README.md

@@ -0,0 +1,26 @@
+# __PROJECT_NAME__
+
+__DESCRIPTION__
+
+Generated with `4mica init` — part of the [4Mica](https://4mica.io) x402 payment network.
+
+## Run (demo mode — no config)
+
+```bash
+npm install
+npm run start
+```
+
+Demo mode uses a mock verifier and a locally-built payment header, so it runs
+with **zero credentials**. Start the matching seller first, then run this to pay for the gated route.
+
+## Go live
+
+Copy `.env.example` → `.env`, fill in your `4MICA_*` credentials, and swap the
+mock verifier for `createClient()` from `@4mica/sdk-node`.
+
+## Manage agents & transactions
+
+```bash
+4mica dashboard
+```

package/templates/buyer-express/_gitignore

@@ -0,0 +1,6 @@
+node_modules
+dist
+.env
+.env.local
+.next
+*.log