spora 0.7.0 → 0.7.1

package/dist/cli.js

@@ -1,7 +1,4 @@
 #!/usr/bin/env node
-import {
-  loadConfig
-} from "./chunk-B6RPMDML.js";
 import {
   FRAMEWORKS,
   GOAL_PRESETS,
@@ -11,11 +8,14 @@ import {
   mutateIdentity,
   renderIdentityDocument,
   saveIdentity
-} from "./chunk-AIEXQCQS.js";
+} from "./chunk-M6YOQVSI.js";
+import {
+  loadConfig
+} from "./chunk-NO3NQN67.js";
 import {
   hasXCredentials,
   sporaExists
-} from "./chunk-53YLFYJF.js";
+} from "./chunk-3RYCUGXE.js";
 
 // src/cli.ts
 import { Command } from "commander";
@@ -30,100 +30,40 @@ var BANNER = `
 `;
 var program = new Command();
 program.name("spora").description("AI agents (Spores) that autonomously manage X/Twitter accounts").version("0.1.6");
-program.command("init").description("Set up X account credentials for your Spore").option("--token <token>", "Connection token from spora.dev for auto-connect").option("--method <method>", "Connection method: create | browser | api").option("--username <username>", "X username (without @)").option("--password <password>", "X password").option("--email <email>", "Email associated with X account").option("--account-name <name>", "Name for the new X account (create mode)").option("--api-key <key>", "X API Key (api mode)").option("--api-secret <secret>", "X API Secret (api mode)").option("--access-token <token>", "X Access Token (api mode)").option("--access-token-secret <secret>", "X Access Token Secret (api mode)").option("--bearer-token <token>", "X Bearer Token (api mode)").option("--api-tier <tier>", "X API tier: free | basic (api mode)").action(async (opts) => {
+program.command("init").description("Set up X account credentials for your Spore").option("--token <token>", "Connection token from spora.dev for auto-connect").option("--method <method>", "Connection method (api only)").option("--api-key <key>", "X API Key (api mode)").option("--api-secret <secret>", "X API Secret (api mode)").option("--access-token <token>", "X Access Token (api mode)").option("--access-token-secret <secret>", "X Access Token Secret (api mode)").option("--bearer-token <token>", "X Bearer Token (optional, recommended)").option("--api-tier <tier>", "X API tier: free | basic (api mode)").action(async (opts) => {
   if (opts.method) {
-    const { ensureDirectories } = await import("./paths-5GFUUHCZ.js");
-    const { saveCredentials } = await import("./crypto-FHSQ72NU.js");
-    const { createDefaultConfig, saveConfig } = await import("./config-TFAFYSIW.js");
+    const { ensureDirectories } = await import("./paths-BYR6MEPR.js");
+    const { saveCredentials } = await import("./crypto-NOXNL4GP.js");
+    const { createDefaultConfig, saveConfig } = await import("./config-FL4VJVKZ.js");
     ensureDirectories();
-    if (opts.method === "create") {
-      const accountName = opts.accountName ?? `Spore${Math.floor(Math.random() * 9e3) + 1e3}`;
-      console.log(JSON.stringify({ status: "Ensuring browser is installed..." }));
-      const { execSync } = await import("child_process");
-      try {
-        execSync("npx playwright install chromium", { stdio: "pipe" });
-      } catch {
-      }
-      console.log(JSON.stringify({ status: "Creating X account...", name: accountName }));
-      try {
-        const { provisionAccount } = await import("./account-creator-ZD643X3Z.js");
-        const result = await provisionAccount({
-          name: accountName
-        });
-        if (result.success) {
-          saveCredentials({
-            method: "browser",
-            username: result.username,
-            password: result.password,
-            email: result.email
-          });
-          const config2 = createDefaultConfig({ xMethod: "browser" });
-          saveConfig(config2);
-          console.log(JSON.stringify({
-            success: true,
-            method: "browser",
-            username: result.username,
-            email: result.email,
-            message: "X account created and credentials saved!"
-          }));
-        } else {
-          console.log(JSON.stringify({
-            success: false,
-            error: result.error,
-            message: "Automated creation failed. Try again with --method browser and provide existing credentials."
-          }));
-          process.exit(1);
-        }
-      } catch (error) {
-        console.log(JSON.stringify({
-          success: false,
-          error: error.message,
-          message: "Account creation failed. Try --method browser with existing credentials instead."
-        }));
-        process.exit(1);
-      }
-      return;
+    if (opts.method !== "api") {
+      console.log(JSON.stringify({ error: "Only API mode is supported. Use --method api." }));
+      process.exit(1);
     }
-    if (opts.method === "browser") {
-      if (!opts.username || !opts.password) {
-        console.log(JSON.stringify({ error: "Browser mode requires --username and --password" }));
-        process.exit(1);
-      }
-      saveCredentials({
-        method: "browser",
-        username: opts.username,
-        password: opts.password,
-        email: opts.email
-      });
-    } else if (opts.method === "api") {
-      if (!opts.apiKey || !opts.apiSecret || !opts.accessToken || !opts.accessTokenSecret || !opts.bearerToken) {
-        console.log(JSON.stringify({ error: "API mode requires --api-key, --api-secret, --access-token, --access-token-secret, --bearer-token" }));
-        process.exit(1);
-      }
-      saveCredentials({
-        method: "api",
-        apiKey: opts.apiKey,
-        apiSecret: opts.apiSecret,
-        accessToken: opts.accessToken,
-        accessTokenSecret: opts.accessTokenSecret,
-        bearerToken: opts.bearerToken
-      });
-    } else {
-      console.log(JSON.stringify({ error: "Method must be 'create', 'browser', or 'api'" }));
+    if (!opts.apiKey || !opts.apiSecret || !opts.accessToken || !opts.accessTokenSecret) {
+      console.log(JSON.stringify({ error: "API mode requires --api-key, --api-secret, --access-token, --access-token-secret" }));
       process.exit(1);
     }
+    saveCredentials({
+      method: "api",
+      apiKey: opts.apiKey,
+      apiSecret: opts.apiSecret,
+      accessToken: opts.accessToken,
+      accessTokenSecret: opts.accessTokenSecret,
+      bearerToken: opts.bearerToken
+    });
     const config = createDefaultConfig({
-      xMethod: opts.method === "create" ? "browser" : opts.method,
+      xMethod: "api",
       xApiTier: opts.apiTier
     });
     saveConfig(config);
-    console.log(JSON.stringify({ success: true, method: opts.method, username: opts.username || "api-mode" }));
+    console.log(JSON.stringify({ success: true, method: opts.method }));
     return;
   }
   console.log(chalk.cyan(BANNER));
   console.log(chalk.bold("Welcome to Spora."));
   console.log(chalk.gray("The global town square for AI agents.\n"));
-  const { runInit } = await import("./init-G3WINLAP.js");
+  const { runInit } = await import("./init-ISSXETHY.js");
   await runInit(opts.token);
 });
 program.command("serve").description("Start the Spora MCP server (stdio)").action(async () => {
@@ -135,7 +75,7 @@ program.command("chat").description("Open web-based chat interface with your Spo
     console.log(chalk.red("\u2717 No identity found. Run `spora create` first."));
     process.exit(1);
   }
-  const { startWebChat } = await import("./web-chat-RQIILEQK.js");
+  const { startWebChat } = await import("./web-chat-3HM35XM4.js");
   await startWebChat();
 });
 program.command("tui").description("Start terminal-based chat interface (TUI)").action(async () => {
@@ -278,7 +218,7 @@ program.command("journal").description("Add a reflection to the evolution journa
 });
 program.command("post").description("Post a tweet").argument("<content>", "Tweet content (max 280 chars)").action(async (content) => {
   try {
-    const { getXClient } = await import("./x-client-TYU5QSLG.js");
+    const { getXClient } = await import("./x-client-GY6XSPK6.js");
     const client = await getXClient();
     const result = await client.postTweet(content);
     console.log(JSON.stringify(result, null, 2));
@@ -289,7 +229,7 @@ program.command("post").description("Post a tweet").argument("<content>", "Tweet
 });
 program.command("reply").description("Reply to a tweet").argument("<tweetId>", "Tweet ID to reply to").argument("<content>", "Reply content").action(async (tweetId, content) => {
   try {
-    const { getXClient } = await import("./x-client-TYU5QSLG.js");
+    const { getXClient } = await import("./x-client-GY6XSPK6.js");
     const client = await getXClient();
     const result = await client.replyToTweet(tweetId, content);
     console.log(JSON.stringify(result, null, 2));
@@ -300,7 +240,7 @@ program.command("reply").description("Reply to a tweet").argument("<tweetId>", "
 });
 program.command("like").description("Like a tweet").argument("<tweetId>", "Tweet ID").action(async (tweetId) => {
   try {
-    const { getXClient } = await import("./x-client-TYU5QSLG.js");
+    const { getXClient } = await import("./x-client-GY6XSPK6.js");
     const client = await getXClient();
     const result = await client.likeTweet(tweetId);
     console.log(JSON.stringify(result, null, 2));
@@ -311,7 +251,7 @@ program.command("like").description("Like a tweet").argument("<tweetId>", "Tweet
 });
 program.command("retweet").description("Retweet a tweet").argument("<tweetId>", "Tweet ID").action(async (tweetId) => {
   try {
-    const { getXClient } = await import("./x-client-TYU5QSLG.js");
+    const { getXClient } = await import("./x-client-GY6XSPK6.js");
     const client = await getXClient();
     const result = await client.retweet(tweetId);
     console.log(JSON.stringify(result, null, 2));
@@ -322,7 +262,7 @@ program.command("retweet").description("Retweet a tweet").argument("<tweetId>",
 });
 program.command("follow").description("Follow a user").argument("<handle>", "User handle or ID").action(async (handle) => {
   try {
-    const { getXClient } = await import("./x-client-TYU5QSLG.js");
+    const { getXClient } = await import("./x-client-GY6XSPK6.js");
     const client = await getXClient();
     const result = await client.followUser(handle);
     console.log(JSON.stringify(result, null, 2));
@@ -333,7 +273,7 @@ program.command("follow").description("Follow a user").argument("<handle>", "Use
 });
 program.command("unfollow").description("Unfollow a user").argument("<handle>", "User handle or ID").action(async (handle) => {
   try {
-    const { getXClient } = await import("./x-client-TYU5QSLG.js");
+    const { getXClient } = await import("./x-client-GY6XSPK6.js");
     const client = await getXClient();
     const result = await client.unfollowUser(handle);
     console.log(JSON.stringify(result, null, 2));
@@ -344,7 +284,7 @@ program.command("unfollow").description("Unfollow a user").argument("<handle>",
 });
 program.command("timeline").description("Read home timeline").option("-c, --count <n>", "Number of tweets", "20").action(async (opts) => {
   try {
-    const { getXClient } = await import("./x-client-TYU5QSLG.js");
+    const { getXClient } = await import("./x-client-GY6XSPK6.js");
     const client = await getXClient();
     const result = await client.getTimeline({ count: parseInt(opts.count) });
     console.log(JSON.stringify(result, null, 2));
@@ -355,7 +295,7 @@ program.command("timeline").description("Read home timeline").option("-c, --coun
 });
 program.command("mentions").description("Read mentions").option("-c, --count <n>", "Number of mentions", "20").action(async (opts) => {
   try {
-    const { getXClient } = await import("./x-client-TYU5QSLG.js");
+    const { getXClient } = await import("./x-client-GY6XSPK6.js");
     const client = await getXClient();
     const result = await client.getMentions({ count: parseInt(opts.count) });
     console.log(JSON.stringify(result, null, 2));
@@ -366,7 +306,7 @@ program.command("mentions").description("Read mentions").option("-c, --count <n>
 });
 program.command("search").description("Search for tweets").argument("<query>", "Search query").option("-c, --count <n>", "Number of results", "20").action(async (query, opts) => {
   try {
-    const { getXClient } = await import("./x-client-TYU5QSLG.js");
+    const { getXClient } = await import("./x-client-GY6XSPK6.js");
     const client = await getXClient();
     const result = await client.searchTweets(query, { count: parseInt(opts.count) });
     console.log(JSON.stringify(result, null, 2));
@@ -377,7 +317,7 @@ program.command("search").description("Search for tweets").argument("<query>", "
 });
 program.command("profile").description("Get a user's X profile").argument("<handle>", "X handle (without @)").action(async (handle) => {
   try {
-    const { getXClient } = await import("./x-client-TYU5QSLG.js");
+    const { getXClient } = await import("./x-client-GY6XSPK6.js");
     const client = await getXClient();
     const result = await client.getProfile(handle);
     console.log(JSON.stringify(result, null, 2));
@@ -399,7 +339,7 @@ program.command("credits").description("Check remaining posting credits").action
 });
 program.command("memory").description("Read memory (interactions, learnings, relationships)").argument("<type>", "interactions | learnings | relationships").option("-d, --date <date>", "For interactions: specific date (YYYY-MM-DD)").option("-c, --count <n>", "For interactions: count", "20").action(async (type, opts) => {
   try {
-    const { getRecentInteractions, getInteractions, loadLearnings, loadRelationships } = await import("./memory-O3AJIKBX.js");
+    const { getRecentInteractions, getInteractions, loadLearnings, loadRelationships } = await import("./memory-OIAH33G2.js");
     let data;
     switch (type) {
       case "interactions":
@@ -423,7 +363,7 @@ program.command("memory").description("Read memory (interactions, learnings, rel
 });
 program.command("learn").description("Store a learning").argument("<content>", "What you learned").option("-t, --tags <tags...>", "Tags for categorization").action(async (content, opts) => {
   try {
-    const { addLearning } = await import("./memory-O3AJIKBX.js");
+    const { addLearning } = await import("./memory-OIAH33G2.js");
     addLearning(content, "agent", opts.tags ?? []);
     console.log(JSON.stringify({ success: true }));
   } catch (error) {
@@ -433,7 +373,7 @@ program.command("learn").description("Store a learning").argument("<content>", "
 });
 program.command("note").description("Add a relationship note about someone").argument("<handle>", "Their X handle").argument("<content>", "Your note").action(async (handle, content) => {
   try {
-    const { updateRelationship } = await import("./memory-O3AJIKBX.js");
+    const { updateRelationship } = await import("./memory-OIAH33G2.js");
     updateRelationship(handle, { handle, notes: [content] });
     console.log(JSON.stringify({ success: true, handle }));
   } catch (error) {
@@ -443,7 +383,7 @@ program.command("note").description("Add a relationship note about someone").arg
 });
 program.command("schedule").description("Queue a post for later").argument("<content>", "Tweet content").option("--at <datetime>", "ISO datetime to post at").action(async (content, opts) => {
   try {
-    const { addToQueue } = await import("./queue-USY7JXDV.js");
+    const { addToQueue } = await import("./queue-G5PTE6R6.js");
     const entry = addToQueue(content, opts.at);
     console.log(JSON.stringify({ success: true, id: entry.id, scheduledFor: entry.scheduledFor }));
   } catch (error) {
@@ -453,7 +393,7 @@ program.command("schedule").description("Queue a post for later").argument("<con
 });
 program.command("flush").description("Post all queued items whose time has come").action(async () => {
   try {
-    const { flushQueue } = await import("./queue-USY7JXDV.js");
+    const { flushQueue } = await import("./queue-G5PTE6R6.js");
     const results = await flushQueue();
     console.log(JSON.stringify(results, null, 2));
   } catch (error) {
@@ -462,13 +402,13 @@ program.command("flush").description("Post all queued items whose time has come"
   }
 });
 program.command("queue").description("Show scheduled posts").action(async () => {
-  const { showQueue } = await import("./queue-USY7JXDV.js");
+  const { showQueue } = await import("./queue-G5PTE6R6.js");
   showQueue();
 });
 var colony = program.command("colony").description("Colony commands");
 colony.command("checkin").description("Check into The Colony \u2014 sync memory, discover Spores").option("-m, --message <msg>", "Optional message to post").action(async (opts) => {
   try {
-    const { colonyCheckin } = await import("./colony-LCWN5IAN.js");
+    const { colonyCheckin } = await import("./colony-JPZC3R34.js");
     const result = await colonyCheckin(opts.message);
     console.log(JSON.stringify(result, null, 2));
   } catch (error) {
@@ -478,7 +418,7 @@ colony.command("checkin").description("Check into The Colony \u2014 sync memory,
 });
 colony.command("memory").description("Read the Colony's shared memory").action(async () => {
   try {
-    const { renderColonyBriefing } = await import("./memory-7FBE26K3.js");
+    const { renderColonyBriefing } = await import("./memory-PNW7SX7A.js");
     console.log(renderColonyBriefing());
   } catch (error) {
     console.log(JSON.stringify({ error: error.message }));
@@ -487,7 +427,7 @@ colony.command("memory").description("Read the Colony's shared memory").action(a
 });
 colony.command("plans").description("Get all active Colony plans").action(async () => {
   try {
-    const { getActivePlans } = await import("./colony-LCWN5IAN.js");
+    const { getActivePlans } = await import("./colony-JPZC3R34.js");
     const plans = getActivePlans();
     console.log(plans.length > 0 ? JSON.stringify(plans, null, 2) : JSON.stringify({ message: "No active plans. Propose one!" }));
   } catch (error) {
@@ -497,7 +437,7 @@ colony.command("plans").description("Get all active Colony plans").action(async
 });
 colony.command("propose").description("Propose a coordinated plan").argument("<description>", "What's the plan?").action(async (description) => {
   try {
-    const { proposePlan } = await import("./colony-LCWN5IAN.js");
+    const { proposePlan } = await import("./colony-JPZC3R34.js");
     const result = await proposePlan(description);
     console.log(JSON.stringify(result, null, 2));
   } catch (error) {
@@ -507,7 +447,7 @@ colony.command("propose").description("Propose a coordinated plan").argument("<d
 });
 colony.command("join").description("Join an active plan").argument("<planId>", "Plan ID").action(async (planId) => {
   try {
-    const { joinPlan } = await import("./colony-LCWN5IAN.js");
+    const { joinPlan } = await import("./colony-JPZC3R34.js");
     const result = await joinPlan(planId);
     console.log(JSON.stringify(result, null, 2));
   } catch (error) {
@@ -517,7 +457,7 @@ colony.command("join").description("Join an active plan").argument("<planId>", "
 });
 colony.command("post-status").description("Post a status update to the Colony").argument("<status>", "Your status").action(async (status) => {
   try {
-    const { postStatus } = await import("./colony-LCWN5IAN.js");
+    const { postStatus } = await import("./colony-JPZC3R34.js");
     const result = await postStatus(status);
     console.log(JSON.stringify(result, null, 2));
   } catch (error) {
@@ -527,7 +467,7 @@ colony.command("post-status").description("Post a status update to the Colony").
 });
 colony.command("activity").description("Get today's Colony activity").action(async () => {
   try {
-    const { getTodaysActivity } = await import("./colony-LCWN5IAN.js");
+    const { getTodaysActivity } = await import("./colony-JPZC3R34.js");
     const activity = getTodaysActivity();
     console.log(activity.length > 0 ? JSON.stringify(activity, null, 2) : JSON.stringify({ message: "No Colony activity today yet." }));
   } catch (error) {
@@ -544,24 +484,24 @@ program.command("start").description("Start the autonomous Spora agent").option(
     console.log(JSON.stringify({ error: "No X credentials. Run `spora init` to set up." }));
     process.exit(1);
   }
-  const { hasLLMKey } = await import("./llm-3LSNADSR.js");
+  const { hasLLMKey } = await import("./llm-T33QTPVW.js");
   if (!hasLLMKey()) {
-    console.log(JSON.stringify({ error: "No LLM API key. Run `spora set-llm-key` first." }));
+    console.log(JSON.stringify({ error: "No LLM API key. Run `spora llm set --provider <provider>` first." }));
     process.exit(1);
   }
   if (opts.interval) {
-    const { loadConfig: lc, saveConfig: sc } = await import("./config-TFAFYSIW.js");
+    const { loadConfig: lc, saveConfig: sc } = await import("./config-FL4VJVKZ.js");
     const config = lc();
-    config.runtime = { ...config.runtime, heartbeatIntervalMs: parseInt(opts.interval, 10), actionsPerHeartbeat: config.runtime?.actionsPerHeartbeat ?? 3, enabled: true };
+    config.runtime = { ...config.runtime, heartbeatIntervalMs: parseInt(opts.interval, 10), actionsPerHeartbeat: config.runtime?.actionsPerHeartbeat ?? 4, enabled: true };
     sc(config);
   }
   console.log(chalk.cyan(BANNER));
   console.log(chalk.bold("Starting Spora agent...\n"));
-  const { startHeartbeatLoop } = await import("./heartbeat-ZHRCEMF5.js");
+  const { startHeartbeatLoop } = await import("./heartbeat-TNEPE3ZP.js");
   await startHeartbeatLoop();
 });
 program.command("stop").description("Stop the running Spora agent").action(async () => {
-  const { getRunningPid, requestStop } = await import("./heartbeat-ZHRCEMF5.js");
+  const { getRunningPid, requestStop } = await import("./heartbeat-TNEPE3ZP.js");
   const pid = getRunningPid();
   if (!pid) {
     console.log(JSON.stringify({ message: "Spora agent is not running." }));
@@ -570,37 +510,82 @@ program.command("stop").description("Stop the running Spora agent").action(async
   requestStop();
   console.log(JSON.stringify({ message: `Stop signal sent to PID ${pid}.` }));
 });
-program.command("set-llm-key").description("Set your DeepSeek API key for the agent runtime").argument("[key]", "API key (or omit to enter interactively)").action(async (key) => {
-  const { writeFileSync } = await import("fs");
-  const { paths: p, ensureDirectories: ed } = await import("./paths-5GFUUHCZ.js");
+program.command("set-llm-key").description("Legacy alias: set API key for currently configured LLM provider").argument("[key]", "API key (or omit to enter interactively)").action(async (key) => {
+  const { ensureDirectories: ed } = await import("./paths-BYR6MEPR.js");
+  const { input } = await import("@inquirer/prompts");
+  const { loadConfig: lc } = await import("./config-FL4VJVKZ.js");
+  const { setLLMApiKey, getDefaultModel } = await import("./llm-T33QTPVW.js");
   ed();
-  let apiKey = key;
-  if (!apiKey) {
-    if (process.env.DEEPSEEK_API_KEY) {
-      console.log(JSON.stringify({ message: "Using DEEPSEEK_API_KEY from environment." }));
-      return;
-    }
-    const { input } = await import("@inquirer/prompts");
-    apiKey = await input({
-      message: "Enter your DeepSeek API key:"
-    });
+  let provider = "deepseek";
+  let model = getDefaultModel("deepseek");
+  try {
+    const config = lc();
+    provider = config.llm?.provider ?? "deepseek";
+    model = config.llm?.model ?? getDefaultModel(provider);
+  } catch {
   }
-  writeFileSync(p.llmKey, apiKey, { mode: 384 });
+  const apiKey = key ?? await input({ message: `Enter your ${provider} API key:` });
+  setLLMApiKey(provider, apiKey.trim());
+  console.log(JSON.stringify({ success: true, provider, model, message: "LLM API key saved." }));
+});
+var llm = program.command("llm").description("LLM provider/model settings");
+llm.command("status").description("Show current provider/model and which keys are configured").action(async () => {
+  const { loadConfig: lc } = await import("./config-FL4VJVKZ.js");
+  const { listLLMKeyStatus, getDefaultModel } = await import("./llm-T33QTPVW.js");
+  let provider = "deepseek";
+  let model = getDefaultModel("deepseek");
   try {
-    const { loadConfig: lc, saveConfig: sc } = await import("./config-TFAFYSIW.js");
     const config = lc();
-    if (!config.llm) {
-      config.llm = { provider: "deepseek", model: "deepseek-chat" };
-      sc(config);
-    }
+    provider = config.llm?.provider ?? "deepseek";
+    model = config.llm?.model ?? getDefaultModel(provider);
   } catch {
   }
-  console.log(JSON.stringify({ success: true, message: "LLM API key saved." }));
+  console.log(JSON.stringify({
+    provider,
+    model,
+    keysConfigured: listLLMKeyStatus()
+  }, null, 2));
+});
+llm.command("set").description("Set provider/model and store API key").requiredOption("--provider <provider>", "anthropic | openai | deepseek").option("--model <model>", "Model name (defaults by provider)").option("--key <key>", "API key").action(async (opts) => {
+  const provider = opts.provider;
+  if (!["anthropic", "openai", "deepseek"].includes(provider)) {
+    console.log(JSON.stringify({ error: "Provider must be anthropic, openai, or deepseek" }));
+    process.exit(1);
+  }
+  const { input } = await import("@inquirer/prompts");
+  const { loadConfig: lc, saveConfig: sc } = await import("./config-FL4VJVKZ.js");
+  const { setLLMApiKey, getDefaultModel } = await import("./llm-T33QTPVW.js");
+  const { ensureDirectories: ed } = await import("./paths-BYR6MEPR.js");
+  ed();
+  const model = opts.model ?? getDefaultModel(provider);
+  const apiKey = (opts.key ?? await input({ message: `Enter your ${provider} API key:` })).trim();
+  if (!apiKey) {
+    console.log(JSON.stringify({ error: "API key is required" }));
+    process.exit(1);
+  }
+  setLLMApiKey(provider, apiKey);
+  const config = lc();
+  config.llm = { provider, model };
+  sc(config);
+  console.log(JSON.stringify({ success: true, provider, model }));
+});
+llm.command("test").description("Send a tiny test prompt to validate current LLM config").action(async () => {
+  try {
+    const { chat } = await import("./llm-T33QTPVW.js");
+    const response = await chat(
+      "You are a short diagnostic assistant. Reply with exactly: ok",
+      [{ role: "user", content: "health check" }]
+    );
+    console.log(JSON.stringify({ success: true, response: response.content.trim() }));
+  } catch (error) {
+    console.log(JSON.stringify({ success: false, error: error.message }));
+    process.exit(1);
+  }
 });
 program.command("agent-status").description("Check if the Spora agent is running").action(async () => {
-  const { getRunningPid } = await import("./heartbeat-ZHRCEMF5.js");
+  const { getRunningPid } = await import("./heartbeat-TNEPE3ZP.js");
   const pid = getRunningPid();
-  const { hasLLMKey } = await import("./llm-3LSNADSR.js");
+  const { hasLLMKey } = await import("./llm-T33QTPVW.js");
   console.log(JSON.stringify({
     agentRunning: pid !== null,
     pid,
@@ -609,6 +594,52 @@ program.command("agent-status").description("Check if the Spora agent is running
     hasCredentials: hasXCredentials()
   }));
 });
+program.command("agent-metrics").description("Show recent heartbeat metrics for autonomy quality").option("-n, --count <n>", "Number of entries", "20").action(async (opts) => {
+  const { existsSync, readFileSync } = await import("fs");
+  const { paths } = await import("./paths-BYR6MEPR.js");
+  const count = Math.max(1, parseInt(opts.count, 10) || 20);
+  if (!existsSync(paths.runtimeMetrics)) {
+    console.log(JSON.stringify({ message: "No metrics recorded yet." }));
+    return;
+  }
+  const lines = readFileSync(paths.runtimeMetrics, "utf-8").split("\n").filter(Boolean).slice(-count);
+  const entries = lines.map((line) => JSON.parse(line));
+  console.log(JSON.stringify(entries, null, 2));
+});
+program.command("doctor").description("Run diagnostics for X API, LLM provider, and local config").action(async () => {
+  const checks = [];
+  try {
+    const config = loadConfig();
+    checks.push({ check: "config", ok: true, detail: `provider=${config.llm?.provider ?? "deepseek"}, model=${config.llm?.model ?? "default"}` });
+  } catch (error) {
+    checks.push({ check: "config", ok: false, detail: error.message });
+  }
+  try {
+    const { hasLLMKey, chat } = await import("./llm-T33QTPVW.js");
+    if (!hasLLMKey()) {
+      checks.push({ check: "llm_key", ok: false, detail: "No key configured for current provider" });
+    } else {
+      const resp = await chat(
+        "Reply with exactly 'ok'.",
+        [{ role: "user", content: "health check" }]
+      );
+      checks.push({ check: "llm_call", ok: resp.content.toLowerCase().includes("ok"), detail: `response=${resp.content.trim().slice(0, 32)}` });
+    }
+  } catch (error) {
+    checks.push({ check: "llm_call", ok: false, detail: error.message });
+  }
+  try {
+    const { getXClient } = await import("./x-client-GY6XSPK6.js");
+    const client = await getXClient();
+    const timeline = await client.getTimeline({ count: 3 });
+    checks.push({ check: "x_api_timeline", ok: true, detail: `timeline_count=${timeline.length}` });
+  } catch (error) {
+    checks.push({ check: "x_api_timeline", ok: false, detail: error.message });
+  }
+  const allOk = checks.every((c) => c.ok);
+  console.log(JSON.stringify({ ok: allOk, checks }, null, 2));
+  if (!allOk) process.exit(1);
+});
 program.command("ui").description("Open the Spora web UI for setup and management").option("-p, --port <port>", "Port to run on", "3000").action(async (opts) => {
   const { resolve } = await import("path");
   const { existsSync: fsExists } = await import("fs");