create-yonderclaw 1.0.0

package/installer/modules/custom/metaclaw-module.json

@@ -0,0 +1,15 @@
+{
+  "name": "custom",
+  "displayName": "Custom Agent",
+  "version": "1.0.0",
+  "description": "General-purpose agent — describe what you need, AI configures it",
+  "category": "agent-type",
+  "engines": { "metaclaw": ">=3.3.0" },
+  "requires": { "modules": ["core", "scheduler"] },
+  "contributes": {
+    "src": { "agent-custom.ts.txt": "src/agent.ts" },
+    "npmScripts": { "start": "tsx src/agent.ts", "dry-run": "tsx src/agent.ts --dry-run" },
+    "claudeMd": ["custom-commands"]
+  },
+  "placeholders": ["__AGENT_NAME__", "__SESSION_NAME__", "__SYSTEM_PROMPT__"]
+}

package/installer/modules/custom/src/agent-custom.ts.txt

@@ -0,0 +1,100 @@
+/**
+ * __AGENT_NAME__ — Custom Claw
+ * Generated by MetaClaw Installer v3.3.0
+ *
+ * This is a blank-slate agent configured by Claude's research phase.
+ * The system prompt below was AI-generated based on your requirements.
+ */
+
+import { query } from "@anthropic-ai/claude-agent-sdk";
+import type { SDKResultMessage, SDKResultSuccess, SDKAssistantMessage, Options } from "@anthropic-ai/claude-agent-sdk";
+import { getDb, recordAction, getTodayMetrics, getCircuitBreaker, getConfig } from "./db.js";
+import { checkCanAct } from "./safety.js";
+import { log } from "./observability.js";
+import { recordOutcome, getCurrentPrompt } from "./self-improve.js";
+import { runSelfUpdate } from "./self-update.js";
+
+const DRY_RUN = process.argv.includes("--dry-run");
+const STATUS = process.argv.includes("--status");
+
+if (STATUS) {
+  getDb();
+  const metrics = getTodayMetrics();
+  const breaker = getCircuitBreaker("main");
+  console.log("__AGENT_NAME__ Status");
+  console.log("=".repeat(40));
+  console.log("Circuit breaker:", breaker?.state?.toUpperCase() || "CLOSED");
+  if (metrics) {
+    console.log("Today:", metrics.actions_taken, "actions, $" + (metrics.total_cost_usd || 0).toFixed(4));
+  } else {
+    console.log("No activity today.");
+  }
+  process.exit(0);
+}
+
+const DEFAULT_SYSTEM_PROMPT = `__SYSTEM_PROMPT__`;
+
+async function main() {
+  getDb();
+  // NOTE: self-update runs AFTER task, NOT before (AXIOM Bug #1)
+
+  const task = process.argv.slice(2).filter(a => !a.startsWith("--")).join(" ");
+
+  if (!task && !DRY_RUN) {
+    console.log("__AGENT_NAME__ — Custom Claw");
+    console.log("");
+    console.log("Usage:");
+    console.log('  npm start -- "your task or instruction"');
+    console.log('  npm run dry-run -- "task"');
+    console.log("  npm run status");
+    process.exit(0);
+  }
+
+  const safety = checkCanAct();
+  if (!safety.allowed) {
+    console.log("BLOCKED: " + safety.reason);
+    process.exit(0);
+  }
+
+  const systemPrompt = getCurrentPrompt("custom") || DEFAULT_SYSTEM_PROMPT;
+
+  console.log("__AGENT_NAME__" + (DRY_RUN ? " (DRY RUN)" : ""));
+  log("info", "agent.start", { task, dryRun: DRY_RUN });
+
+  try {
+    const stream = query({
+      prompt: task || "Run your default task as described in your system prompt.",
+      options: {
+        systemPrompt,
+        allowedTools: ["WebSearch", "WebFetch", "Read", "Write", "Bash", "Glob", "Grep"],
+        maxTurns: 30,
+        model: "claude-sonnet-4-6",
+      },
+    });
+
+    for await (const message of stream) {
+      if (message.type === "assistant") {
+        const msg = message as any;
+        if (msg.message?.content) {
+          for (const block of msg.message.content) {
+            if (block.type === "text") console.log(block.text);
+          }
+        }
+      }
+      if (message.type === "result" && (message as any).subtype === "success") {
+        const s = message as SDKResultSuccess;
+        console.log("\nDone ($" + s.total_cost_usd.toFixed(4) + ")");
+        recordAction("custom_task", task || "default", "success", undefined, s.total_cost_usd);
+        recordOutcome("custom", 8);
+      }
+    }
+  } catch (err: unknown) {
+    const msg = err instanceof Error ? err.message : String(err);
+    log("error", "agent.error", { error: msg });
+    recordAction("custom_task", task || "default", "error", msg);
+  }
+}
+
+  // Self-update AFTER task (never before)
+  try { await runSelfUpdate(); } catch { /* non-critical */ }
+main();

package/installer/modules/dashboard/metaclaw-module.json

@@ -0,0 +1,23 @@
+{
+  "name": "dashboard",
+  "displayName": "Dashboard — Command Center",
+  "version": "1.0.0",
+  "description": "HTML Command Center with real-time metrics, KPIs per agent type, Edge app-mode launcher",
+  "category": "ui",
+  "alwaysInstall": true,
+  "engines": { "metaclaw": ">=3.3.0" },
+  "requires": { "modules": ["core"] },
+  "contributes": {
+    "src": {
+      "update-dashboard.ts.txt": "src/update-dashboard.ts"
+    },
+    "scripts": {
+      "build-dashboard.cjs.txt": "scripts/build-dashboard.cjs"
+    },
+    "npmScripts": {
+      "dashboard": "tsx src/update-dashboard.ts && node scripts/build-dashboard.cjs"
+    },
+    "claudeMd": ["dashboard"]
+  },
+  "placeholders": ["__AGENT_NAME__", "__CLAW_TYPE__", "__PROJECT_DIR__"]
+}

package/installer/modules/dashboard/scripts/build-dashboard.cjs.txt

@@ -0,0 +1,51 @@
+/**
+ * Dashboard Builder — bakes data inline for file:// compatibility
+ * Auto-generated by MetaClaw Installer
+ *
+ * Pattern from AXIOM: HTML has <script type="application/json"> placeholders.
+ * This script reads JSON files and injects them inline.
+ * Dashboard JS uses tryInline() || fetch() — works both offline and served.
+ *
+ * Run: node scripts/build-dashboard.cjs
+ * Also called by cron after each agent cycle.
+ */
+
+const fs = require('fs');
+const path = require('path');
+
+const PROJECT = __dirname.replace(/[\\/]scripts$/, '');
+const DASH_PATH = path.join(PROJECT, 'dashboard.html');
+const DATA_DIR = path.join(PROJECT, 'data');
+
+function readJSON(filePath) {
+  try { return fs.readFileSync(filePath, 'utf-8').trim(); }
+  catch { return 'null'; }
+}
+
+// Data sources to bake into the dashboard
+const replacements = {
+  'inline-dashboard': readJSON(path.join(DATA_DIR, 'dashboard.json')),
+  'inline-state': readJSON(path.join(DATA_DIR, 'state.json')),
+  'inline-context': readJSON(path.join(DATA_DIR, 'system-context.json')),
+};
+
+if (!fs.existsSync(DASH_PATH)) {
+  console.log('dashboard.html not found at ' + DASH_PATH);
+  process.exit(0);
+}
+
+let html = fs.readFileSync(DASH_PATH, 'utf-8');
+let replaced = 0;
+
+for (const [id, json] of Object.entries(replacements)) {
+  const regex = new RegExp(
+    '(<script id="' + id + '" type="application/json">)[\\s\\S]*?(</script>)'
+  );
+  if (regex.test(html)) {
+    html = html.replace(regex, '$1' + json + '$2');
+    replaced++;
+  }
+}
+
+fs.writeFileSync(DASH_PATH, html, 'utf-8');
+console.log('Dashboard rebuilt — ' + replaced + ' data source(s) baked inline.');

package/installer/modules/dashboard/src/update-dashboard.ts.txt

@@ -0,0 +1,126 @@
+/**
+ * Dashboard Data Generator — universal for all Claws
+ * Reads all DB tables and writes dashboard.json for the HTML dashboard.
+ * Auto-generated by MetaClaw Installer v3.3.0
+ *
+ * Run: npm run dashboard
+ * Also called by self-update module automatically.
+ */
+
+import Database from "better-sqlite3";
+import fs from "fs";
+import path from "path";
+import { fileURLToPath } from "url";
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const DB_PATH = path.join(__dirname, "..", "data", "claw.db");
+const LOG_DIR = path.join(__dirname, "..", "data", "logs");
+const OUTPUT = path.join(__dirname, "..", "data", "dashboard.json");
+
+function main() {
+  if (!fs.existsSync(DB_PATH)) {
+    console.log("No database found. Run the agent first.");
+    return;
+  }
+
+  const db = new Database(DB_PATH);
+  db.pragma("journal_mode = WAL");
+
+  const now = new Date();
+  const today = now.toISOString().slice(0, 10);
+
+  // Today's metrics
+  const todayMetrics = db.prepare("SELECT * FROM daily_metrics WHERE date = ?").get(today) as any || {
+    actions_taken: 0, actions_succeeded: 0, actions_failed: 0, total_cost_usd: 0, total_tokens: 0
+  };
+
+  // Circuit breaker
+  const circuitBreaker = db.prepare("SELECT * FROM circuit_breaker WHERE name = 'main'").get() as any || { state: 'closed' };
+
+  // Safety config (from config table)
+  let safetyConfig = { maxActionsPerDay: 50, maxActionsPerHour: 10 };
+  try {
+    const raw = db.prepare("SELECT value FROM config WHERE key = 'safety_config'").get() as any;
+    if (raw) safetyConfig = JSON.parse(raw.value);
+  } catch {}
+
+  // Prompt version info
+  let promptVersion = null;
+  try {
+    promptVersion = db.prepare(
+      "SELECT version, avg_score, total_runs, created_by FROM prompt_versions WHERE is_active = 1 ORDER BY version DESC LIMIT 1"
+    ).get() as any;
+  } catch {}
+
+  // Recent actions
+  const recentActions = db.prepare(
+    "SELECT action_type, target, status, cost_usd, created_at FROM action_log ORDER BY created_at DESC LIMIT 20"
+  ).all() as any[];
+
+  // Self-improvement info
+  let selfImprovement: any = {};
+  try {
+    const lastUpdate = db.prepare("SELECT value FROM config WHERE key = 'last_self_update'").get() as any;
+    const interval = db.prepare("SELECT value FROM config WHERE key = 'self_update_interval_ms'").get() as any;
+    const totalVersions = db.prepare("SELECT COUNT(*) as cnt FROM prompt_versions").get() as any;
+    const currentVersion = db.prepare(
+      "SELECT total_runs FROM prompt_versions WHERE is_active = 1 ORDER BY version DESC LIMIT 1"
+    ).get() as any;
+
+    selfImprovement = {
+      last_update: lastUpdate?.value || null,
+      interval_hours: interval ? Math.round(parseInt(interval.value) / 3600000) : 6,
+      total_versions: totalVersions?.cnt || 1,
+      next_optimize_at: currentVersion ? "run #" + (Math.ceil((currentVersion.total_runs + 1) / 30) * 30) : "run #30",
+    };
+  } catch {}
+
+  // Log stats
+  const logFile = path.join(LOG_DIR, "agent-" + today + ".jsonl");
+  let logStats = { total: 0, errors: 0, warnings: 0 };
+  if (fs.existsSync(logFile)) {
+    const lines = fs.readFileSync(logFile, "utf-8").trim().split("\n").filter(Boolean);
+    logStats.total = lines.length;
+    for (const line of lines) {
+      try {
+        const entry = JSON.parse(line);
+        if (entry.level === "error") logStats.errors++;
+        if (entry.level === "warn") logStats.warnings++;
+      } catch {}
+    }
+  }
+
+  // All-time metrics
+  const allMetrics = db.prepare("SELECT * FROM daily_metrics ORDER BY date DESC LIMIT 7").all() as any[];
+  const totalCost = allMetrics.reduce((sum: number, m: any) => sum + ((m.total_cost_usd as number) || 0), 0);
+
+  // Suppression count
+  let suppressionCount = 0;
+  try {
+    suppressionCount = (db.prepare("SELECT COUNT(*) as cnt FROM suppression_list").get() as any).cnt;
+  } catch {}
+
+  // Build dashboard data
+  const dashboard = {
+    generated_at: now.toISOString(),
+    agent_name: "__AGENT_NAME__",
+    claw_type: "__CLAW_TYPE__",
+
+    today_metrics: todayMetrics,
+    circuit_breaker: circuitBreaker,
+    safety_config: safetyConfig,
+    prompt_version: promptVersion,
+    recent_actions: recentActions,
+    self_improvement: selfImprovement,
+    logs: logStats,
+    suppression_count: suppressionCount,
+    total_cost: Math.round(totalCost * 100) / 100,
+    daily_metrics: allMetrics,
+  };
+
+  fs.mkdirSync(path.dirname(OUTPUT), { recursive: true });
+  fs.writeFileSync(OUTPUT, JSON.stringify(dashboard, null, 2));
+  console.log("Dashboard data written to " + OUTPUT);
+}
+
+main();

package/installer/modules/outreach/metaclaw-module.json

@@ -0,0 +1,29 @@
+{
+  "name": "outreach",
+  "displayName": "Outreach Agent",
+  "version": "1.0.0",
+  "description": "Email prospecting, follow-ups, inbox monitoring, morning reports, reply classification",
+  "category": "agent-type",
+  "engines": { "metaclaw": ">=3.3.0" },
+  "requires": { "modules": ["core", "scheduler"] },
+  "contributes": {
+    "src": {
+      "agent-outreach.ts.txt": "src/agent.ts",
+      "inbox-agent.ts.txt": "src/inbox-agent.ts",
+      "morning-report.ts.txt": "src/morning-report.ts"
+    },
+    "npmScripts": {
+      "start": "tsx src/agent.ts",
+      "dry-run": "tsx src/agent.ts --dry-run",
+      "check-inbox": "tsx src/inbox-agent.ts",
+      "morning-report": "tsx src/morning-report.ts"
+    },
+    "claudeMd": ["outreach-commands"],
+    "dependencies": {
+      "nodemailer": "latest",
+      "imapflow": "latest",
+      "mailparser": "latest"
+    }
+  },
+  "placeholders": ["__AGENT_NAME__", "__SESSION_NAME__", "__SYSTEM_PROMPT__"]
+}

package/installer/modules/outreach/src/agent-outreach.ts.txt

@@ -0,0 +1,193 @@
+/**
+ * __AGENT_NAME__ — Outreach Claw
+ * Generated by MetaClaw Installer v3.3.0
+ *
+ * Full pipeline: research → safety → draft → AI detection → send → follow-up → inbox → auto-reply
+ */
+
+import { query, tool, createSdkMcpServer } from "@anthropic-ai/claude-agent-sdk";
+import type { SDKResultMessage, SDKResultSuccess, SDKAssistantMessage, Options } from "@anthropic-ai/claude-agent-sdk";
+import { z } from "zod/v4";
+import { getDb, recordAction, getTodayMetrics, getCircuitBreaker, isSuppressed, getConfig, setConfig } from "./db.js";
+import { checkCanAct, SAFETY_CONFIG } from "./safety.js";
+import { log } from "./observability.js";
+import { recordOutcome, shouldOptimize, getCurrentPrompt, savePromptVersion } from "./self-improve.js";
+import { runSelfUpdate } from "./self-update.js";
+
+const DRY_RUN = process.argv.includes("--dry-run");
+const STATUS = process.argv.includes("--status");
+
+// --- Status Mode ---
+if (STATUS) {
+  getDb();
+  const metrics = getTodayMetrics();
+  const breaker = getCircuitBreaker("main");
+  console.log("__AGENT_NAME__ Status");
+  console.log("=".repeat(40));
+  console.log("Circuit breaker:", breaker?.state?.toUpperCase() || "CLOSED");
+  if (metrics) {
+    console.log("Today:", metrics.actions_taken, "actions,", metrics.actions_succeeded, "succeeded");
+    console.log("Cost: $" + (metrics.total_cost_usd || 0).toFixed(4));
+  } else {
+    console.log("No activity today.");
+  }
+  // Check self-update schedule
+  const lastUpdate = getConfig("last_self_update");
+  console.log("Last self-update:", lastUpdate || "never");
+  process.exit(0);
+}
+
+// --- Custom MCP Tools ---
+
+const safetyCheckTool = tool(
+  "check_recipient",
+  "Check if safe to send to this email. Checks suppression, dedup, rate limits, circuit breaker.",
+  { email: z.string().describe("Recipient email address") },
+  async (args) => {
+    const check = checkCanAct(args.email);
+    if (!check.allowed) return { content: [{ type: "text" as const, text: "BLOCKED: " + check.reason }] };
+    return { content: [{ type: "text" as const, text: "OK: Safe to send to " + args.email }] };
+  }
+);
+
+const saveDraftTool = tool(
+  "save_draft",
+  "Save a drafted outreach email. Records to database. Always call check_recipient FIRST.",
+  {
+    to: z.string().describe("Recipient email address"),
+    subject: z.string().describe("Email subject — casual, lowercase, under 50 chars"),
+    body: z.string().describe("Email body — under 80 words, single CTA, casual"),
+    prospect: z.string().describe("Prospect name"),
+    company: z.string().describe("Company"),
+    researchNotes: z.string().describe("Research findings used to personalize"),
+  },
+  async (args) => {
+    const check = checkCanAct(args.to);
+    if (!check.allowed) return { content: [{ type: "text" as const, text: "BLOCKED: " + check.reason }] };
+
+    // Record the draft
+    recordAction("draft", args.to, "success", JSON.stringify({ subject: args.subject, body: args.body, prospect: args.prospect, company: args.company }));
+
+    console.log("\n" + "=".repeat(50));
+    console.log("DRAFT");
+    console.log("To: " + args.to);
+    console.log("Subject: " + args.subject);
+    console.log("-".repeat(50));
+    console.log(args.body);
+    console.log("=".repeat(50));
+
+    if (DRY_RUN) {
+      return { content: [{ type: "text" as const, text: "Draft saved. DRY RUN — not sending." }] };
+    }
+
+    // TODO: Wire in mailer.ts for actual sending
+    // For now, record as drafted
+    return { content: [{ type: "text" as const, text: "Draft saved. Configure SMTP in npm run setup to enable sending." }] };
+  }
+);
+
+const customTools = createSdkMcpServer({
+  name: "__SESSION_NAME__",
+  version: "1.0.0",
+  tools: [safetyCheckTool, saveDraftTool],
+});
+
+// --- System Prompt ---
+const DEFAULT_SYSTEM_PROMPT = `__SYSTEM_PROMPT__`;
+
+// --- Main ---
+async function main() {
+  getDb();
+  // NOTE: self-update runs AFTER task, NOT before (AXIOM Bug #1 — blocks real work)
+
+  const args = process.argv.slice(2).filter(a => !a.startsWith("--"));
+  const prospect = args[0] || "";
+  const company = args[1] || "";
+
+  if (!prospect && !DRY_RUN) {
+    console.log("__AGENT_NAME__ — Outreach Claw");
+    console.log("");
+    console.log("Usage:");
+    console.log('  npm start -- "Prospect Name" "Company"');
+    console.log('  npm run dry-run -- "Prospect Name" "Company"');
+    console.log("  npm run status");
+    process.exit(0);
+  }
+
+  const safety = checkCanAct();
+  if (!safety.allowed) {
+    console.log("BLOCKED: " + safety.reason);
+    process.exit(0);
+  }
+
+  // Use self-improved prompt if available, otherwise default
+  const systemPrompt = getCurrentPrompt("outreach") || DEFAULT_SYSTEM_PROMPT;
+
+  const userPrompt = prospect
+    ? "Research " + prospect + " at " + company + " and draft a personalized outreach email. Start with check_recipient."
+    : "Pick a sample prospect and draft a demo outreach email. Use check_recipient and save_draft.";
+
+  console.log("__AGENT_NAME__" + (DRY_RUN ? " (DRY RUN)" : ""));
+  console.log("Prospect: " + (prospect || "(demo mode)"));
+  log("info", "agent.start", { prospect, company, dryRun: DRY_RUN });
+
+  const options: Options = {
+    systemPrompt,
+    allowedTools: [
+      "WebSearch", "WebFetch",
+      "mcp____SESSION_NAME____check_recipient",
+      "mcp____SESSION_NAME____save_draft",
+    ],
+    mcpServers: { "__SESSION_NAME__": customTools },
+    maxTurns: 20,
+    model: "claude-sonnet-4-6",
+  };
+
+  try {
+    const stream = query({ prompt: userPrompt, options });
+    let resultText = "";
+
+    for await (const message of stream) {
+      if (message.type === "assistant") {
+        const msg = message as SDKAssistantMessage;
+        if (msg.message?.content) {
+          for (const block of msg.message.content) {
+            if (block.type === "text" && "text" in block) {
+              const text = (block as any).text;
+              console.log(text);
+              resultText += text;
+            }
+          }
+        }
+      }
+      if (message.type === "result") {
+        const result = message as SDKResultMessage;
+        if (result.subtype === "success") {
+          const s = result as SDKResultSuccess;
+          console.log("\nDone ($" + s.total_cost_usd.toFixed(4) + ")");
+          recordAction("outreach_cycle", prospect || "demo", "success", undefined, s.total_cost_usd, (s.usage?.input_tokens || 0) + (s.usage?.output_tokens || 0));
+
+          // Self-improvement: score this run
+          // Simple heuristic: if draft was created, score 8. If blocked, score 3.
+          const score = resultText.includes("Draft") ? 8 : resultText.includes("BLOCKED") ? 3 : 6;
+          recordOutcome("outreach", score);
+
+          if (shouldOptimize("outreach")) {
+            log("info", "self_improve.trigger", { reason: "30 runs completed" });
+            // TODO: Run curator to optimize prompt
+          }
+        }
+      }
+    }
+  } catch (err: unknown) {
+    const msg = err instanceof Error ? err.message : String(err);
+    log("error", "agent.error", { error: msg });
+    console.error("Error: " + msg);
+    recordAction("outreach_cycle", prospect || "demo", "error", msg);
+  }
+
+  // Self-update runs AFTER task — never before (prevents housekeeping-only sessions)
+  try { await runSelfUpdate(); } catch { /* non-critical */ }
+}
+
+main();