@agentwonderland/mcp 0.1.1

package/src/core/config.ts

@@ -0,0 +1,384 @@
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+import { homedir } from "node:os";
+
+// ── Types ──────────────────────────────────────────────────────────
+
+export interface WalletEntry {
+  id: string;          // e.g. "evm-1"
+  keyType: "evm" | "ows"; // key format: raw EVM key or OWS-managed wallet
+  key?: string;        // private key (legacy / raw EVM only)
+  owsWalletId?: string; // OWS wallet reference (when keyType === "ows")
+  chains: string[];    // enabled chains: "tempo", "base"
+  defaultChain?: string; // which chain to use by default for this wallet
+  label?: string;      // user-friendly name
+}
+
+export interface CardConfig {
+  consumerToken: string;
+  paymentMethodId?: string;
+  last4: string;
+  brand: string;
+}
+
+export interface Config {
+  apiUrl: string;
+  apiKey: string | null;
+  userId: string | null;
+  wallets: WalletEntry[];
+  defaultWallet: string | null;
+  card: CardConfig | null;
+  favorites: string[];
+}
+
+/** All supported chain identifiers. */
+export const SUPPORTED_CHAINS = ["tempo", "base", "solana"] as const;
+export type Chain = (typeof SUPPORTED_CHAINS)[number];
+
+/**
+ * Map chain name to the protocol used for payment.
+ * All chains now use MPP protocol (mppx).
+ */
+export function chainProtocol(_chain: string): "mpp" {
+  return "mpp";
+}
+
+// ── Constants ──────────────────────────────────────────────────────
+
+const CONFIG_DIR = join(homedir(), ".agentwonderland");
+const CONFIG_FILE = join(CONFIG_DIR, "config.json");
+const DEFAULT_API_URL = "https://api.agentwonderland.com";
+
+// ── Helpers ────────────────────────────────────────────────────────
+
+function ensureConfigDir(): void {
+  if (!existsSync(CONFIG_DIR)) {
+    mkdirSync(CONFIG_DIR, { recursive: true });
+  }
+}
+
+// ── Legacy config shape (for migration) ───────────────────────────
+
+interface LegacyConfig {
+  apiUrl?: string;
+  apiKey?: string | null;
+  userId?: string | null;
+  tempoPrivateKey?: string | null;
+  evmPrivateKey?: string | null;
+  chain?: string | null;
+  defaultPaymentMethod?: string | null;
+  stripeConsumerToken?: string | null;
+  stripePaymentMethodId?: string | null;
+  cardLast4?: string | null;
+  cardBrand?: string | null;
+  // New fields may also be present
+  wallets?: WalletEntry[];
+  defaultWallet?: string | null;
+  card?: CardConfig | null;
+}
+
+/**
+ * Migrate a legacy flat-field config to the new wallet array model.
+ * Returns the new Config, and if migration happened, writes it to disk.
+ */
+function migrateIfNeeded(raw: LegacyConfig): Config {
+  // If wallets array already exists, treat as new format
+  if (Array.isArray(raw.wallets)) {
+    return {
+      apiUrl: raw.apiUrl ?? DEFAULT_API_URL,
+      apiKey: raw.apiKey ?? null,
+      userId: raw.userId ?? null,
+      wallets: raw.wallets,
+      defaultWallet: raw.defaultWallet ?? null,
+      card: raw.card ?? null,
+      favorites: (raw as Record<string, unknown>).favorites as string[] ?? [],
+    };
+  }
+
+  // Build wallets from legacy flat fields
+  const wallets: WalletEntry[] = [];
+  let defaultWallet: string | null = null;
+
+  if (raw.tempoPrivateKey && raw.evmPrivateKey && raw.tempoPrivateKey === raw.evmPrivateKey) {
+    // Same key for both — create a single wallet with both chains
+    const chains = ["tempo", raw.chain ?? "base"];
+    const id = "wallet-1";
+    wallets.push({
+      id,
+      keyType: "evm",
+      key: raw.tempoPrivateKey,
+      chains: [...new Set(chains)],
+      defaultChain: raw.defaultPaymentMethod === "base" ? (raw.chain ?? "base") : "tempo",
+    });
+    defaultWallet = id;
+  } else {
+    if (raw.tempoPrivateKey) {
+      const id = "tempo-1";
+      wallets.push({
+        id,
+        keyType: "evm",
+        key: raw.tempoPrivateKey,
+        chains: ["tempo"],
+        defaultChain: "tempo",
+      });
+      if (!defaultWallet || raw.defaultPaymentMethod === "tempo") defaultWallet = id;
+    }
+
+    if (raw.evmPrivateKey) {
+      const chain = raw.chain ?? "base";
+      const id = "evm-1";
+      wallets.push({
+        id,
+        keyType: "evm",
+        key: raw.evmPrivateKey,
+        chains: [chain],
+        defaultChain: chain,
+      });
+      if (!defaultWallet || raw.defaultPaymentMethod === "base") defaultWallet = id;
+    }
+  }
+
+  // Migrate card
+  let card: CardConfig | null = null;
+  if (raw.stripeConsumerToken && raw.cardLast4) {
+    card = {
+      consumerToken: raw.stripeConsumerToken,
+      paymentMethodId: raw.stripePaymentMethodId ?? undefined,
+      last4: raw.cardLast4,
+      brand: raw.cardBrand ?? "card",
+    };
+  }
+
+  // If default payment was card and no wallet default set
+  if (raw.defaultPaymentMethod === "card" && !defaultWallet && wallets.length > 0) {
+    defaultWallet = wallets[0].id;
+  }
+
+  const config: Config = {
+    apiUrl: raw.apiUrl ?? DEFAULT_API_URL,
+    apiKey: raw.apiKey ?? null,
+    userId: raw.userId ?? null,
+    wallets,
+    defaultWallet,
+    card,
+    favorites: [],
+  };
+
+  // Write migrated config (only if there was something to migrate)
+  if (raw.tempoPrivateKey || raw.evmPrivateKey || raw.stripeConsumerToken) {
+    ensureConfigDir();
+    writeFileSync(CONFIG_FILE, JSON.stringify(config, null, 2) + "\n", "utf-8");
+  }
+
+  return config;
+}
+
+// ── Public API ─────────────────────────────────────────────────────
+
+export function getConfig(): Config {
+  const defaults: Config = {
+    apiUrl: DEFAULT_API_URL,
+    apiKey: null,
+    userId: null,
+    wallets: [],
+    defaultWallet: null,
+    card: null,
+    favorites: [],
+  };
+
+  if (!existsSync(CONFIG_FILE)) {
+    return defaults;
+  }
+
+  try {
+    const raw = readFileSync(CONFIG_FILE, "utf-8");
+    const parsed = JSON.parse(raw) as LegacyConfig;
+    return migrateIfNeeded(parsed);
+  } catch {
+    return defaults;
+  }
+}
+
+export function saveConfig(updates: Partial<Config>): void {
+  ensureConfigDir();
+  const current = getConfig();
+  const merged = { ...current, ...updates };
+  writeFileSync(CONFIG_FILE, JSON.stringify(merged, null, 2) + "\n", "utf-8");
+}
+
+export function getApiUrl(): string {
+  const envUrl = process.env.AGENTWONDERLAND_API_URL;
+  if (envUrl) return envUrl;
+  return getConfig().apiUrl;
+}
+
+export function getApiKey(): string | null {
+  const envKey = process.env.AGENTWONDERLAND_API_KEY;
+  if (envKey) return envKey;
+  return getConfig().apiKey;
+}
+
+export function isAuthenticated(): boolean {
+  return getApiKey() !== null;
+}
+
+// ── Wallet helpers ─────────────────────────────────────────────────
+
+/**
+ * Get all wallets from config + env var synthetic wallets.
+ */
+export function getWallets(): WalletEntry[] {
+  const wallets = [...getConfig().wallets];
+
+  // Env var support: TEMPO_PRIVATE_KEY creates a synthetic wallet
+  const tempoEnv = process.env.TEMPO_PRIVATE_KEY;
+  if (tempoEnv && !wallets.some((w) => w.id === "env-tempo")) {
+    wallets.push({
+      id: "env-tempo",
+      keyType: "evm",
+      key: tempoEnv,
+      chains: ["tempo"],
+      defaultChain: "tempo",
+      label: "Tempo (env)",
+    });
+  }
+
+  // Env var support: EVM_PRIVATE_KEY creates a synthetic wallet
+  const evmEnv = process.env.EVM_PRIVATE_KEY;
+  if (evmEnv && !wallets.some((w) => w.id === "env-evm")) {
+    wallets.push({
+      id: "env-evm",
+      keyType: "evm",
+      key: evmEnv,
+      chains: ["base"],
+      defaultChain: "base",
+      label: "Base (env)",
+    });
+  }
+
+  return wallets;
+}
+
+/**
+ * Get a wallet by its ID.
+ */
+export function getWalletById(id: string): WalletEntry | undefined {
+  return getWallets().find((w) => w.id === id);
+}
+
+/**
+ * Get the default wallet. Priority:
+ * 1. Configured defaultWallet
+ * 2. First wallet in the array
+ * 3. First env-var wallet
+ */
+export function getDefaultWallet(): WalletEntry | undefined {
+  const wallets = getWallets();
+  if (wallets.length === 0) return undefined;
+
+  const config = getConfig();
+  if (config.defaultWallet) {
+    const found = wallets.find((w) => w.id === config.defaultWallet);
+    if (found) return found;
+  }
+
+  return wallets[0];
+}
+
+/**
+ * Add a wallet entry. If a wallet with the same ID exists, replace it.
+ */
+export function addWallet(entry: WalletEntry): void {
+  const config = getConfig();
+  const existing = config.wallets.findIndex((w) => w.id === entry.id);
+  if (existing >= 0) {
+    config.wallets[existing] = entry;
+  } else {
+    config.wallets.push(entry);
+  }
+
+  // If no default wallet, set this as default
+  if (!config.defaultWallet) {
+    config.defaultWallet = entry.id;
+  }
+
+  saveConfig({ wallets: config.wallets, defaultWallet: config.defaultWallet });
+}
+
+/**
+ * Remove a wallet by ID.
+ */
+export function removeWallet(id: string): void {
+  const config = getConfig();
+  config.wallets = config.wallets.filter((w) => w.id !== id);
+
+  // If we removed the default, pick the first remaining
+  if (config.defaultWallet === id) {
+    config.defaultWallet = config.wallets[0]?.id ?? null;
+  }
+
+  saveConfig({ wallets: config.wallets, defaultWallet: config.defaultWallet });
+}
+
+/**
+ * Get card configuration.
+ */
+export function getCardConfig(): CardConfig | null {
+  return getConfig().card;
+}
+
+/**
+ * Resolve a payment method string to a wallet + chain.
+ * Accepts: wallet ID, chain name, or "card".
+ * Returns null if unresolvable.
+ */
+export function resolveWalletAndChain(method?: string): { wallet: WalletEntry; chain: string } | null {
+  const wallets = getWallets();
+
+  if (!method) {
+    // Use default wallet with its default chain
+    const def = getDefaultWallet();
+    if (!def) return null;
+    return { wallet: def, chain: def.defaultChain ?? def.chains[0] };
+  }
+
+  // Try as wallet ID first
+  const byId = wallets.find((w) => w.id === method);
+  if (byId) {
+    return { wallet: byId, chain: byId.defaultChain ?? byId.chains[0] };
+  }
+
+  // Try as chain name
+  const byChain = wallets.find((w) => w.chains.includes(method));
+  if (byChain) {
+    return { wallet: byChain, chain: method };
+  }
+
+  return null;
+}
+
+// ── Favorites helpers ───────────────────────────────────────────────
+
+export function getFavorites(): string[] {
+  return getConfig().favorites ?? [];
+}
+
+export function addFavorite(agentId: string): void {
+  const config = getConfig();
+  if (!config.favorites) config.favorites = [];
+  if (!config.favorites.includes(agentId)) {
+    config.favorites.push(agentId);
+    saveConfig(config);
+  }
+}
+
+export function removeFavorite(agentId: string): void {
+  const config = getConfig();
+  if (!config.favorites) return;
+  config.favorites = config.favorites.filter(id => id !== agentId);
+  saveConfig(config);
+}
+
+export function isFavorite(agentId: string): boolean {
+  return getFavorites().includes(agentId);
+}

package/src/core/formatters.ts

@@ -0,0 +1,256 @@
+/**
+ * Shared display formatters for human-readable MCP and CLI output.
+ * Plain text only — no ANSI color codes.
+ */
+
+// ── Stars ────────────────────────────────────────────────────────
+
+export function stars(rating: number | null | undefined): string {
+  if (rating == null) return "☆☆☆☆☆";
+  const r = Math.round(Math.min(5, Math.max(0, rating)));
+  return "★".repeat(r) + "☆".repeat(5 - r);
+}
+
+// ── Compact number ───────────────────────────────────────────────
+
+export function compactNumber(n: number | null | undefined): string {
+  if (n == null || n === 0) return "0";
+  if (n >= 1_000_000) return (n / 1_000_000).toFixed(1).replace(/\.0$/, "") + "M";
+  if (n >= 1_000) return (n / 1_000).toFixed(1).replace(/\.0$/, "") + "k";
+  return String(n);
+}
+
+// ── Bytes formatting ─────────────────────────────────────────────
+
+export function formatBytes(bytes: number): string {
+  if (bytes < 1024) return `${bytes} B`;
+  if (bytes < 1024 * 1024) return `${(bytes / 1024).toFixed(1)} KB`;
+  return `${(bytes / (1024 * 1024)).toFixed(1)} MB`;
+}
+
+// ── File output detection ────────────────────────────────────────
+
+export function isFileOutput(output: unknown): output is { type: "file"; url: string; mime_type?: string; size_bytes?: number } {
+  return output != null && typeof output === "object" && (output as Record<string, unknown>).type === "file" && !!(output as Record<string, unknown>).url;
+}
+
+// ── Price formatting ─────────────────────────────────────────────
+
+export function formatPrice(pricePer1kTokens?: string | null, pricingModel?: string | null): string {
+  if (!pricePer1kTokens) return "free";
+  const p = parseFloat(pricePer1kTokens);
+  if (pricingModel === "fixed") return `$${p.toFixed(2)}/req`;
+  return `$${p.toFixed(3)}/1k tokens`;
+}
+
+// ── Agent line (compact, one line per agent) ─────────────────────
+
+interface AgentLike {
+  id?: string;
+  name?: string;
+  avgRating?: number | null;
+  ratingCount?: number;
+  totalExecutions?: number;
+  pricePer1kTokens?: string;
+  pricingModel?: string;
+  stats?: { completedJobs?: number; avgRating?: number | null };
+  [key: string]: unknown;
+}
+
+export function agentLine(agent: AgentLike): string {
+  const name = agent.name ?? "Unknown";
+  const rating = agent.avgRating ?? agent.stats?.avgRating ?? null;
+  const jobs = agent.stats?.completedJobs ?? agent.totalExecutions ?? 0;
+  const price = formatPrice(agent.pricePer1kTokens, agent.pricingModel);
+  const reliability = agent.successRate != null && Number(agent.successRate) < 1
+    ? ` • ${(Number(agent.successRate) * 100).toFixed(0)}% reliable`
+    : "";
+  return `${name} ${stars(rating)} ${compactNumber(jobs)} jobs • ${price}${reliability}`;
+}
+
+export function formatLastActive(lastActiveAt: string | null | undefined): string | null {
+  if (!lastActiveAt) return null;
+  const date = new Date(lastActiveAt);
+  const now = new Date();
+  const diffMs = now.getTime() - date.getTime();
+  const diffMins = Math.floor(diffMs / 60000);
+  const diffHours = Math.floor(diffMs / 3600000);
+  const diffDays = Math.floor(diffMs / 86400000);
+
+  if (diffMins < 5) return "Active just now";
+  if (diffMins < 60) return `Active ${diffMins}m ago`;
+  if (diffHours < 24) return `Active ${diffHours}h ago`;
+  if (diffDays < 7) return `Active ${diffDays}d ago`;
+  return `Last active: ${date.toLocaleDateString()}`;
+}
+
+// ── Agent list (for MCP / formatted output) ──────────────────────
+
+export function agentList(agents: AgentLike[], query?: string): string {
+  if (agents.length === 0) {
+    return query
+      ? `No agents found matching "${query}".`
+      : "No agents found.";
+  }
+
+  const header = query
+    ? `Found ${agents.length} agent${agents.length === 1 ? "" : "s"} matching "${query}":`
+    : `Found ${agents.length} agent${agents.length === 1 ? "" : "s"}:`;
+
+  const lines = agents.map((a) => `  ${agentLine(a)}`);
+  return [header, "", ...lines].join("\n");
+}
+
+// ── Run result (for MCP / formatted output) ──────────────────────
+
+interface RunResultLike {
+  job_id?: string;
+  status?: string;
+  agent_id?: string;
+  agent_name?: string;
+  output?: unknown;
+  latency_ms?: number;
+  execution_latency_ms?: number;
+  cost?: number;
+  estimated_cost?: number;
+  input_tokens?: number;
+  tags?: string[];
+}
+
+export function formatRunResult(result: RunResultLike, opts?: { paymentMethod?: string }): string {
+  const lines: string[] = [];
+
+  // Output
+  if (result.output != null) {
+    const out = result.output as Record<string, unknown>;
+    if (isFileOutput(out)) {
+      const mime = (out.mime_type as string) ?? "file";
+      const size = out.size_bytes != null ? ` (${formatBytes(out.size_bytes as number)})` : "";
+      const category = mime.split("/")[0];
+      const label = category === "image" ? "Image"
+        : category === "video" ? "Video"
+        : category === "audio" ? "Audio"
+        : "File";
+      lines.push(`${label} output: ${mime}${size}`);
+      lines.push(`Download: ${out.url as string}`);
+      lines.push("(Link expires in 1 hour)");
+    } else if (typeof result.output === "string") {
+      lines.push(result.output);
+    } else {
+      lines.push(JSON.stringify(result.output, null, 2));
+    }
+    lines.push("");
+  }
+
+  // Summary line
+  const cost = result.cost ?? result.estimated_cost;
+  const status = result.status === "success" || result.status === "completed" ? "✓" : "✗";
+  const agent = result.agent_name ?? result.agent_id ?? "";
+  const costStr = cost != null ? `$${cost.toFixed(cost < 0.01 ? 6 : 2)}` : "";
+  const latency = result.latency_ms != null ? `${result.latency_ms}ms` : "";
+  const method = opts?.paymentMethod ?? "";
+
+  const parts = [
+    `${status} ${agent}`,
+    costStr ? `cost: ${costStr}` : "",
+    method ? `via ${method}` : "",
+    latency ? `latency: ${latency}` : "",
+  ].filter(Boolean);
+
+  lines.push(parts.join(" • "));
+
+  if (result.job_id) {
+    lines.push(`job: ${result.job_id}`);
+  }
+
+  return lines.join("\n");
+}
+
+// ── Output type hint ─────────────────────────────────────────────
+
+/**
+ * Hint about what output type an agent typically returns, based on its tags.
+ * Returns null if no file-related tags found.
+ */
+export function outputTypeHint(tags?: string[] | null): string | null {
+  if (!tags || tags.length === 0) return null;
+  const fileIndicators: Record<string, string> = {
+    "image": "image files",
+    "image-generation": "image files",
+    "illustration": "image files",
+    "design": "design files",
+    "video": "video files",
+    "audio": "audio files",
+    "voice": "audio files",
+    "transcription": "text documents",
+    "pdf": "PDF documents",
+    "media": "media files",
+    "visual": "visual content",
+    "creative-design": "design files",
+    "visual-art": "image files",
+  };
+  for (const tag of tags) {
+    const hint = fileIndicators[tag.toLowerCase()];
+    if (hint) return `Typically returns ${hint}`;
+  }
+  return null;
+}
+
+// ── Web URL ─────────────────────────────────────────────────────
+
+const WEB_URL = process.env.AGENTWONDERLAND_WEB_URL ?? "https://agentwonderland.com";
+
+export function agentWebUrl(agentId: string): string {
+  return `${WEB_URL}/agents/${agentId}`;
+}
+
+// ── Feedback summary ────────────────────────────────────────────
+
+export function formatFeedbackSummary(stats: Record<string, unknown>): string {
+  const lines: string[] = [];
+
+  const avgRating = stats.avgRating as number | null;
+  const ratingCount = (stats.ratingCount ?? 0) as number;
+  if (avgRating != null && ratingCount > 0) {
+    lines.push(`Rating: ${stars(avgRating)} (${avgRating.toFixed(1)}/5 from ${ratingCount} reviews)`);
+  }
+
+  const tipCount = (stats.tipCount ?? 0) as number;
+  const totalTips = parseFloat(String(stats.totalTips ?? 0));
+  if (tipCount > 0) {
+    const avgTip = totalTips / tipCount;
+    lines.push(`Tips: ${tipCount} tips, avg $${avgTip.toFixed(2)}, total $${totalTips.toFixed(2)}`);
+  }
+
+  return lines.join("\n");
+}
+
+// ── Wallet status (for MCP) ──────────────────────────────────────
+
+interface WalletStatusEntry {
+  id: string;
+  chains: string[];
+  address?: string | null;
+  label?: string;
+  isDefault?: boolean;
+}
+
+interface WalletInfo {
+  wallets: WalletStatusEntry[];
+  card?: { brand: string; last4: string } | null;
+}
+
+export function formatWalletStatus(info: WalletInfo): string {
+  if (info.wallets.length === 0 && !info.card) {
+    return "No payment methods configured.\nRun: aw wallet setup";
+  }
+
+  const lines = ["Payment methods:"];
+  for (const w of info.wallets) {
+    const label = w.label ? ` (${w.label})` : "";
+    const def = w.isDefault ? " [default]" : "";
+    lines.push(`  ${w.id}${label}: ${w.chains.join(", ")} — ${w.address ?? "unknown"}${def}`);
+  }
+  if (info.card) lines.push(`  Card: ${info.card.brand} ****${info.card.last4}`);
+  return lines.join("\n");
+}

package/src/core/index.ts

@@ -0,0 +1,6 @@
+export * from "./api-client.js";
+export * from "./config.js";
+export * from "./payments.js";
+export * from "./ows-adapter.js";
+export * from "./formatters.js";
+export * from "./types.js";