@actant/cli 0.1.2 → 0.1.3

package/dist/{chunk-2FKBVXMH.js → chunk-I3QY66Y6.js}

@@ -1,6 +1,8 @@
 // src/program.ts
-import { Command as Command72 } from "commander";
-import { getDefaultIpcPath } from "@actant/shared";
+import { Command as Command73 } from "commander";
+import { readFileSync as readFileSync4 } from "fs";
+import { join as join7 } from "path";
+import { getDefaultIpcPath as getDefaultIpcPath2 } from "@actant/shared";
 
 // src/client/rpc-client.ts
 import { createConnection } from "net";
@@ -1235,7 +1237,7 @@ import chalk15 from "chalk";
 // package.json
 var package_default = {
   name: "@actant/cli",
-  version: "0.1.2",
+  version: "0.1.3",
   description: "CLI for the Actant AI agent platform \u2014 build, manage, and compose AI agents",
   type: "module",
   license: "MIT",
@@ -1247,11 +1249,19 @@ var package_default = {
   },
   homepage: "https://github.com/blackplume233/Actant#readme",
   bugs: "https://github.com/blackplume233/Actant/issues",
-  keywords: ["actant", "ai-agent", "cli", "agent-platform"],
+  keywords: [
+    "actant",
+    "ai-agent",
+    "cli",
+    "agent-platform"
+  ],
   publishConfig: {
     access: "public"
   },
-  files: ["dist", "scripts/postinstall.mjs"],
+  files: [
+    "dist",
+    "scripts/postinstall.mjs"
+  ],
   bin: {
     actant: "./dist/bin/actant.js"
   },
@@ -1269,6 +1279,7 @@ var package_default = {
     "@actant/api": "workspace:*",
     "@actant/core": "workspace:*",
     "@actant/shared": "workspace:*",
+    "@inquirer/prompts": "^8.3.0",
     chalk: "^5.6.2",
     "cli-table3": "^0.6.5",
     commander: "^14.0.3"
@@ -2597,14 +2608,790 @@ function showVersionCheck(sourcePath, actantHome) {
   }
 }
 
+// src/commands/setup/setup.ts
+import { Command as Command72 } from "commander";
+import chalk27 from "chalk";
+import { getDefaultIpcPath } from "@actant/shared";
+
+// src/commands/setup/steps/choose-home.ts
+import { join as join3 } from "path";
+import { homedir as homedir2 } from "os";
+import { mkdirSync as mkdirSync2, existsSync as existsSync3, writeFileSync as writeFileSync2 } from "fs";
+import { select, input } from "@inquirer/prompts";
+import chalk20 from "chalk";
+var DEFAULT_HOME = join3(homedir2(), ".actant");
+var SUBDIRS = [
+  "configs/skills",
+  "configs/prompts",
+  "configs/mcp",
+  "configs/workflows",
+  "configs/plugins",
+  "configs/templates",
+  "instances",
+  "sources/cache",
+  "logs",
+  "backups"
+];
+async function chooseHome(printer) {
+  printer.log(`
+${chalk20.cyan("[ Step 1/7 ]")} ${chalk20.bold("\u9009\u62E9\u5DE5\u4F5C\u76EE\u5F55")}
+`);
+  const choice = await select({
+    message: "Actant \u5DE5\u4F5C\u76EE\u5F55 (ACTANT_HOME):",
+    choices: [
+      { name: `\u4F7F\u7528\u9ED8\u8BA4 ${DEFAULT_HOME}`, value: "default" },
+      { name: "\u81EA\u5B9A\u4E49\u8DEF\u5F84...", value: "custom" }
+    ]
+  });
+  let actantHome = DEFAULT_HOME;
+  if (choice === "custom") {
+    actantHome = await input({
+      message: "\u8BF7\u8F93\u5165\u5DE5\u4F5C\u76EE\u5F55\u8DEF\u5F84:",
+      validate: (val) => val.trim().length > 0 || "\u8DEF\u5F84\u4E0D\u80FD\u4E3A\u7A7A"
+    });
+    actantHome = actantHome.trim();
+  }
+  ensureDirectoryStructure(actantHome);
+  const configFile = join3(actantHome, "config.json");
+  if (!existsSync3(configFile)) {
+    writeFileSync2(
+      configFile,
+      JSON.stringify(
+        {
+          devSourcePath: "",
+          update: {
+            maxBackups: 3,
+            preUpdateTestCommand: "pnpm test:changed",
+            autoRestartAgents: true
+          }
+        },
+        null,
+        2
+      ) + "\n"
+    );
+  }
+  printer.success(`\u2713 \u5DE5\u4F5C\u76EE\u5F55: ${actantHome}`);
+  if (actantHome !== DEFAULT_HOME) {
+    printer.warn(
+      `  \u8BF7\u5C06\u4EE5\u4E0B\u5185\u5BB9\u6DFB\u52A0\u5230\u4F60\u7684 shell \u914D\u7F6E\u6587\u4EF6 (~/.bashrc, ~/.zshrc, \u6216 $PROFILE):
+  ${chalk20.cyan(`export ACTANT_HOME="${actantHome}"`)}`
+    );
+  }
+  return actantHome;
+}
+function ensureDirectoryStructure(base) {
+  for (const dir of SUBDIRS) {
+    mkdirSync2(join3(base, dir), { recursive: true });
+  }
+}
+
+// src/commands/setup/steps/configure-provider.ts
+import { join as join4 } from "path";
+import { readFileSync as readFileSync2, writeFileSync as writeFileSync3 } from "fs";
+import { select as select2, input as input2, password, confirm } from "@inquirer/prompts";
+import chalk21 from "chalk";
+var PROVIDER_DEFAULTS = {
+  anthropic: { protocol: "http", baseUrl: "https://api.anthropic.com", apiKeyEnv: "ANTHROPIC_API_KEY" },
+  openai: { protocol: "http", baseUrl: "https://api.openai.com/v1", apiKeyEnv: "OPENAI_API_KEY" },
+  "openai-compatible": { protocol: "http", baseUrl: "http://localhost:11434/v1", apiKeyEnv: "LLM_API_KEY" },
+  custom: { protocol: "http", baseUrl: "http://localhost:8080", apiKeyEnv: "LLM_API_KEY" }
+};
+async function configureProvider(printer, actantHome) {
+  printer.log(`
+${chalk21.cyan("[ Step 2/7 ]")} ${chalk21.bold("\u914D\u7F6E Model Provider")}
+`);
+  const providerType = await select2({
+    message: "\u9009\u62E9 Model Provider:",
+    default: "anthropic",
+    choices: [
+      { name: "Anthropic (Claude)", value: "anthropic" },
+      { name: "OpenAI", value: "openai" },
+      { name: "OpenAI-Compatible (vLLM / Ollama / LM Studio \u7B49)", value: "openai-compatible" },
+      { name: "Custom", value: "custom" }
+    ]
+  });
+  const fallback = {
+    protocol: "http",
+    baseUrl: "",
+    apiKeyEnv: "LLM_API_KEY"
+  };
+  const defaults = PROVIDER_DEFAULTS[providerType] ?? fallback;
+  const protocol = await select2({
+    message: "\u534F\u8BAE\u7C7B\u578B:",
+    choices: [
+      { name: "HTTP / REST", value: "http" },
+      { name: "WebSocket", value: "websocket" },
+      { name: "gRPC", value: "grpc" }
+    ],
+    default: defaults.protocol
+  });
+  const baseUrl = await input2({
+    message: "Base URL:",
+    default: defaults.baseUrl,
+    validate: (val) => {
+      try {
+        new URL(val);
+        return true;
+      } catch {
+        return "\u8BF7\u8F93\u5165\u6709\u6548\u7684 URL";
+      }
+    }
+  });
+  const apiKeyEnvName = await input2({
+    message: "API Key \u73AF\u5883\u53D8\u91CF\u540D:",
+    default: defaults.apiKeyEnv
+  });
+  const apiKey = await password({
+    message: `${apiKeyEnvName} \u7684\u503C (API Key):`,
+    mask: "*"
+  });
+  if (apiKey) {
+    const shouldValidate = await confirm({
+      message: "\u9A8C\u8BC1\u8FDE\u63A5?",
+      default: true
+    });
+    if (shouldValidate) {
+      printer.log(chalk21.dim("  \u6B63\u5728\u9A8C\u8BC1\u8FDE\u63A5..."));
+      const ok = await validateConnection(providerType, protocol, baseUrl, apiKey);
+      if (ok) {
+        printer.success("  \u2713 \u8FDE\u63A5\u9A8C\u8BC1\u6210\u529F");
+      } else {
+        printer.warn("  \u26A0 \u8FDE\u63A5\u9A8C\u8BC1\u5931\u8D25\uFF0C\u914D\u7F6E\u5DF2\u4FDD\u5B58\u4F46\u53EF\u80FD\u9700\u8981\u68C0\u67E5");
+      }
+    }
+    printer.warn(
+      `  \u8BF7\u786E\u4FDD\u73AF\u5883\u53D8\u91CF ${chalk21.cyan(apiKeyEnvName)} \u5DF2\u8BBE\u7F6E:
+  ${chalk21.dim(`export ${apiKeyEnvName}="${apiKey.slice(0, 8)}..."`)}`
+    );
+  }
+  const providerConfig = {
+    type: providerType,
+    protocol,
+    baseUrl,
+    apiKeyEnv: apiKeyEnvName
+  };
+  saveProviderConfig(actantHome, providerConfig);
+  printer.success(`\u2713 Model Provider \u5DF2\u914D\u7F6E: ${providerType} (${protocol}) \u2192 ${baseUrl}`);
+}
+function saveProviderConfig(actantHome, provider) {
+  const configFile = join4(actantHome, "config.json");
+  let config = {};
+  try {
+    config = JSON.parse(readFileSync2(configFile, "utf-8"));
+  } catch {
+  }
+  config.provider = provider;
+  writeFileSync3(configFile, JSON.stringify(config, null, 2) + "\n");
+}
+async function validateConnection(type, _protocol, baseUrl, apiKey) {
+  try {
+    if (type === "anthropic") {
+      const res2 = await fetch(`${baseUrl}/v1/messages`, {
+        method: "POST",
+        headers: {
+          "x-api-key": apiKey,
+          "anthropic-version": "2023-06-01",
+          "content-type": "application/json"
+        },
+        body: JSON.stringify({
+          model: "claude-sonnet-4-20250514",
+          max_tokens: 1,
+          messages: [{ role: "user", content: "hi" }]
+        }),
+        signal: AbortSignal.timeout(15e3)
+      });
+      return res2.status === 200 || res2.status === 400;
+    }
+    if (type === "openai" || type === "openai-compatible") {
+      const res2 = await fetch(`${baseUrl}/models`, {
+        headers: { Authorization: `Bearer ${apiKey}` },
+        signal: AbortSignal.timeout(1e4)
+      });
+      return res2.ok;
+    }
+    const res = await fetch(baseUrl, {
+      headers: { Authorization: `Bearer ${apiKey}` },
+      signal: AbortSignal.timeout(1e4)
+    });
+    return res.ok;
+  } catch {
+    return false;
+  }
+}
+
+// src/commands/setup/steps/configure-source.ts
+import { confirm as confirm2, input as input3, select as select3 } from "@inquirer/prompts";
+import chalk22 from "chalk";
+var DEFAULT_SOURCE_NAME = "actant-hub";
+var DEFAULT_SOURCE_URL = "https://github.com/blackplume233/actant-hub.git";
+async function configureSource(printer, client) {
+  printer.log(`
+${chalk22.cyan("[ Step 3/7 ]")} ${chalk22.bold("\u914D\u7F6E\u7EC4\u4EF6\u6E90 (Source)")}
+`);
+  const addDefault = await confirm2({
+    message: `\u6DFB\u52A0\u5B98\u65B9\u7EC4\u4EF6\u6E90 ${DEFAULT_SOURCE_NAME}?`,
+    default: true
+  });
+  if (addDefault) {
+    try {
+      printer.log(chalk22.dim(`  \u6B63\u5728\u6CE8\u518C ${DEFAULT_SOURCE_NAME}...`));
+      const result = await client.call("source.add", {
+        name: DEFAULT_SOURCE_NAME,
+        config: { type: "github", url: DEFAULT_SOURCE_URL, branch: "main" }
+      });
+      const c = result.components;
+      printer.success(
+        `  \u2713 ${DEFAULT_SOURCE_NAME} \u5DF2\u6DFB\u52A0: ${c.skills} skills, ${c.prompts} prompts, ${c.mcp} mcp, ${c.workflows} workflows, ${c.presets} presets`
+      );
+    } catch (err) {
+      const message = err instanceof Error ? err.message : String(err);
+      if (message.includes("already exists") || message.includes("already registered")) {
+        printer.dim(`  ${DEFAULT_SOURCE_NAME} \u5DF2\u5B58\u5728\uFF0C\u8DF3\u8FC7`);
+      } else {
+        printer.warn(`  \u26A0 \u6DFB\u52A0 ${DEFAULT_SOURCE_NAME} \u5931\u8D25: ${message}`);
+        printer.dim("  \u4F60\u53EF\u4EE5\u7A0D\u540E\u624B\u52A8\u8FD0\u884C: actant source add --name actant-hub <url>");
+      }
+    }
+  }
+  let addMore = await confirm2({
+    message: "\u6DFB\u52A0\u5176\u4ED6 Source?",
+    default: false
+  });
+  while (addMore) {
+    const sourceType = await select3({
+      message: "Source \u7C7B\u578B:",
+      choices: [
+        { name: "GitHub \u4ED3\u5E93", value: "github" },
+        { name: "\u672C\u5730\u76EE\u5F55", value: "local" }
+      ]
+    });
+    const name = await input3({
+      message: "Source \u540D\u79F0 (\u547D\u540D\u7A7A\u95F4\u524D\u7F00):",
+      validate: (val) => val.trim().length > 0 || "\u540D\u79F0\u4E0D\u80FD\u4E3A\u7A7A"
+    });
+    if (sourceType === "github") {
+      const url = await input3({
+        message: "GitHub \u4ED3\u5E93 URL:",
+        validate: (val) => val.trim().length > 0 || "URL \u4E0D\u80FD\u4E3A\u7A7A"
+      });
+      const branch = await input3({
+        message: "\u5206\u652F:",
+        default: "main"
+      });
+      try {
+        const result = await client.call("source.add", {
+          name: name.trim(),
+          config: { type: "github", url: url.trim(), branch }
+        });
+        const c = result.components;
+        printer.success(
+          `  \u2713 ${name.trim()} \u5DF2\u6DFB\u52A0: ${c.skills} skills, ${c.prompts} prompts`
+        );
+      } catch (err) {
+        printer.warn(`  \u26A0 \u6DFB\u52A0\u5931\u8D25: ${err instanceof Error ? err.message : String(err)}`);
+      }
+    } else {
+      const path = await input3({
+        message: "\u672C\u5730\u76EE\u5F55\u8DEF\u5F84:",
+        validate: (val) => val.trim().length > 0 || "\u8DEF\u5F84\u4E0D\u80FD\u4E3A\u7A7A"
+      });
+      try {
+        const result = await client.call("source.add", {
+          name: name.trim(),
+          config: { type: "local", path: path.trim() }
+        });
+        const c = result.components;
+        printer.success(
+          `  \u2713 ${name.trim()} \u5DF2\u6DFB\u52A0: ${c.skills} skills, ${c.prompts} prompts`
+        );
+      } catch (err) {
+        printer.warn(`  \u26A0 \u6DFB\u52A0\u5931\u8D25: ${err instanceof Error ? err.message : String(err)}`);
+      }
+    }
+    addMore = await confirm2({
+      message: "\u7EE7\u7EED\u6DFB\u52A0\u5176\u4ED6 Source?",
+      default: false
+    });
+  }
+  printer.success("\u2713 \u7EC4\u4EF6\u6E90\u914D\u7F6E\u5B8C\u6210");
+}
+
+// src/commands/setup/steps/materialize-agent.ts
+import { checkbox, input as input4 } from "@inquirer/prompts";
+import chalk23 from "chalk";
+async function materializeAgent(printer, client) {
+  printer.log(`
+${chalk23.cyan("[ Step 4/7 ]")} ${chalk23.bold("\u9009\u62E9\u5E76\u521B\u5EFA Agent")}
+`);
+  let templates;
+  try {
+    templates = await client.call("template.list", {});
+  } catch (err) {
+    printer.warn(`  \u26A0 \u65E0\u6CD5\u83B7\u53D6\u6A21\u677F\u5217\u8868: ${err instanceof Error ? err.message : String(err)}`);
+    printer.dim("  \u4F60\u53EF\u4EE5\u7A0D\u540E\u4F7F\u7528 actant agent create <name> -t <template> \u521B\u5EFA Agent");
+    return [];
+  }
+  if (templates.length === 0) {
+    printer.dim("  \u6682\u65E0\u53EF\u7528\u6A21\u677F\u3002\u8BF7\u5148\u901A\u8FC7 actant source sync \u540C\u6B65\u7EC4\u4EF6\uFF0C\u6216\u4F7F\u7528 actant template load \u52A0\u8F7D\u6A21\u677F\u3002");
+    return [];
+  }
+  const selected = await checkbox({
+    message: "\u9009\u62E9\u8981\u521B\u5EFA\u7684 Agent \u6A21\u677F (\u7A7A\u683C\u9009\u62E9, \u56DE\u8F66\u786E\u8BA4):",
+    choices: templates.map((t, i) => ({
+      name: `${t.name} (v${t.version})${t.description ? ` \u2014 ${t.description}` : ""}`,
+      value: t.name,
+      checked: i === 0
+    }))
+  });
+  if (selected.length === 0) {
+    printer.dim("  \u672A\u9009\u62E9\u4EFB\u4F55\u6A21\u677F\uFF0C\u8DF3\u8FC7 Agent \u521B\u5EFA");
+    return [];
+  }
+  const createdAgents = [];
+  for (const templateName of selected) {
+    const instanceName = await input4({
+      message: `Agent \u5B9E\u4F8B\u540D\u79F0 (\u6A21\u677F: ${templateName}):`,
+      default: templateName,
+      validate: (val) => {
+        if (val.trim().length === 0) return "\u540D\u79F0\u4E0D\u80FD\u4E3A\u7A7A";
+        if (!/^[a-zA-Z0-9_-]+$/.test(val.trim())) return "\u4EC5\u5141\u8BB8\u5B57\u6BCD\u3001\u6570\u5B57\u3001\u4E0B\u5212\u7EBF\u548C\u8FDE\u5B57\u7B26";
+        return true;
+      }
+    });
+    try {
+      printer.log(chalk23.dim(`  \u6B63\u5728\u521B\u5EFA ${instanceName.trim()}...`));
+      await client.call("agent.create", {
+        name: instanceName.trim(),
+        template: templateName
+      });
+      printer.success(`  \u2713 Agent "${instanceName.trim()}" \u5DF2\u521B\u5EFA (\u6A21\u677F: ${templateName})`);
+      createdAgents.push(instanceName.trim());
+    } catch (err) {
+      printer.warn(`  \u26A0 \u521B\u5EFA "${instanceName.trim()}" \u5931\u8D25: ${err instanceof Error ? err.message : String(err)}`);
+    }
+  }
+  if (createdAgents.length > 0) {
+    printer.success(`\u2713 \u5DF2\u521B\u5EFA ${createdAgents.length} \u4E2A Agent`);
+  }
+  return createdAgents;
+}
+
+// src/commands/setup/steps/configure-autostart.ts
+import { execSync } from "child_process";
+import { writeFileSync as writeFileSync4, mkdirSync as mkdirSync3 } from "fs";
+import { join as join5 } from "path";
+import { homedir as homedir3 } from "os";
+import { confirm as confirm3 } from "@inquirer/prompts";
+import chalk24 from "chalk";
+import { isWindows as isWindows2 } from "@actant/shared";
+async function configureAutostart(printer) {
+  printer.log(`
+${chalk24.cyan("[ Step 5/7 ]")} ${chalk24.bold("\u914D\u7F6E\u81EA\u52A8\u542F\u52A8")}
+`);
+  const platform = process.platform;
+  const platformName = platform === "win32" ? "Windows" : platform === "darwin" ? "macOS" : "Linux";
+  printer.log(`  \u68C0\u6D4B\u5230\u5E73\u53F0: ${chalk24.bold(platformName)}`);
+  const enable = await confirm3({
+    message: "\u914D\u7F6E Actant Daemon \u5F00\u673A\u81EA\u542F?",
+    default: true
+  });
+  if (!enable) {
+    printer.dim("  \u8DF3\u8FC7\u81EA\u52A8\u542F\u52A8\u914D\u7F6E");
+    return;
+  }
+  try {
+    if (isWindows2()) {
+      configureWindows(printer);
+    } else if (platform === "darwin") {
+      configureMacOS(printer);
+    } else {
+      configureLinux(printer);
+    }
+    printer.success("\u2713 \u81EA\u52A8\u542F\u52A8\u5DF2\u914D\u7F6E");
+  } catch (err) {
+    printer.warn(`  \u26A0 \u81EA\u52A8\u542F\u52A8\u914D\u7F6E\u5931\u8D25: ${err instanceof Error ? err.message : String(err)}`);
+    printer.dim("  \u4F60\u53EF\u4EE5\u7A0D\u540E\u624B\u52A8\u914D\u7F6E\u81EA\u52A8\u542F\u52A8");
+  }
+}
+function configureWindows(printer) {
+  printer.log(chalk24.dim("  \u6B63\u5728\u6CE8\u518C Windows Task Scheduler \u4EFB\u52A1..."));
+  const actantPath = findActantExecutable();
+  const taskXml = `<?xml version="1.0" encoding="UTF-16"?>
+<Task version="1.2" xmlns="http://schemas.microsoft.com/windows/2004/02/mit/task">
+  <Triggers>
+    <LogonTrigger>
+      <Enabled>true</Enabled>
+    </LogonTrigger>
+  </Triggers>
+  <Principals>
+    <Principal>
+      <LogonType>InteractiveToken</LogonType>
+      <RunLevel>LeastPrivilege</RunLevel>
+    </Principal>
+  </Principals>
+  <Settings>
+    <MultipleInstancesPolicy>IgnoreNew</MultipleInstancesPolicy>
+    <DisallowStartIfOnBatteries>false</DisallowStartIfOnBatteries>
+    <StopIfGoingOnBatteries>false</StopIfGoingOnBatteries>
+    <ExecutionTimeLimit>PT0S</ExecutionTimeLimit>
+  </Settings>
+  <Actions>
+    <Exec>
+      <Command>${actantPath}</Command>
+      <Arguments>daemon start</Arguments>
+    </Exec>
+  </Actions>
+</Task>`;
+  const tempXmlPath = join5(process.env["TEMP"] || homedir3(), "actant-task.xml");
+  writeFileSync4(tempXmlPath, taskXml, "utf-16le");
+  execSync(`schtasks /Create /TN "ActantDaemon" /XML "${tempXmlPath}" /F`, { stdio: "pipe" });
+  printer.dim("  \u5DF2\u6CE8\u518C\u4EFB\u52A1: ActantDaemon (\u767B\u5F55\u65F6\u81EA\u52A8\u542F\u52A8)");
+}
+function configureMacOS(printer) {
+  printer.log(chalk24.dim("  \u6B63\u5728\u751F\u6210 launchd plist..."));
+  const actantPath = findActantExecutable();
+  const plistDir = join5(homedir3(), "Library", "LaunchAgents");
+  mkdirSync3(plistDir, { recursive: true });
+  const plistPath = join5(plistDir, "com.actant.daemon.plist");
+  const plist = `<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+  <key>Label</key>
+  <string>com.actant.daemon</string>
+  <key>ProgramArguments</key>
+  <array>
+    <string>${actantPath}</string>
+    <string>daemon</string>
+    <string>start</string>
+    <string>--foreground</string>
+  </array>
+  <key>RunAtLoad</key>
+  <true/>
+  <key>KeepAlive</key>
+  <true/>
+  <key>StandardOutPath</key>
+  <string>${join5(homedir3(), ".actant", "logs", "daemon-stdout.log")}</string>
+  <key>StandardErrorPath</key>
+  <string>${join5(homedir3(), ".actant", "logs", "daemon-stderr.log")}</string>
+</dict>
+</plist>`;
+  writeFileSync4(plistPath, plist);
+  execSync(`launchctl load "${plistPath}"`, { stdio: "pipe" });
+  printer.dim(`  \u5DF2\u52A0\u8F7D: ${plistPath}`);
+}
+function configureLinux(printer) {
+  printer.log(chalk24.dim("  \u6B63\u5728\u751F\u6210 systemd user service..."));
+  const actantPath = findActantExecutable();
+  const serviceDir = join5(homedir3(), ".config", "systemd", "user");
+  mkdirSync3(serviceDir, { recursive: true });
+  const servicePath = join5(serviceDir, "actant-daemon.service");
+  const unit = `[Unit]
+Description=Actant Daemon \u2014 AI Agent Platform
+After=network.target
+
+[Service]
+Type=simple
+ExecStart=${actantPath} daemon start --foreground
+Restart=on-failure
+RestartSec=5
+Environment=NODE_ENV=production
+
+[Install]
+WantedBy=default.target
+`;
+  writeFileSync4(servicePath, unit);
+  execSync("systemctl --user daemon-reload", { stdio: "pipe" });
+  execSync("systemctl --user enable actant-daemon.service", { stdio: "pipe" });
+  printer.dim(`  \u5DF2\u542F\u7528: actant-daemon.service`);
+}
+function findActantExecutable() {
+  try {
+    const result = execSync(isWindows2() ? "where.exe actant" : "which actant", {
+      encoding: "utf-8",
+      stdio: ["pipe", "pipe", "pipe"]
+    });
+    const first = result.trim().split("\n")[0];
+    return first ? first.trim() : "actant";
+  } catch {
+    return "actant";
+  }
+}
+
+// src/commands/setup/steps/hello-world.ts
+import chalk25 from "chalk";
+async function helloWorld(printer, client, createdAgents) {
+  printer.log(`
+${chalk25.cyan("[ Step 6/7 ]")} ${chalk25.bold("Hello World \u9A8C\u8BC1")}
+`);
+  const alive = await client.ping();
+  if (!alive) {
+    printer.warn("  \u26A0 Daemon \u672A\u8FD0\u884C\uFF0C\u8DF3\u8FC7\u9A8C\u8BC1");
+    printer.dim('  \u542F\u52A8\u540E\u53EF\u624B\u52A8\u9A8C\u8BC1: actant agent run <name> --prompt "Hello, World!"');
+    return;
+  }
+  printer.success("  \u2713 Daemon \u8FDE\u63A5\u6B63\u5E38");
+  if (createdAgents.length === 0) {
+    printer.dim("  \u65E0\u5DF2\u521B\u5EFA\u7684 Agent\uFF0C\u8DF3\u8FC7\u7AEF\u5230\u7AEF\u9A8C\u8BC1");
+    printer.dim('  \u521B\u5EFA Agent \u540E\u53EF\u8FD0\u884C: actant agent run <name> --prompt "Hello, World!"');
+    return;
+  }
+  const testAgent = createdAgents[0];
+  if (!testAgent) {
+    printer.dim("  \u65E0\u53EF\u7528 Agent\uFF0C\u8DF3\u8FC7\u7AEF\u5230\u7AEF\u9A8C\u8BC1");
+    return;
+  }
+  printer.log(chalk25.dim(`  \u6B63\u5728\u4F7F\u7528 Agent "${testAgent}" \u8FDB\u884C\u9A8C\u8BC1...`));
+  try {
+    await client.call("agent.start", { name: testAgent });
+    printer.success(`  \u2713 Agent "${testAgent}" \u5DF2\u542F\u52A8`);
+    await waitForAgentReady(client, testAgent, 15e3);
+    printer.log(chalk25.dim(`  \u53D1\u9001\u6D4B\u8BD5\u6D88\u606F: "Hello, World!"`));
+    const runResult = await client.call("agent.run", {
+      name: testAgent,
+      prompt: "Please respond with exactly: Hello from Actant! (keep it short)"
+    });
+    if (runResult) {
+      printer.success("  \u2713 \u6536\u5230 Agent \u56DE\u590D \u2014 \u7AEF\u5230\u7AEF\u9A8C\u8BC1\u901A\u8FC7!");
+    } else {
+      printer.warn("  \u26A0 Agent \u672A\u8FD4\u56DE\u7ED3\u679C\uFF0C\u4F46\u542F\u52A8\u6B63\u5E38");
+    }
+  } catch (err) {
+    const message = err instanceof Error ? err.message : String(err);
+    if (message.includes("not found") || message.includes("NOT_FOUND")) {
+      printer.warn(`  \u26A0 Agent "${testAgent}" \u672A\u627E\u5230\uFF0C\u8DF3\u8FC7\u9A8C\u8BC1`);
+    } else if (message.includes("Cannot connect")) {
+      printer.warn("  \u26A0 \u65E0\u6CD5\u8FDE\u63A5\u540E\u7AEF (backend)\uFF0C\u8BF7\u786E\u8BA4\u540E\u7AEF\u5DF2\u5B89\u88C5");
+      printer.dim("  \u63D0\u793A: claude-code \u540E\u7AEF\u9700\u8981\u5B89\u88C5 claude-agent-acp");
+    } else {
+      printer.warn(`  \u26A0 \u9A8C\u8BC1\u8FC7\u7A0B\u4E2D\u51FA\u73B0\u9519\u8BEF: ${message}`);
+    }
+    printer.dim('  \u4F60\u53EF\u4EE5\u7A0D\u540E\u624B\u52A8\u9A8C\u8BC1: actant agent run <name> --prompt "Hello!"');
+  }
+}
+async function waitForAgentReady(client, name, timeoutMs) {
+  const start = Date.now();
+  while (Date.now() - start < timeoutMs) {
+    try {
+      const status = await client.call("agent.status", { name });
+      if (status.status === "running") return;
+    } catch {
+    }
+    await new Promise((r) => setTimeout(r, 1e3));
+  }
+}
+
+// src/commands/setup/steps/configure-update.ts
+import { join as join6 } from "path";
+import { readFileSync as readFileSync3, writeFileSync as writeFileSync5, existsSync as existsSync4 } from "fs";
+import { confirm as confirm4, input as input5 } from "@inquirer/prompts";
+import chalk26 from "chalk";
+function detectDevSourcePath() {
+  const candidates = [
+    process.cwd(),
+    join6(process.cwd(), "..")
+  ];
+  for (const dir of candidates) {
+    if (existsSync4(join6(dir, "packages", "cli", "package.json"))) {
+      return dir;
+    }
+  }
+  return process.cwd();
+}
+async function configureUpdate(printer, actantHome) {
+  printer.log(`
+${chalk26.cyan("[ Step 7/7 ]")} ${chalk26.bold("\u66F4\u65B0\u9009\u9879")}
+`);
+  const wantConfigure = await confirm4({
+    message: "\u914D\u7F6E\u81EA\u52A8\u66F4\u65B0\u6E90? (\u7528\u4E8E\u4ECE\u672C\u5730\u6E90\u7801\u66F4\u65B0 Actant)",
+    default: false
+  });
+  if (!wantConfigure) {
+    printer.dim("  \u8DF3\u8FC7\u66F4\u65B0\u914D\u7F6E");
+    printUpdateHelp(printer);
+    return;
+  }
+  const defaultPath = detectDevSourcePath();
+  const devSourcePath = await input5({
+    message: "\u5F00\u53D1\u6E90\u76EE\u5F55\u8DEF\u5F84 (AgentCraft \u9879\u76EE\u6839\u76EE\u5F55):",
+    default: defaultPath,
+    validate: (val) => val.trim().length > 0 || "\u8DEF\u5F84\u4E0D\u80FD\u4E3A\u7A7A"
+  });
+  const configFile = join6(actantHome, "config.json");
+  let config = {};
+  try {
+    config = JSON.parse(readFileSync3(configFile, "utf-8"));
+  } catch {
+  }
+  config.devSourcePath = devSourcePath.trim();
+  writeFileSync5(configFile, JSON.stringify(config, null, 2) + "\n");
+  printer.success(`\u2713 \u66F4\u65B0\u6E90\u5DF2\u914D\u7F6E: ${devSourcePath.trim()}`);
+  printUpdateHelp(printer);
+}
+function printUpdateHelp(printer) {
+  printer.log("");
+  printer.dim("  \u66F4\u65B0\u547D\u4EE4:");
+  printer.dim(`    ${chalk26.cyan("actant self-update")}          \u4ECE\u6E90\u7801\u6784\u5EFA\u5E76\u66F4\u65B0`);
+  printer.dim(`    ${chalk26.cyan("actant self-update --check")}  \u68C0\u67E5\u7248\u672C\u5DEE\u5F02`);
+  printer.dim(`    ${chalk26.cyan("npm install -g @actant/cli")} \u4ECE npm \u66F4\u65B0`);
+}
+
+// src/commands/setup/setup.ts
+function createSetupCommand(printer = defaultPrinter) {
+  return new Command72("setup").description("Interactive setup wizard \u2014 configure Actant step by step").option("--skip-home", "Skip work directory selection").option("--skip-provider", "Skip model provider configuration").option("--skip-source", "Skip component source configuration").option("--skip-agent", "Skip agent creation").option("--skip-autostart", "Skip auto-start configuration").option("--skip-hello", "Skip hello world verification").option("--skip-update", "Skip update options").action(async (opts) => {
+    try {
+      printBanner(printer);
+      let actantHome;
+      if (opts.skipHome) {
+        const { homedir: homedir4 } = await import("os");
+        const { join: join8 } = await import("path");
+        const { existsSync: existsSync5, writeFileSync: writeFileSync6 } = await import("fs");
+        actantHome = process.env["ACTANT_HOME"] || join8(homedir4(), ".actant");
+        ensureDirectoryStructure(actantHome);
+        const configFile = join8(actantHome, "config.json");
+        if (!existsSync5(configFile)) {
+          writeFileSync6(configFile, JSON.stringify({
+            devSourcePath: "",
+            update: { maxBackups: 3, preUpdateTestCommand: "pnpm test:changed", autoRestartAgents: true }
+          }, null, 2) + "\n");
+        }
+        printer.dim(`  \u4F7F\u7528\u9ED8\u8BA4\u5DE5\u4F5C\u76EE\u5F55: ${actantHome}`);
+      } else {
+        actantHome = await chooseHome(printer);
+      }
+      if (!opts.skipProvider) {
+        await configureProvider(printer, actantHome);
+      }
+      const daemonNeeded = !opts.skipSource || !opts.skipAgent || !opts.skipHello;
+      let client;
+      let daemonStartedBySetup = false;
+      if (daemonNeeded) {
+        const socketPath = process.env["ACTANT_SOCKET"] ?? getDefaultIpcPath(actantHome);
+        client = new RpcClient(socketPath);
+        const alive = await client.ping();
+        if (!alive) {
+          printer.log(chalk27.dim("\n  \u6B63\u5728\u542F\u52A8 Daemon..."));
+          daemonStartedBySetup = await tryStartDaemon(printer, socketPath);
+          if (!daemonStartedBySetup) {
+            printer.warn("  \u26A0 \u65E0\u6CD5\u81EA\u52A8\u542F\u52A8 Daemon\uFF0C\u8DF3\u8FC7\u9700\u8981 Daemon \u7684\u6B65\u9AA4");
+            printer.dim("  \u8BF7\u624B\u52A8\u8FD0\u884C: actant daemon start");
+            client = void 0;
+          }
+        } else {
+          printer.dim("\n  Daemon \u5DF2\u5728\u8FD0\u884C\u4E2D");
+        }
+      }
+      if (!opts.skipSource && client) {
+        await configureSource(printer, client);
+      }
+      let createdAgents = [];
+      if (!opts.skipAgent && client) {
+        createdAgents = await materializeAgent(printer, client);
+      }
+      if (!opts.skipAutostart) {
+        await configureAutostart(printer);
+      }
+      if (!opts.skipHello && client) {
+        await helloWorld(printer, client, createdAgents);
+      }
+      if (!opts.skipUpdate) {
+        await configureUpdate(printer, actantHome);
+      }
+      printSummary(printer, actantHome);
+    } catch (err) {
+      if (isUserCancellation(err)) {
+        printer.log(chalk27.dim("\n  \u5DF2\u53D6\u6D88\u8BBE\u7F6E\u5411\u5BFC"));
+        return;
+      }
+      presentError(err, printer);
+      process.exitCode = 1;
+    }
+  });
+}
+function printBanner(printer) {
+  printer.log("");
+  printer.log(chalk27.cyan("\u2554\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2557"));
+  printer.log(chalk27.cyan("\u2551") + chalk27.bold("   Actant Setup Wizard                       ") + chalk27.cyan("\u2551"));
+  printer.log(chalk27.cyan("\u2551") + chalk27.dim("   Build, manage, and compose AI agents       ") + chalk27.cyan("\u2551"));
+  printer.log(chalk27.cyan("\u255A\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u255D"));
+}
+function printSummary(printer, actantHome) {
+  printer.log("");
+  printer.log(chalk27.green("\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550"));
+  printer.log(chalk27.green.bold("  Setup Complete!"));
+  printer.log(chalk27.green("\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550"));
+  printer.log("");
+  printer.dim(`  \u5DE5\u4F5C\u76EE\u5F55: ${actantHome}`);
+  printer.log("");
+  printer.log("  \u5FEB\u901F\u5F00\u59CB:");
+  printer.log(`    ${chalk27.cyan("actant daemon start")}     \u542F\u52A8 Daemon`);
+  printer.log(`    ${chalk27.cyan("actant template list")}    \u6D4F\u89C8\u6A21\u677F`);
+  printer.log(`    ${chalk27.cyan("actant agent list")}       \u67E5\u770B Agent`);
+  printer.log(`    ${chalk27.cyan("actant agent chat <n>")}   \u4E0E Agent \u5BF9\u8BDD`);
+  printer.log(`    ${chalk27.cyan("actant setup")}            \u91CD\u65B0\u8FD0\u884C\u6B64\u5411\u5BFC`);
+  printer.log("");
+  printer.dim("  \u66F4\u591A\u5E2E\u52A9: actant help");
+  printer.log("");
+}
+async function tryStartDaemon(printer, socketPath) {
+  try {
+    const { fork: fork2, spawn: spawn4 } = await import("child_process");
+    const { join: join8 } = await import("path");
+    const { isWindows: isWindows3, isSingleExecutable: isSingleExecutable2 } = await import("@actant/shared");
+    let child;
+    if (isSingleExecutable2()) {
+      child = spawn4(process.execPath, ["--__actant-daemon"], {
+        detached: true,
+        stdio: ["ignore", "ignore", "ignore"],
+        env: process.env
+      });
+    } else {
+      const daemonScript = join8(import.meta.dirname, "..", "daemon-entry.js");
+      child = isWindows3() ? spawn4(process.execPath, [daemonScript], {
+        detached: true,
+        stdio: ["ignore", "ignore", "ignore"],
+        env: process.env
+      }) : fork2(daemonScript, [], {
+        detached: true,
+        stdio: ["ignore", "ignore", "ignore", "ipc"],
+        env: process.env
+      });
+    }
+    if ("connected" in child && child.connected) child.disconnect();
+    child.unref();
+    const client = new RpcClient(socketPath);
+    for (let i = 0; i < 10; i++) {
+      await new Promise((r) => setTimeout(r, 1e3));
+      if (await client.ping()) {
+        printer.success("  \u2713 Daemon \u5DF2\u542F\u52A8");
+        return true;
+      }
+    }
+    printer.warn("  \u26A0 Daemon \u8FDB\u7A0B\u5DF2\u542F\u52A8\u4F46\u672A\u54CD\u5E94");
+    return false;
+  } catch (err) {
+    printer.warn(`  \u26A0 \u542F\u52A8 Daemon \u5931\u8D25: ${err instanceof Error ? err.message : String(err)}`);
+    return false;
+  }
+}
+function isUserCancellation(err) {
+  if (err instanceof Error) {
+    return err.message.includes("User force closed") || err.message.includes("prompt was canceled") || err.name === "ExitPromptError";
+  }
+  return false;
+}
+
 // src/program.ts
 function defaultSocketPath() {
-  return process.env["ACTANT_SOCKET"] ?? getDefaultIpcPath();
+  const home = process.env["ACTANT_HOME"];
+  return process.env["ACTANT_SOCKET"] ?? getDefaultIpcPath2(home);
 }
 function createProgram(socketPath, printer) {
   const sock = socketPath ?? defaultSocketPath();
   const client = new RpcClient(sock);
-  const program = new Command72("actant").version("0.1.0").description("Actant \u2014 Build, manage, and compose AI agents");
+  const pkgPath = join7(import.meta.dirname, "..", "package.json");
+  const { version } = JSON.parse(readFileSync4(pkgPath, "utf-8"));
+  const program = new Command73("actant").version(version).description("Actant \u2014 Build, manage, and compose AI agents");
   program.addCommand(createTemplateCommand(client, printer));
   program.addCommand(createAgentCommand(client, printer));
   program.addCommand(createSkillCommand(client, printer));
@@ -2619,6 +3406,7 @@ function createProgram(socketPath, printer) {
   program.addCommand(createProxyCommand(printer));
   program.addCommand(createHelpCommand());
   program.addCommand(createSelfUpdateCommand());
+  program.addCommand(createSetupCommand(printer));
   program.exitOverride();
   return program;
 }
@@ -2631,7 +3419,7 @@ async function run(argv) {
     if (!versionRequested && !helpRequested) {
       const sock = defaultSocketPath();
       const client = new RpcClient(sock);
-      const { startRepl } = await import("./repl-JIMJ2V2Y.js");
+      const { startRepl } = await import("./repl-7TMOU5HY.js");
       await startRepl(client, sock);
       return;
     }
@@ -2660,4 +3448,4 @@ export {
   createProgram,
   run
 };
-//# sourceMappingURL=chunk-2FKBVXMH.js.map
+//# sourceMappingURL=chunk-I3QY66Y6.js.map