@actant/cli 0.1.2 → 0.2.0

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

@@ -1,6 +1,8 @@
 // src/program.ts
-import { Command as Command72 } from "commander";
-import { getDefaultIpcPath } from "@actant/shared";
+import { Command as Command74 } 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";
@@ -572,19 +574,56 @@ function createTemplateLoadCommand(client, printer = defaultPrinter) {
 
 // src/commands/template/install.ts
 import { Command as Command5 } from "commander";
-function createTemplateInstallCommand(_client, printer = defaultPrinter) {
-  return new Command5("install").description("Install a template from a source (source@name)").argument("<spec>", "Source and template name, e.g. my-source@my-template").action(async (spec) => {
+import chalk7 from "chalk";
+var DEFAULT_SOURCE = "actant-hub";
+function createTemplateInstallCommand(client, printer = defaultPrinter) {
+  return new Command5("install").description("Install a template from a source (source@name or just name for default source)").argument("<spec>", 'Template spec: "source@name" or just "name" (uses actant-hub)').action(async (spec) => {
     try {
       const at = spec.indexOf("@");
-      if (at < 0) {
-        printer.error("Expected format: <source>@<name>");
+      const sourceName = at >= 0 ? spec.slice(0, at) : DEFAULT_SOURCE;
+      const templateName = at >= 0 ? spec.slice(at + 1) : spec;
+      const qualifiedName = `${sourceName}@${templateName}`;
+      printer.log(chalk7.dim(`  Syncing source "${sourceName}"...`));
+      try {
+        await client.call("source.sync", { name: sourceName });
+      } catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        if (!msg.includes("not found")) {
+          printer.warn(`  Warning: sync failed (${msg}), checking local cache...`);
+        } else {
+          printer.error(`Source "${sourceName}" not found. Add it first: actant source add <url> --name ${sourceName}`);
+          process.exitCode = 1;
+          return;
+        }
+      }
+      try {
+        const template = await client.call("template.get", { name: qualifiedName });
+        printer.success(`  Template "${qualifiedName}" is available.`);
+        printer.log("");
+        printer.log(`  ${chalk7.bold("Name:")}        ${template.name}`);
+        if (template.description) {
+          printer.log(`  ${chalk7.bold("Description:")} ${template.description}`);
+        }
+        printer.log(`  ${chalk7.bold("Backend:")}     ${template.backend.type}`);
+        printer.log(`  ${chalk7.bold("Version:")}     ${template.version}`);
+        printer.log("");
+        printer.log(`  Create an agent: ${chalk7.cyan(`actant agent create <agent-name> --template ${qualifiedName}`)}`);
+      } catch {
+        printer.error(`Template "${qualifiedName}" not found in source "${sourceName}".`);
+        printer.log(chalk7.dim("  Available templates:"));
+        try {
+          const templates = await client.call("template.list", {});
+          const fromSource = templates.filter((t) => t.name.startsWith(`${sourceName}@`));
+          for (const t of fromSource) {
+            printer.log(chalk7.dim(`    - ${t.name}`));
+          }
+          if (fromSource.length === 0) {
+            printer.log(chalk7.dim("    (none from this source)"));
+          }
+        } catch {
+        }
         process.exitCode = 1;
-        return;
       }
-      const source = spec.slice(0, at);
-      printer.log(
-        `Template install not yet implemented via RPC - use "actant source sync ${source}" to sync templates from the source.`
-      );
     } catch (err) {
       presentError(err, printer);
       process.exitCode = 1;
@@ -604,14 +643,14 @@ function createTemplateCommand(client, printer) {
 }
 
 // src/commands/agent/index.ts
-import { Command as Command23 } from "commander";
+import { Command as Command24 } from "commander";
 
 // src/commands/agent/create.ts
 import { existsSync } from "fs";
 import { resolve as resolve3 } from "path";
 import { createInterface } from "readline";
 import { Command as Command7 } from "commander";
-import chalk7 from "chalk";
+import chalk8 from "chalk";
 var VALID_LAUNCH_MODES = /* @__PURE__ */ new Set(["direct", "acp-background", "acp-service", "one-shot"]);
 function askQuestion(question) {
   const rl = createInterface({ input: process.stdin, output: process.stdout });
@@ -626,12 +665,12 @@ function createAgentCreateCommand(client, printer = defaultPrinter) {
   return new Command7("create").description("Create a new agent from a template").argument("<name>", "Agent instance name").requiredOption("-t, --template <template>", "Template name to use").option("--launch-mode <mode>", "Launch mode: direct, acp-background, acp-service, one-shot").option("--work-dir <path>", "Custom workspace directory (absolute or relative path)").option("--workspace <path>", "Same as --work-dir: create instance at external path instead of builtin location").option("--overwrite", "If work-dir exists, remove it and recreate").option("--append", "If work-dir exists, add agent files into it").option("-f, --format <format>", "Output format: table, json, quiet", "table").action(async (name, opts) => {
     try {
       if (opts.launchMode && !VALID_LAUNCH_MODES.has(opts.launchMode)) {
-        printer.error(`${chalk7.red(`Invalid launch mode: ${opts.launchMode}`)}`);
+        printer.error(`${chalk8.red(`Invalid launch mode: ${opts.launchMode}`)}`);
         process.exitCode = 1;
         return;
       }
       if (opts.overwrite && opts.append) {
-        printer.error(`${chalk7.red("Cannot use both --overwrite and --append")}`);
+        printer.error(`${chalk8.red("Cannot use both --overwrite and --append")}`);
         process.exitCode = 1;
         return;
       }
@@ -646,7 +685,7 @@ function createAgentCreateCommand(client, printer = defaultPrinter) {
         } else {
           printer.warn(`Directory already exists: ${workDir}`);
           const answer = await askQuestion(
-            `  ${chalk7.yellow("(o)")}verwrite / ${chalk7.cyan("(a)")}ppend / ${chalk7.dim("(c)")}ancel? `
+            `  ${chalk8.yellow("(o)")}verwrite / ${chalk8.cyan("(a)")}ppend / ${chalk8.dim("(c)")}ancel? `
           );
           if (answer === "o" || answer === "overwrite") {
             workDirConflict = "overwrite";
@@ -667,7 +706,7 @@ function createAgentCreateCommand(client, printer = defaultPrinter) {
         template: opts.template,
         overrides: Object.keys(overrides).length > 0 ? overrides : void 0
       });
-      printer.log(`${chalk7.green("Agent created successfully.")}
+      printer.log(`${chalk8.green("Agent created successfully.")}
 `);
       printer.log(formatAgentDetail(meta, opts.format));
     } catch (err) {
@@ -679,12 +718,12 @@ function createAgentCreateCommand(client, printer = defaultPrinter) {
 
 // src/commands/agent/start.ts
 import { Command as Command8 } from "commander";
-import chalk8 from "chalk";
+import chalk9 from "chalk";
 function createAgentStartCommand(client, printer = defaultPrinter) {
   return new Command8("start").description("Start an agent").argument("<name>", "Agent name").action(async (name) => {
     try {
       await client.call("agent.start", { name });
-      printer.log(`${chalk8.green("Started")} ${name}`);
+      printer.log(`${chalk9.green("Started")} ${name}`);
     } catch (err) {
       presentError(err, printer);
       process.exitCode = 1;
@@ -694,12 +733,12 @@ function createAgentStartCommand(client, printer = defaultPrinter) {
 
 // src/commands/agent/stop.ts
 import { Command as Command9 } from "commander";
-import chalk9 from "chalk";
+import chalk10 from "chalk";
 function createAgentStopCommand(client, printer = defaultPrinter) {
   return new Command9("stop").description("Stop a running agent").argument("<name>", "Agent name").action(async (name) => {
     try {
       await client.call("agent.stop", { name });
-      printer.log(`${chalk9.green("Stopped")} ${name}`);
+      printer.log(`${chalk10.green("Stopped")} ${name}`);
     } catch (err) {
       presentError(err, printer);
       process.exitCode = 1;
@@ -741,7 +780,7 @@ function createAgentListCommand(client, printer = defaultPrinter) {
 }
 
 // src/commands/agent/adopt.ts
-import chalk10 from "chalk";
+import chalk11 from "chalk";
 import { Command as Command12 } from "commander";
 function formatAdoptResult(result, format) {
   if (format === "json") {
@@ -751,14 +790,14 @@ function formatAdoptResult(result, format) {
     return result.name;
   }
   const lines = [
-    chalk10.green("Agent adopted successfully."),
+    chalk11.green("Agent adopted successfully."),
     "",
-    `${chalk10.bold("Name:")}          ${result.name}`,
-    `${chalk10.bold("Template:")}      ${result.template}`,
-    `${chalk10.bold("Workspace:")}     ${result.workspacePath}`,
-    `${chalk10.bold("Location:")}      ${result.location}`,
-    `${chalk10.bold("Status:")}        ${result.status}`,
-    `${chalk10.bold("Created:")}       ${result.createdAt}`
+    `${chalk11.bold("Name:")}          ${result.name}`,
+    `${chalk11.bold("Template:")}      ${result.template}`,
+    `${chalk11.bold("Workspace:")}     ${result.workspacePath}`,
+    `${chalk11.bold("Location:")}      ${result.location}`,
+    `${chalk11.bold("Status:")}        ${result.status}`,
+    `${chalk11.bold("Created:")}       ${result.createdAt}`
   ];
   return lines.join("\n");
 }
@@ -779,7 +818,7 @@ function createAgentAdoptCommand(client, printer = defaultPrinter) {
 
 // src/commands/agent/destroy.ts
 import { Command as Command13 } from "commander";
-import chalk11 from "chalk";
+import chalk12 from "chalk";
 function createAgentDestroyCommand(client, printer = defaultPrinter) {
   return new Command13("destroy").alias("rm").description("Destroy an agent (removes workspace directory)").argument("<name>", "Agent name").option("--force", "Skip confirmation", false).action(async (name, opts) => {
     if (!opts.force) {
@@ -790,7 +829,7 @@ function createAgentDestroyCommand(client, printer = defaultPrinter) {
     }
     try {
       await client.call("agent.destroy", { name });
-      printer.log(`${chalk11.green("Destroyed")} ${name}`);
+      printer.log(`${chalk12.green("Destroyed")} ${name}`);
     } catch (err) {
       presentError(err, printer);
       process.exitCode = 1;
@@ -800,7 +839,7 @@ function createAgentDestroyCommand(client, printer = defaultPrinter) {
 
 // src/commands/agent/resolve.ts
 import { Command as Command14 } from "commander";
-import chalk12 from "chalk";
+import chalk13 from "chalk";
 function createAgentResolveCommand(client, printer = defaultPrinter) {
   return new Command14("resolve").description("Resolve spawn info for an agent (external spawn support)").argument("<name>", "Agent instance name").option("-t, --template <template>", "Template name (auto-creates instance if not found)").option("-f, --format <format>", "Output format: table, json, quiet", "table").action(async (name, opts) => {
     try {
@@ -814,16 +853,16 @@ function createAgentResolveCommand(client, printer = defaultPrinter) {
         printer.log([result.command, ...result.args].join(" "));
       } else {
         if (result.created) {
-          printer.log(`${chalk12.green("Instance created.")}
+          printer.log(`${chalk13.green("Instance created.")}
 `);
         }
-        printer.log(`${chalk12.bold("Instance:")}  ${result.instanceName}`);
-        printer.log(`${chalk12.bold("Backend:")}   ${result.backendType}`);
-        printer.log(`${chalk12.bold("Workspace:")} ${result.workspaceDir}`);
-        printer.log(`${chalk12.bold("Command:")}   ${result.command}`);
-        printer.log(`${chalk12.bold("Args:")}      ${result.args.join(" ")}`);
+        printer.log(`${chalk13.bold("Instance:")}  ${result.instanceName}`);
+        printer.log(`${chalk13.bold("Backend:")}   ${result.backendType}`);
+        printer.log(`${chalk13.bold("Workspace:")} ${result.workspaceDir}`);
+        printer.log(`${chalk13.bold("Command:")}   ${result.command}`);
+        printer.log(`${chalk13.bold("Args:")}      ${result.args.join(" ")}`);
         if (result.env && Object.keys(result.env).length > 0) {
-          printer.log(chalk12.bold("Env:"));
+          printer.log(chalk13.bold("Env:"));
           for (const [k, v] of Object.entries(result.env)) {
             printer.log(`  ${k}=${v}`);
           }
@@ -836,15 +875,32 @@ function createAgentResolveCommand(client, printer = defaultPrinter) {
   });
 }
 
-// src/commands/agent/attach.ts
+// src/commands/agent/open.ts
+import { spawn } from "child_process";
 import { Command as Command15 } from "commander";
-import chalk13 from "chalk";
+import chalk14 from "chalk";
+function createAgentOpenCommand(client, printer = defaultPrinter) {
+  return new Command15("open").description("Open an agent's native TUI/UI (e.g. Cursor IDE)").argument("<name>", "Agent name").action(async (name) => {
+    try {
+      const result = await client.call("agent.open", { name });
+      printer.log(`${chalk14.green("Opening")} ${name} \u2192 ${result.command} ${result.args.join(" ")}`);
+      spawn(result.command, result.args, { detached: true, stdio: "ignore" }).unref();
+    } catch (err) {
+      presentError(err, printer);
+      process.exitCode = 1;
+    }
+  });
+}
+
+// src/commands/agent/attach.ts
+import { Command as Command16 } from "commander";
+import chalk15 from "chalk";
 function createAgentAttachCommand(client, printer = defaultPrinter) {
-  return new Command15("attach").description("Attach an externally-spawned process to an agent").argument("<name>", "Agent instance name").requiredOption("--pid <pid>", "Process ID of the externally-spawned agent").option("--metadata <json>", "Additional metadata as JSON object").option("-f, --format <format>", "Output format: table, json, quiet", "table").action(async (name, opts) => {
+  return new Command16("attach").description("Attach an externally-spawned process to an agent").argument("<name>", "Agent instance name").requiredOption("--pid <pid>", "Process ID of the externally-spawned agent").option("--metadata <json>", "Additional metadata as JSON object").option("-f, --format <format>", "Output format: table, json, quiet", "table").action(async (name, opts) => {
     try {
       const pid = parseInt(opts.pid, 10);
       if (isNaN(pid) || pid <= 0) {
-        printer.error(chalk13.red("Invalid PID: must be a positive integer"));
+        printer.error(chalk15.red("Invalid PID: must be a positive integer"));
         process.exitCode = 1;
         return;
       }
@@ -853,13 +909,13 @@ function createAgentAttachCommand(client, printer = defaultPrinter) {
         try {
           metadata = JSON.parse(opts.metadata);
         } catch {
-          printer.error(chalk13.red("Invalid --metadata: must be valid JSON"));
+          printer.error(chalk15.red("Invalid --metadata: must be valid JSON"));
           process.exitCode = 1;
           return;
         }
       }
       const meta = await client.call("agent.attach", { name, pid, metadata });
-      printer.log(`${chalk13.green("Process attached.")}
+      printer.log(`${chalk15.green("Process attached.")}
 `);
       printer.log(formatAgentDetail(meta, opts.format));
     } catch (err) {
@@ -870,9 +926,9 @@ function createAgentAttachCommand(client, printer = defaultPrinter) {
 }
 
 // src/commands/agent/detach.ts
-import { Command as Command16 } from "commander";
+import { Command as Command17 } from "commander";
 function createAgentDetachCommand(client, printer = defaultPrinter) {
-  return new Command16("detach").description("Detach an externally-managed process from an agent").argument("<name>", "Agent instance name").option("--cleanup", "Clean up ephemeral workspace after detach").action(async (name, opts) => {
+  return new Command17("detach").description("Detach an externally-managed process from an agent").argument("<name>", "Agent instance name").option("--cleanup", "Clean up ephemeral workspace after detach").action(async (name, opts) => {
     try {
       const result = await client.call("agent.detach", {
         name,
@@ -890,9 +946,9 @@ function createAgentDetachCommand(client, printer = defaultPrinter) {
 }
 
 // src/commands/agent/run.ts
-import { Command as Command17 } from "commander";
+import { Command as Command18 } from "commander";
 function createAgentRunCommand(client, printer = defaultPrinter) {
-  return new Command17("run").description("Send a prompt to an agent and get the response").argument("<name>", "Agent name").requiredOption("--prompt <prompt>", "The prompt to send").option("--model <model>", "Model to use (e.g. sonnet, opus)").option("--max-turns <turns>", "Maximum agentic turns", parseInt).option("--timeout <ms>", "Timeout in milliseconds", parseInt).option("--session-id <id>", "Resume a specific session").option("-f, --format <format>", "Output format: text, json", "text").action(async (name, opts) => {
+  return new Command18("run").description("Send a prompt to an agent and get the response").argument("<name>", "Agent name").requiredOption("--prompt <prompt>", "The prompt to send").option("--model <model>", "Model to use (e.g. sonnet, opus)").option("--max-turns <turns>", "Maximum agentic turns", parseInt).option("--timeout <ms>", "Timeout in milliseconds", parseInt).option("--session-id <id>", "Resume a specific session").option("-f, --format <format>", "Output format: text, json", "text").action(async (name, opts) => {
     try {
       const rpcTimeout = (opts.timeout ?? 3e5) + 5e3;
       const result = await client.call("agent.run", {
@@ -918,9 +974,9 @@ function createAgentRunCommand(client, printer = defaultPrinter) {
 }
 
 // src/commands/agent/prompt.ts
-import { Command as Command18 } from "commander";
+import { Command as Command19 } from "commander";
 function createAgentPromptCommand(client, printer = defaultPrinter) {
-  return new Command18("prompt").description("Send a message to a running agent's ACP session").argument("<name>", "Agent name (must be started with `agent start`)").requiredOption("-m, --message <message>", "The message to send").option("--session-id <id>", "Specific ACP session ID (uses primary session if omitted)").option("-f, --format <format>", "Output format: text, json", "text").action(async (name, opts) => {
+  return new Command19("prompt").description("Send a message to a running agent's ACP session").argument("<name>", "Agent name (must be started with `agent start`)").requiredOption("-m, --message <message>", "The message to send").option("--session-id <id>", "Specific ACP session ID (uses primary session if omitted)").option("-f, --format <format>", "Output format: text, json", "text").action(async (name, opts) => {
     try {
       const result = await client.call("agent.prompt", {
         name,
@@ -941,11 +997,11 @@ function createAgentPromptCommand(client, printer = defaultPrinter) {
 
 // src/commands/agent/chat.ts
 import { createInterface as createInterface2 } from "readline";
-import { Command as Command19 } from "commander";
-import chalk14 from "chalk";
+import { Command as Command20 } from "commander";
+import chalk16 from "chalk";
 import { AcpConnection } from "@actant/acp";
 function createAgentChatCommand(client, printer = defaultPrinter) {
-  return new Command19("chat").description("Start an interactive chat session with an agent").argument("<name>", "Agent name").option("-t, --template <template>", "Template name (auto-creates instance if not found)").action(async (name, opts) => {
+  return new Command20("chat").description("Start an interactive chat session with an agent").argument("<name>", "Agent name").option("-t, --template <template>", "Template name (auto-creates instance if not found)").action(async (name, opts) => {
     try {
       await runChat(client, name, opts, printer);
     } catch (err) {
@@ -978,9 +1034,9 @@ async function runChat(client, name, opts, printer) {
 async function runDaemonChat(client, name, printer) {
   const meta = await client.call("agent.status", { name });
   printer.log(
-    chalk14.bold(`Chat with ${meta.name}`) + chalk14.dim(` (${meta.templateName}@${meta.templateVersion}) [daemon-managed]`)
+    chalk16.bold(`Chat with ${meta.name}`) + chalk16.dim(` (${meta.templateName}@${meta.templateVersion}) [daemon-managed]`)
   );
-  printer.log(chalk14.dim('Type your message and press Enter. Use "exit" or Ctrl+C to quit.\n'));
+  printer.log(chalk16.dim('Type your message and press Enter. Use "exit" or Ctrl+C to quit.\n'));
   const rl = createReadline();
   rl.prompt();
   let sessionId;
@@ -995,7 +1051,7 @@ async function runDaemonChat(client, name, printer) {
       return;
     }
     try {
-      process.stdout.write(chalk14.cyan("agent> "));
+      process.stdout.write(chalk16.cyan("agent> "));
       const result = await client.call("agent.prompt", {
         name,
         message: trimmed,
@@ -1009,7 +1065,7 @@ async function runDaemonChat(client, name, printer) {
     rl.prompt();
   });
   rl.on("close", () => {
-    process.stdout.write(chalk14.dim("\nChat ended.\n"));
+    process.stdout.write(chalk16.dim("\nChat ended.\n"));
   });
   return new Promise((resolve9) => {
     rl.on("close", resolve9);
@@ -1045,9 +1101,9 @@ async function runDirectBridgeChat(client, name, opts, printer) {
     const agentName = initResult.agentInfo?.name ?? name;
     session = await conn.newSession(resolved.workspaceDir);
     printer.log(
-      chalk14.bold(`Chat with ${agentName}`) + chalk14.dim(` (direct bridge, session ${session.sessionId.slice(0, 8)}...)`)
+      chalk16.bold(`Chat with ${agentName}`) + chalk16.dim(` (direct bridge, session ${session.sessionId.slice(0, 8)}...)`)
     );
-    printer.log(chalk14.dim('Type your message and press Enter. Use "exit" or Ctrl+C to quit.\n'));
+    printer.log(chalk16.dim('Type your message and press Enter. Use "exit" or Ctrl+C to quit.\n'));
     const rl = createReadline();
     process.on("SIGINT", () => {
       if (session) {
@@ -1079,7 +1135,7 @@ async function runDirectBridgeChat(client, name, opts, printer) {
       rl.prompt();
     });
     rl.on("close", () => {
-      process.stdout.write(chalk14.dim("\nChat ended.\n"));
+      process.stdout.write(chalk16.dim("\nChat ended.\n"));
     });
     await new Promise((resolve9) => {
       rl.on("close", resolve9);
@@ -1092,7 +1148,7 @@ function createReadline() {
   return createInterface2({
     input: process.stdin,
     output: process.stdout,
-    prompt: chalk14.green("you> "),
+    prompt: chalk16.green("you> "),
     terminal: process.stdin.isTTY ?? false
   });
 }
@@ -1134,9 +1190,9 @@ function notificationToChunk(notification) {
 }
 
 // src/commands/agent/dispatch.ts
-import { Command as Command20 } from "commander";
+import { Command as Command21 } from "commander";
 function createAgentDispatchCommand(client, printer = defaultPrinter) {
-  return new Command20("dispatch").description("Queue a one-off task for an agent's scheduler").argument("<name>", "Agent name").requiredOption("-m, --message <message>", "The prompt/message to dispatch").option("-p, --priority <priority>", "Task priority: low, normal, high, critical", "normal").action(async (name, opts) => {
+  return new Command21("dispatch").description("Queue a one-off task for an agent's scheduler").argument("<name>", "Agent name").requiredOption("-m, --message <message>", "The prompt/message to dispatch").option("-p, --priority <priority>", "Task priority: low, normal, high, critical", "normal").action(async (name, opts) => {
     try {
       const result = await client.call("agent.dispatch", {
         name,
@@ -1156,9 +1212,9 @@ function createAgentDispatchCommand(client, printer = defaultPrinter) {
 }
 
 // src/commands/agent/tasks.ts
-import { Command as Command21 } from "commander";
+import { Command as Command22 } from "commander";
 function createAgentTasksCommand(client, printer = defaultPrinter) {
-  return new Command21("tasks").description("List queued tasks for an agent's scheduler").argument("<name>", "Agent name").option("-f, --format <format>", "Output format: table, json", "table").action(async (name, opts) => {
+  return new Command22("tasks").description("List queued tasks for an agent's scheduler").argument("<name>", "Agent name").option("-f, --format <format>", "Output format: table, json", "table").action(async (name, opts) => {
     try {
       const result = await client.call("agent.tasks", { name });
       if (opts.format === "json") {
@@ -1180,9 +1236,9 @@ function createAgentTasksCommand(client, printer = defaultPrinter) {
 }
 
 // src/commands/agent/logs.ts
-import { Command as Command22 } from "commander";
+import { Command as Command23 } from "commander";
 function createAgentLogsCommand(client, printer = defaultPrinter) {
-  return new Command22("logs").description("Show execution logs for an agent's scheduler").argument("<name>", "Agent name").option("--limit <n>", "Maximum number of records to show", parseInt, 20).option("-f, --format <format>", "Output format: table, json", "table").action(async (name, opts) => {
+  return new Command23("logs").description("Show execution logs for an agent's scheduler").argument("<name>", "Agent name").option("--limit <n>", "Maximum number of records to show", parseInt, 20).option("-f, --format <format>", "Output format: table, json", "table").action(async (name, opts) => {
     try {
       const result = await client.call("agent.logs", { name, limit: opts.limit });
       if (opts.format === "json") {
@@ -1208,7 +1264,7 @@ function createAgentLogsCommand(client, printer = defaultPrinter) {
 
 // src/commands/agent/index.ts
 function createAgentCommand(client, printer) {
-  const cmd = new Command23("agent").description("Manage agent instances");
+  const cmd = new Command24("agent").description("Manage agent instances");
   cmd.addCommand(createAgentCreateCommand(client, printer));
   cmd.addCommand(createAgentStartCommand(client, printer));
   cmd.addCommand(createAgentStopCommand(client, printer));
@@ -1217,6 +1273,7 @@ function createAgentCommand(client, printer) {
   cmd.addCommand(createAgentAdoptCommand(client, printer));
   cmd.addCommand(createAgentDestroyCommand(client, printer));
   cmd.addCommand(createAgentResolveCommand(client, printer));
+  cmd.addCommand(createAgentOpenCommand(client, printer));
   cmd.addCommand(createAgentAttachCommand(client, printer));
   cmd.addCommand(createAgentDetachCommand(client, printer));
   cmd.addCommand(createAgentRunCommand(client, printer));
@@ -1229,13 +1286,13 @@ function createAgentCommand(client, printer) {
 }
 
 // src/commands/help.ts
-import { Command as Command24 } from "commander";
-import chalk15 from "chalk";
+import { Command as Command25 } from "commander";
+import chalk17 from "chalk";
 
 // package.json
 var package_default = {
   name: "@actant/cli",
-  version: "0.1.2",
+  version: "0.2.0",
   description: "CLI for the Actant AI agent platform \u2014 build, manage, and compose AI agents",
   type: "module",
   license: "MIT",
@@ -1247,11 +1304,27 @@ 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"
+  ],
+  main: "./dist/index.js",
+  types: "./dist/index.d.ts",
+  exports: {
+    ".": {
+      import: "./dist/index.js",
+      types: "./dist/index.d.ts"
+    }
+  },
   bin: {
     actant: "./dist/bin/actant.js"
   },
@@ -1268,7 +1341,9 @@ var package_default = {
     "@actant/acp": "workspace:*",
     "@actant/api": "workspace:*",
     "@actant/core": "workspace:*",
+    "@actant/pi": "workspace:*",
     "@actant/shared": "workspace:*",
+    "@inquirer/prompts": "^8.3.0",
     chalk: "^5.6.2",
     "cli-table3": "^0.6.5",
     commander: "^14.0.3"
@@ -1280,42 +1355,42 @@ function showOverview() {
   const version = package_default.version ?? "0.1.0";
   const lines = [
     "",
-    chalk15.bold("  Actant \u2014 Build, manage, and compose AI agents"),
-    chalk15.gray(`  v${version}`),
+    chalk17.bold("  Actant \u2014 Build, manage, and compose AI agents"),
+    chalk17.gray(`  v${version}`),
     "",
-    chalk15.bold("  Quick Start:"),
-    `    ${chalk15.cyan("actant daemon start")}              Start the daemon`,
-    `    ${chalk15.cyan("actant agent create my-agent")}     Create an Agent`,
-    `    ${chalk15.cyan("actant agent start my-agent")}      Start an Agent`,
-    `    ${chalk15.cyan("actant agent chat my-agent")}      Chat with an Agent`,
+    chalk17.bold("  Quick Start:"),
+    `    ${chalk17.cyan("actant daemon start")}              Start the daemon`,
+    `    ${chalk17.cyan("actant agent create my-agent")}     Create an Agent`,
+    `    ${chalk17.cyan("actant agent start my-agent")}      Start an Agent`,
+    `    ${chalk17.cyan("actant agent chat my-agent")}      Chat with an Agent`,
     "",
-    chalk15.bold("  Agent Management:"),
-    `    ${chalk15.cyan("agent")} create|start|stop|list|chat|run    Agent lifecycle`,
-    `    ${chalk15.cyan("agent adopt")} <path>                       Adopt existing workspace`,
-    `    ${chalk15.cyan("template")} list|show                       Agent templates`,
-    `    ${chalk15.cyan("proxy")} <name>                             ACP proxy forwarding`,
+    chalk17.bold("  Agent Management:"),
+    `    ${chalk17.cyan("agent")} create|start|stop|list|chat|run    Agent lifecycle`,
+    `    ${chalk17.cyan("agent adopt")} <path>                       Adopt existing workspace`,
+    `    ${chalk17.cyan("template")} list|show                       Agent templates`,
+    `    ${chalk17.cyan("proxy")} <name>                             ACP proxy forwarding`,
     "",
-    chalk15.bold("  Component Management:"),
-    `    ${chalk15.cyan("skill")} list|add|remove|show       Manage skills`,
-    `    ${chalk15.cyan("prompt")} list|add|remove|show      Manage prompts`,
-    `    ${chalk15.cyan("mcp")} list|show                    Manage MCP server configs`,
-    `    ${chalk15.cyan("workflow")} list|show               Manage workflows`,
-    `    ${chalk15.cyan("plugin")} list|add|remove|show     Manage plugins`,
+    chalk17.bold("  Component Management:"),
+    `    ${chalk17.cyan("skill")} list|add|remove|show       Manage skills`,
+    `    ${chalk17.cyan("prompt")} list|add|remove|show      Manage prompts`,
+    `    ${chalk17.cyan("mcp")} list|show                    Manage MCP server configs`,
+    `    ${chalk17.cyan("workflow")} list|show               Manage workflows`,
+    `    ${chalk17.cyan("plugin")} list|add|remove|show     Manage plugins`,
     "",
-    chalk15.bold("  Ecosystem:"),
-    `    ${chalk15.cyan("source")} list|add|remove|sync      Manage component sources`,
-    `    ${chalk15.cyan("preset")} list|apply                Manage preset packs`,
+    chalk17.bold("  Ecosystem:"),
+    `    ${chalk17.cyan("source")} list|add|remove|sync      Manage component sources`,
+    `    ${chalk17.cyan("preset")} list|apply                Manage preset packs`,
     "",
-    chalk15.bold("  Scheduling:"),
-    `    ${chalk15.cyan("schedule")} list                    Manage employee agent scheduling`,
+    chalk17.bold("  Scheduling:"),
+    `    ${chalk17.cyan("schedule")} list                    Manage employee agent scheduling`,
     "",
-    chalk15.bold("  System:"),
-    `    ${chalk15.cyan("daemon")} start|stop|status         Daemon management`,
-    `    ${chalk15.cyan("help")} [command]                   Show help`,
-    `    ${chalk15.cyan("--version")}                        Show version`,
+    chalk17.bold("  System:"),
+    `    ${chalk17.cyan("daemon")} start|stop|status         Daemon management`,
+    `    ${chalk17.cyan("help")} [command]                   Show help`,
+    `    ${chalk17.cyan("--version")}                        Show version`,
     "",
-    chalk15.bold("  Tips:"),
-    chalk15.gray("    Use 'actant help <command>' for detailed help on a command"),
+    chalk17.bold("  Tips:"),
+    chalk17.gray("    Use 'actant help <command>' for detailed help on a command"),
     ""
   ];
   process.stdout.write(lines.join("\n"));
@@ -1326,13 +1401,13 @@ function showCommandHelp(program, commandName) {
     subcmd.outputHelp();
   } else {
     process.stdout.write(
-      chalk15.red(`Unknown command: ${commandName}
-`) + chalk15.gray("Run 'actant help' to see available commands.\n")
+      chalk17.red(`Unknown command: ${commandName}
+`) + chalk17.gray("Run 'actant help' to see available commands.\n")
     );
   }
 }
 function createHelpCommand() {
-  return new Command24("help").argument("[command]", "Command to get help for").description("Show help information").action(function(command) {
+  return new Command25("help").argument("[command]", "Command to get help for").description("Show help information").action(function(command) {
     const program = this.parent;
     if (command) {
       showCommandHelp(program, command);
@@ -1343,12 +1418,12 @@ function createHelpCommand() {
 }
 
 // src/commands/skill/index.ts
-import { Command as Command30 } from "commander";
+import { Command as Command31 } from "commander";
 
 // src/commands/skill/list.ts
-import { Command as Command25 } from "commander";
+import { Command as Command26 } from "commander";
 function createSkillListCommand(client, printer = defaultPrinter) {
-  return new Command25("list").alias("ls").description("List all loaded skills").option("-f, --format <format>", "Output format: table, json, quiet", "table").action(async (opts) => {
+  return new Command26("list").alias("ls").description("List all loaded skills").option("-f, --format <format>", "Output format: table, json, quiet", "table").action(async (opts) => {
     try {
       const skills = await client.call("skill.list", {});
       printer.log(formatSkillList(skills, opts.format));
@@ -1360,9 +1435,9 @@ function createSkillListCommand(client, printer = defaultPrinter) {
 }
 
 // src/commands/skill/show.ts
-import { Command as Command26 } from "commander";
+import { Command as Command27 } from "commander";
 function createSkillShowCommand(client, printer = defaultPrinter) {
-  return new Command26("show").description("Show skill details").argument("<name>", "Skill name").option("-f, --format <format>", "Output format: table, json, quiet", "table").action(async (name, opts) => {
+  return new Command27("show").description("Show skill details").argument("<name>", "Skill name").option("-f, --format <format>", "Output format: table, json, quiet", "table").action(async (name, opts) => {
     try {
       const skill = await client.call("skill.get", { name });
       printer.log(formatSkillDetail(skill, opts.format));
@@ -1376,9 +1451,9 @@ function createSkillShowCommand(client, printer = defaultPrinter) {
 // src/commands/skill/add.ts
 import { readFile } from "fs/promises";
 import { resolve as resolve4 } from "path";
-import { Command as Command27 } from "commander";
+import { Command as Command28 } from "commander";
 function createSkillAddCommand(client, printer = defaultPrinter) {
-  return new Command27("add").description("Add a skill from a JSON file").argument("<file>", "Path to skill definition JSON file").action(async (file) => {
+  return new Command28("add").description("Add a skill from a JSON file").argument("<file>", "Path to skill definition JSON file").action(async (file) => {
     try {
       const raw = await readFile(resolve4(file), "utf-8");
       const component = JSON.parse(raw);
@@ -1392,9 +1467,9 @@ function createSkillAddCommand(client, printer = defaultPrinter) {
 }
 
 // src/commands/skill/remove.ts
-import { Command as Command28 } from "commander";
+import { Command as Command29 } from "commander";
 function createSkillRemoveCommand(client, printer = defaultPrinter) {
-  return new Command28("remove").alias("rm").description("Remove a loaded skill").argument("<name>", "Skill name").action(async (name) => {
+  return new Command29("remove").alias("rm").description("Remove a loaded skill").argument("<name>", "Skill name").action(async (name) => {
     try {
       const result = await client.call("skill.remove", { name });
       if (result.success) {
@@ -1410,9 +1485,9 @@ function createSkillRemoveCommand(client, printer = defaultPrinter) {
 }
 
 // src/commands/skill/export.ts
-import { Command as Command29 } from "commander";
+import { Command as Command30 } from "commander";
 function createSkillExportCommand(client, printer = defaultPrinter) {
-  return new Command29("export").description("Export a skill to a JSON file").argument("<name>", "Skill name").option("-o, --out <file>", "Output file path", "./{name}.json").action(async (name, opts) => {
+  return new Command30("export").description("Export a skill to a JSON file").argument("<name>", "Skill name").option("-o, --out <file>", "Output file path", "./{name}.json").action(async (name, opts) => {
     try {
       const outPath = opts.out.replace("{name}", name);
       await client.call("skill.export", { name, filePath: outPath });
@@ -1426,7 +1501,7 @@ function createSkillExportCommand(client, printer = defaultPrinter) {
 
 // src/commands/skill/index.ts
 function createSkillCommand(client, printer) {
-  const cmd = new Command30("skill").description("Manage loaded skills");
+  const cmd = new Command31("skill").description("Manage loaded skills");
   cmd.addCommand(createSkillListCommand(client, printer));
   cmd.addCommand(createSkillShowCommand(client, printer));
   cmd.addCommand(createSkillAddCommand(client, printer));
@@ -1436,12 +1511,12 @@ function createSkillCommand(client, printer) {
 }
 
 // src/commands/prompt/index.ts
-import { Command as Command36 } from "commander";
+import { Command as Command37 } from "commander";
 
 // src/commands/prompt/list.ts
-import { Command as Command31 } from "commander";
+import { Command as Command32 } from "commander";
 function createPromptListCommand(client, printer = defaultPrinter) {
-  return new Command31("list").alias("ls").description("List all loaded prompts").option("-f, --format <format>", "Output format: table, json, quiet", "table").action(async (opts) => {
+  return new Command32("list").alias("ls").description("List all loaded prompts").option("-f, --format <format>", "Output format: table, json, quiet", "table").action(async (opts) => {
     try {
       const prompts = await client.call("prompt.list", {});
       printer.log(formatPromptList(prompts, opts.format));
@@ -1453,9 +1528,9 @@ function createPromptListCommand(client, printer = defaultPrinter) {
 }
 
 // src/commands/prompt/show.ts
-import { Command as Command32 } from "commander";
+import { Command as Command33 } from "commander";
 function createPromptShowCommand(client, printer = defaultPrinter) {
-  return new Command32("show").description("Show prompt details").argument("<name>", "Prompt name").option("-f, --format <format>", "Output format: table, json, quiet", "table").action(async (name, opts) => {
+  return new Command33("show").description("Show prompt details").argument("<name>", "Prompt name").option("-f, --format <format>", "Output format: table, json, quiet", "table").action(async (name, opts) => {
     try {
       const prompt = await client.call("prompt.get", { name });
       printer.log(formatPromptDetail(prompt, opts.format));
@@ -1469,9 +1544,9 @@ function createPromptShowCommand(client, printer = defaultPrinter) {
 // src/commands/prompt/add.ts
 import { readFile as readFile2 } from "fs/promises";
 import { resolve as resolve5 } from "path";
-import { Command as Command33 } from "commander";
+import { Command as Command34 } from "commander";
 function createPromptAddCommand(client, printer = defaultPrinter) {
-  return new Command33("add").description("Add a prompt from a JSON file").argument("<file>", "Path to prompt definition JSON file").action(async (file) => {
+  return new Command34("add").description("Add a prompt from a JSON file").argument("<file>", "Path to prompt definition JSON file").action(async (file) => {
     try {
       const raw = await readFile2(resolve5(file), "utf-8");
       const component = JSON.parse(raw);
@@ -1485,9 +1560,9 @@ function createPromptAddCommand(client, printer = defaultPrinter) {
 }
 
 // src/commands/prompt/remove.ts
-import { Command as Command34 } from "commander";
+import { Command as Command35 } from "commander";
 function createPromptRemoveCommand(client, printer = defaultPrinter) {
-  return new Command34("remove").alias("rm").description("Remove a loaded prompt").argument("<name>", "Prompt name").action(async (name) => {
+  return new Command35("remove").alias("rm").description("Remove a loaded prompt").argument("<name>", "Prompt name").action(async (name) => {
     try {
       const result = await client.call("prompt.remove", { name });
       if (result.success) {
@@ -1503,9 +1578,9 @@ function createPromptRemoveCommand(client, printer = defaultPrinter) {
 }
 
 // src/commands/prompt/export.ts
-import { Command as Command35 } from "commander";
+import { Command as Command36 } from "commander";
 function createPromptExportCommand(client, printer = defaultPrinter) {
-  return new Command35("export").description("Export a prompt to a JSON file").argument("<name>", "Prompt name").option("-o, --out <file>", "Output file path", "./{name}.json").action(async (name, opts) => {
+  return new Command36("export").description("Export a prompt to a JSON file").argument("<name>", "Prompt name").option("-o, --out <file>", "Output file path", "./{name}.json").action(async (name, opts) => {
     try {
       const outPath = opts.out.replace("{name}", name);
       await client.call("prompt.export", { name, filePath: outPath });
@@ -1519,7 +1594,7 @@ function createPromptExportCommand(client, printer = defaultPrinter) {
 
 // src/commands/prompt/index.ts
 function createPromptCommand(client, printer) {
-  const cmd = new Command36("prompt").description("Manage loaded prompts");
+  const cmd = new Command37("prompt").description("Manage loaded prompts");
   cmd.addCommand(createPromptListCommand(client, printer));
   cmd.addCommand(createPromptShowCommand(client, printer));
   cmd.addCommand(createPromptAddCommand(client, printer));
@@ -1529,12 +1604,12 @@ function createPromptCommand(client, printer) {
 }
 
 // src/commands/mcp/index.ts
-import { Command as Command42 } from "commander";
+import { Command as Command43 } from "commander";
 
 // src/commands/mcp/list.ts
-import { Command as Command37 } from "commander";
+import { Command as Command38 } from "commander";
 function createMcpListCommand(client, printer = defaultPrinter) {
-  return new Command37("list").alias("ls").description("List all loaded MCP server configs").option("-f, --format <format>", "Output format: table, json, quiet", "table").action(async (opts) => {
+  return new Command38("list").alias("ls").description("List all loaded MCP server configs").option("-f, --format <format>", "Output format: table, json, quiet", "table").action(async (opts) => {
     try {
       const servers = await client.call("mcp.list", {});
       printer.log(formatMcpList(servers, opts.format));
@@ -1546,9 +1621,9 @@ function createMcpListCommand(client, printer = defaultPrinter) {
 }
 
 // src/commands/mcp/show.ts
-import { Command as Command38 } from "commander";
+import { Command as Command39 } from "commander";
 function createMcpShowCommand(client, printer = defaultPrinter) {
-  return new Command38("show").description("Show MCP server config details").argument("<name>", "MCP server name").option("-f, --format <format>", "Output format: table, json, quiet", "table").action(async (name, opts) => {
+  return new Command39("show").description("Show MCP server config details").argument("<name>", "MCP server name").option("-f, --format <format>", "Output format: table, json, quiet", "table").action(async (name, opts) => {
     try {
       const server = await client.call("mcp.get", { name });
       printer.log(formatMcpDetail(server, opts.format));
@@ -1562,9 +1637,9 @@ function createMcpShowCommand(client, printer = defaultPrinter) {
 // src/commands/mcp/add.ts
 import { readFile as readFile3 } from "fs/promises";
 import { resolve as resolve6 } from "path";
-import { Command as Command39 } from "commander";
+import { Command as Command40 } from "commander";
 function createMcpAddCommand(client, printer = defaultPrinter) {
-  return new Command39("add").description("Add an MCP server config from a JSON file").argument("<file>", "Path to MCP server definition JSON file").action(async (file) => {
+  return new Command40("add").description("Add an MCP server config from a JSON file").argument("<file>", "Path to MCP server definition JSON file").action(async (file) => {
     try {
       const raw = await readFile3(resolve6(file), "utf-8");
       const component = JSON.parse(raw);
@@ -1578,9 +1653,9 @@ function createMcpAddCommand(client, printer = defaultPrinter) {
 }
 
 // src/commands/mcp/remove.ts
-import { Command as Command40 } from "commander";
+import { Command as Command41 } from "commander";
 function createMcpRemoveCommand(client, printer = defaultPrinter) {
-  return new Command40("remove").alias("rm").description("Remove a loaded MCP server config").argument("<name>", "MCP server name").action(async (name) => {
+  return new Command41("remove").alias("rm").description("Remove a loaded MCP server config").argument("<name>", "MCP server name").action(async (name) => {
     try {
       const result = await client.call("mcp.remove", { name });
       if (result.success) {
@@ -1596,9 +1671,9 @@ function createMcpRemoveCommand(client, printer = defaultPrinter) {
 }
 
 // src/commands/mcp/export.ts
-import { Command as Command41 } from "commander";
+import { Command as Command42 } from "commander";
 function createMcpExportCommand(client, printer = defaultPrinter) {
-  return new Command41("export").description("Export an MCP server config to a JSON file").argument("<name>", "MCP server name").option("-o, --out <file>", "Output file path", "./{name}.json").action(async (name, opts) => {
+  return new Command42("export").description("Export an MCP server config to a JSON file").argument("<name>", "MCP server name").option("-o, --out <file>", "Output file path", "./{name}.json").action(async (name, opts) => {
     try {
       const outPath = opts.out.replace("{name}", name);
       await client.call("mcp.export", { name, filePath: outPath });
@@ -1612,7 +1687,7 @@ function createMcpExportCommand(client, printer = defaultPrinter) {
 
 // src/commands/mcp/index.ts
 function createMcpCommand(client, printer) {
-  const cmd = new Command42("mcp").description("Manage loaded MCP server configs");
+  const cmd = new Command43("mcp").description("Manage loaded MCP server configs");
   cmd.addCommand(createMcpListCommand(client, printer));
   cmd.addCommand(createMcpShowCommand(client, printer));
   cmd.addCommand(createMcpAddCommand(client, printer));
@@ -1622,12 +1697,12 @@ function createMcpCommand(client, printer) {
 }
 
 // src/commands/workflow/index.ts
-import { Command as Command48 } from "commander";
+import { Command as Command49 } from "commander";
 
 // src/commands/workflow/list.ts
-import { Command as Command43 } from "commander";
+import { Command as Command44 } from "commander";
 function createWorkflowListCommand(client, printer = defaultPrinter) {
-  return new Command43("list").alias("ls").description("List all loaded workflows").option("-f, --format <format>", "Output format: table, json, quiet", "table").action(async (opts) => {
+  return new Command44("list").alias("ls").description("List all loaded workflows").option("-f, --format <format>", "Output format: table, json, quiet", "table").action(async (opts) => {
     try {
       const workflows = await client.call("workflow.list", {});
       printer.log(formatWorkflowList(workflows, opts.format));
@@ -1639,9 +1714,9 @@ function createWorkflowListCommand(client, printer = defaultPrinter) {
 }
 
 // src/commands/workflow/show.ts
-import { Command as Command44 } from "commander";
+import { Command as Command45 } from "commander";
 function createWorkflowShowCommand(client, printer = defaultPrinter) {
-  return new Command44("show").description("Show workflow details").argument("<name>", "Workflow name").option("-f, --format <format>", "Output format: table, json, quiet", "table").action(async (name, opts) => {
+  return new Command45("show").description("Show workflow details").argument("<name>", "Workflow name").option("-f, --format <format>", "Output format: table, json, quiet", "table").action(async (name, opts) => {
     try {
       const workflow = await client.call("workflow.get", { name });
       printer.log(formatWorkflowDetail(workflow, opts.format));
@@ -1655,9 +1730,9 @@ function createWorkflowShowCommand(client, printer = defaultPrinter) {
 // src/commands/workflow/add.ts
 import { readFile as readFile4 } from "fs/promises";
 import { resolve as resolve7 } from "path";
-import { Command as Command45 } from "commander";
+import { Command as Command46 } from "commander";
 function createWorkflowAddCommand(client, printer = defaultPrinter) {
-  return new Command45("add").description("Add a workflow from a JSON file").argument("<file>", "Path to workflow definition JSON file").action(async (file) => {
+  return new Command46("add").description("Add a workflow from a JSON file").argument("<file>", "Path to workflow definition JSON file").action(async (file) => {
     try {
       const raw = await readFile4(resolve7(file), "utf-8");
       const component = JSON.parse(raw);
@@ -1671,9 +1746,9 @@ function createWorkflowAddCommand(client, printer = defaultPrinter) {
 }
 
 // src/commands/workflow/remove.ts
-import { Command as Command46 } from "commander";
+import { Command as Command47 } from "commander";
 function createWorkflowRemoveCommand(client, printer = defaultPrinter) {
-  return new Command46("remove").alias("rm").description("Remove a loaded workflow").argument("<name>", "Workflow name").action(async (name) => {
+  return new Command47("remove").alias("rm").description("Remove a loaded workflow").argument("<name>", "Workflow name").action(async (name) => {
     try {
       const result = await client.call("workflow.remove", { name });
       if (result.success) {
@@ -1689,9 +1764,9 @@ function createWorkflowRemoveCommand(client, printer = defaultPrinter) {
 }
 
 // src/commands/workflow/export.ts
-import { Command as Command47 } from "commander";
+import { Command as Command48 } from "commander";
 function createWorkflowExportCommand(client, printer = defaultPrinter) {
-  return new Command47("export").description("Export a workflow to a JSON file").argument("<name>", "Workflow name").option("-o, --out <file>", "Output file path", "./{name}.json").action(async (name, opts) => {
+  return new Command48("export").description("Export a workflow to a JSON file").argument("<name>", "Workflow name").option("-o, --out <file>", "Output file path", "./{name}.json").action(async (name, opts) => {
     try {
       const outPath = opts.out.replace("{name}", name);
       await client.call("workflow.export", { name, filePath: outPath });
@@ -1705,7 +1780,7 @@ function createWorkflowExportCommand(client, printer = defaultPrinter) {
 
 // src/commands/workflow/index.ts
 function createWorkflowCommand(client, printer) {
-  const cmd = new Command48("workflow").description("Manage loaded workflows");
+  const cmd = new Command49("workflow").description("Manage loaded workflows");
   cmd.addCommand(createWorkflowListCommand(client, printer));
   cmd.addCommand(createWorkflowShowCommand(client, printer));
   cmd.addCommand(createWorkflowAddCommand(client, printer));
@@ -1715,12 +1790,12 @@ function createWorkflowCommand(client, printer) {
 }
 
 // src/commands/plugin/index.ts
-import { Command as Command54 } from "commander";
+import { Command as Command55 } from "commander";
 
 // src/commands/plugin/list.ts
-import { Command as Command49 } from "commander";
+import { Command as Command50 } from "commander";
 function createPluginListCommand(client, printer = defaultPrinter) {
-  return new Command49("list").alias("ls").description("List all plugins").option("-f, --format <format>", "Output format: table, json, quiet", "table").action(async (opts) => {
+  return new Command50("list").alias("ls").description("List all plugins").option("-f, --format <format>", "Output format: table, json, quiet", "table").action(async (opts) => {
     try {
       const plugins = await client.call("plugin.list", {});
       printer.log(formatPluginList(plugins, opts.format));
@@ -1732,9 +1807,9 @@ function createPluginListCommand(client, printer = defaultPrinter) {
 }
 
 // src/commands/plugin/show.ts
-import { Command as Command50 } from "commander";
+import { Command as Command51 } from "commander";
 function createPluginShowCommand(client, printer = defaultPrinter) {
-  return new Command50("show").description("Show plugin details").argument("<name>", "Plugin name").option("-f, --format <format>", "Output format: table, json, quiet", "table").action(async (name, opts) => {
+  return new Command51("show").description("Show plugin details").argument("<name>", "Plugin name").option("-f, --format <format>", "Output format: table, json, quiet", "table").action(async (name, opts) => {
     try {
       const plugin = await client.call("plugin.get", { name });
       printer.log(formatPluginDetail(plugin, opts.format));
@@ -1748,9 +1823,9 @@ function createPluginShowCommand(client, printer = defaultPrinter) {
 // src/commands/plugin/add.ts
 import { readFile as readFile5 } from "fs/promises";
 import { resolve as resolve8 } from "path";
-import { Command as Command51 } from "commander";
+import { Command as Command52 } from "commander";
 function createPluginAddCommand(client, printer = defaultPrinter) {
-  return new Command51("add").description("Add a plugin from a JSON file").argument("<file>", "Path to plugin definition JSON file").action(async (file) => {
+  return new Command52("add").description("Add a plugin from a JSON file").argument("<file>", "Path to plugin definition JSON file").action(async (file) => {
     try {
       const raw = await readFile5(resolve8(file), "utf-8");
       const component = JSON.parse(raw);
@@ -1764,9 +1839,9 @@ function createPluginAddCommand(client, printer = defaultPrinter) {
 }
 
 // src/commands/plugin/remove.ts
-import { Command as Command52 } from "commander";
+import { Command as Command53 } from "commander";
 function createPluginRemoveCommand(client, printer = defaultPrinter) {
-  return new Command52("remove").alias("rm").description("Remove a loaded plugin").argument("<name>", "Plugin name").action(async (name) => {
+  return new Command53("remove").alias("rm").description("Remove a loaded plugin").argument("<name>", "Plugin name").action(async (name) => {
     try {
       const result = await client.call("plugin.remove", { name });
       if (result.success) {
@@ -1782,9 +1857,9 @@ function createPluginRemoveCommand(client, printer = defaultPrinter) {
 }
 
 // src/commands/plugin/export.ts
-import { Command as Command53 } from "commander";
+import { Command as Command54 } from "commander";
 function createPluginExportCommand(client, printer = defaultPrinter) {
-  return new Command53("export").description("Export a plugin to a JSON file").argument("<name>", "Plugin name").option("-o, --out <file>", "Output file path", "./{name}.json").action(async (name, opts) => {
+  return new Command54("export").description("Export a plugin to a JSON file").argument("<name>", "Plugin name").option("-o, --out <file>", "Output file path", "./{name}.json").action(async (name, opts) => {
     try {
       const outPath = opts.out.replace("{name}", name);
       await client.call("plugin.export", { name, filePath: outPath });
@@ -1798,7 +1873,7 @@ function createPluginExportCommand(client, printer = defaultPrinter) {
 
 // src/commands/plugin/index.ts
 function createPluginCommand(client, printer) {
-  const cmd = new Command54("plugin").description("Manage loaded plugins");
+  const cmd = new Command55("plugin").description("Manage loaded plugins");
   cmd.addCommand(createPluginListCommand(client, printer));
   cmd.addCommand(createPluginShowCommand(client, printer));
   cmd.addCommand(createPluginAddCommand(client, printer));
@@ -1808,12 +1883,12 @@ function createPluginCommand(client, printer) {
 }
 
 // src/commands/source/index.ts
-import { Command as Command59 } from "commander";
+import { Command as Command60 } from "commander";
 
 // src/commands/source/list.ts
-import { Command as Command55 } from "commander";
+import { Command as Command56 } from "commander";
 function createSourceListCommand(client, printer = defaultPrinter) {
-  return new Command55("list").alias("ls").description("List registered component sources").option("-f, --format <format>", "Output format: table, json, quiet", "table").action(async (opts) => {
+  return new Command56("list").alias("ls").description("List registered component sources").option("-f, --format <format>", "Output format: table, json, quiet", "table").action(async (opts) => {
     try {
       const sources = await client.call("source.list", {});
       if (opts.format === "json") {
@@ -1839,9 +1914,9 @@ function createSourceListCommand(client, printer = defaultPrinter) {
 }
 
 // src/commands/source/add.ts
-import { Command as Command56 } from "commander";
+import { Command as Command57 } from "commander";
 function createSourceAddCommand(client, printer = defaultPrinter) {
-  return new Command56("add").description("Register a component source").argument("<url-or-path>", "GitHub URL or local directory path").requiredOption("--name <name>", "Package name (namespace prefix)").option("--type <type>", "Source type: github, local", "github").option("--branch <branch>", "Git branch (for github type)", "main").action(async (urlOrPath, opts) => {
+  return new Command57("add").description("Register a component source").argument("<url-or-path>", "GitHub URL or local directory path").requiredOption("--name <name>", "Package name (namespace prefix)").option("--type <type>", "Source type: github, local", "github").option("--branch <branch>", "Git branch (for github type)", "main").action(async (urlOrPath, opts) => {
     try {
       const config = opts.type === "local" ? { type: "local", path: urlOrPath } : { type: "github", url: urlOrPath, branch: opts.branch };
       const result = await client.call("source.add", { name: opts.name, config });
@@ -1857,9 +1932,9 @@ function createSourceAddCommand(client, printer = defaultPrinter) {
 }
 
 // src/commands/source/remove.ts
-import { Command as Command57 } from "commander";
+import { Command as Command58 } from "commander";
 function createSourceRemoveCommand(client, printer = defaultPrinter) {
-  return new Command57("remove").alias("rm").description("Remove a registered source").argument("<name>", "Source name").action(async (name) => {
+  return new Command58("remove").alias("rm").description("Remove a registered source").argument("<name>", "Source name").action(async (name) => {
     try {
       const result = await client.call("source.remove", { name });
       if (result.success) {
@@ -1875,19 +1950,19 @@ function createSourceRemoveCommand(client, printer = defaultPrinter) {
 }
 
 // src/commands/source/sync.ts
-import chalk16 from "chalk";
-import { Command as Command58 } from "commander";
+import chalk18 from "chalk";
+import { Command as Command59 } from "commander";
 function createSourceSyncCommand(client, printer = defaultPrinter) {
-  return new Command58("sync").description("Sync component source(s)").argument("[name]", "Source name (syncs all if omitted)").action(async (name) => {
+  return new Command59("sync").description("Sync component source(s)").argument("[name]", "Source name (syncs all if omitted)").action(async (name) => {
     try {
       const result = await client.call("source.sync", { name });
       printer.success(`Synced: ${result.synced.join(", ")}`);
       const report = result.report;
       if (report) {
         const parts = [];
-        if (report.addedCount > 0) parts.push(chalk16.green(`+${report.addedCount} added`));
-        if (report.updatedCount > 0) parts.push(chalk16.yellow(`${report.updatedCount} updated`));
-        if (report.removedCount > 0) parts.push(chalk16.red(`-${report.removedCount} removed`));
+        if (report.addedCount > 0) parts.push(chalk18.green(`+${report.addedCount} added`));
+        if (report.updatedCount > 0) parts.push(chalk18.yellow(`${report.updatedCount} updated`));
+        if (report.removedCount > 0) parts.push(chalk18.red(`-${report.removedCount} removed`));
         if (parts.length > 0) {
           printer.log(`  ${parts.join(", ")}`);
         }
@@ -1904,7 +1979,7 @@ function createSourceSyncCommand(client, printer = defaultPrinter) {
 
 // src/commands/source/index.ts
 function createSourceCommand(client, printer) {
-  const cmd = new Command59("source").description("Manage component sources (GitHub repos, local dirs)");
+  const cmd = new Command60("source").description("Manage component sources (GitHub repos, local dirs)");
   cmd.addCommand(createSourceListCommand(client, printer));
   cmd.addCommand(createSourceAddCommand(client, printer));
   cmd.addCommand(createSourceRemoveCommand(client, printer));
@@ -1913,12 +1988,12 @@ function createSourceCommand(client, printer) {
 }
 
 // src/commands/preset/index.ts
-import { Command as Command63 } from "commander";
+import { Command as Command64 } from "commander";
 
 // src/commands/preset/list.ts
-import { Command as Command60 } from "commander";
+import { Command as Command61 } from "commander";
 function createPresetListCommand(client, printer = defaultPrinter) {
-  return new Command60("list").alias("ls").description("List available presets from registered sources").argument("[package]", "Filter by source package name").option("-f, --format <format>", "Output format: table, json, quiet", "table").action(async (packageName, opts) => {
+  return new Command61("list").alias("ls").description("List available presets from registered sources").argument("[package]", "Filter by source package name").option("-f, --format <format>", "Output format: table, json, quiet", "table").action(async (packageName, opts) => {
     try {
       const presets = await client.call("preset.list", { packageName });
       if (opts.format === "json") {
@@ -1943,9 +2018,9 @@ function createPresetListCommand(client, printer = defaultPrinter) {
 }
 
 // src/commands/preset/show.ts
-import { Command as Command61 } from "commander";
+import { Command as Command62 } from "commander";
 function createPresetShowCommand(client, printer = defaultPrinter) {
-  return new Command61("show").description("Show preset details").argument("<qualified-name>", "Preset qualified name (package@preset)").option("-f, --format <format>", "Output format: table, json", "table").action(async (qualifiedName, opts) => {
+  return new Command62("show").description("Show preset details").argument("<qualified-name>", "Preset qualified name (package@preset)").option("-f, --format <format>", "Output format: table, json", "table").action(async (qualifiedName, opts) => {
     try {
       const preset = await client.call("preset.show", { qualifiedName });
       if (opts.format === "json") {
@@ -1966,9 +2041,9 @@ function createPresetShowCommand(client, printer = defaultPrinter) {
 }
 
 // src/commands/preset/apply.ts
-import { Command as Command62 } from "commander";
+import { Command as Command63 } from "commander";
 function createPresetApplyCommand(client, printer = defaultPrinter) {
-  return new Command62("apply").description("Apply a preset to a template (adds all preset components)").argument("<qualified-name>", "Preset qualified name (package@preset)").argument("<template>", "Template name to apply to").action(async (qualifiedName, templateName) => {
+  return new Command63("apply").description("Apply a preset to a template (adds all preset components)").argument("<qualified-name>", "Preset qualified name (package@preset)").argument("<template>", "Template name to apply to").action(async (qualifiedName, templateName) => {
     try {
       const result = await client.call("preset.apply", { qualifiedName, templateName });
       printer.success(`Preset "${qualifiedName}" applied to template "${result.name}".`);
@@ -1981,7 +2056,7 @@ function createPresetApplyCommand(client, printer = defaultPrinter) {
 
 // src/commands/preset/index.ts
 function createPresetCommand(client, printer) {
-  const cmd = new Command63("preset").description("Manage component presets (bundled compositions)");
+  const cmd = new Command64("preset").description("Manage component presets (bundled compositions)");
   cmd.addCommand(createPresetListCommand(client, printer));
   cmd.addCommand(createPresetShowCommand(client, printer));
   cmd.addCommand(createPresetApplyCommand(client, printer));
@@ -1989,12 +2064,12 @@ function createPresetCommand(client, printer) {
 }
 
 // src/commands/schedule/index.ts
-import { Command as Command65 } from "commander";
+import { Command as Command66 } from "commander";
 
 // src/commands/schedule/list.ts
-import { Command as Command64 } from "commander";
+import { Command as Command65 } from "commander";
 function createScheduleListCommand(client, printer = defaultPrinter) {
-  return new Command64("list").alias("ls").description("List schedule sources for an agent").argument("<name>", "Agent name").option("-f, --format <format>", "Output format: table, json", "table").action(async (name, opts) => {
+  return new Command65("list").alias("ls").description("List schedule sources for an agent").argument("<name>", "Agent name").option("-f, --format <format>", "Output format: table, json", "table").action(async (name, opts) => {
     try {
       const result = await client.call("schedule.list", { name });
       if (opts.format === "json") {
@@ -2018,31 +2093,31 @@ function createScheduleListCommand(client, printer = defaultPrinter) {
 
 // src/commands/schedule/index.ts
 function createScheduleCommand(client, printer) {
-  const cmd = new Command65("schedule").description("Manage agent schedules (heartbeat, cron, hooks)");
+  const cmd = new Command66("schedule").description("Manage agent schedules (heartbeat, cron, hooks)");
   cmd.addCommand(createScheduleListCommand(client, printer));
   return cmd;
 }
 
 // src/commands/daemon/index.ts
-import { Command as Command69 } from "commander";
+import { Command as Command70 } from "commander";
 
 // src/commands/daemon/start.ts
-import { Command as Command66 } from "commander";
+import { Command as Command67 } from "commander";
 import { join } from "path";
-import { fork, spawn } from "child_process";
-import chalk17 from "chalk";
+import { fork, spawn as spawn2 } from "child_process";
+import chalk19 from "chalk";
 import { onShutdownSignal, isWindows, isSingleExecutable } from "@actant/shared";
 var SEA_DAEMON_FLAG = "--__actant-daemon";
 function spawnDaemonChild() {
   if (isSingleExecutable()) {
-    return spawn(process.execPath, [SEA_DAEMON_FLAG], {
+    return spawn2(process.execPath, [SEA_DAEMON_FLAG], {
       detached: true,
       stdio: ["ignore", "ignore", "pipe"],
       env: process.env
     });
   }
   const daemonScript = join(import.meta.dirname, "daemon-entry.js");
-  return isWindows() ? spawn(process.execPath, [daemonScript], {
+  return isWindows() ? spawn2(process.execPath, [daemonScript], {
     detached: true,
     stdio: ["ignore", "ignore", "pipe"],
     env: process.env
@@ -2053,7 +2128,7 @@ function spawnDaemonChild() {
   });
 }
 function createDaemonStartCommand(printer = defaultPrinter) {
-  return new Command66("start").description("Start the Actant daemon").option("--foreground", "Run in foreground (don't daemonize)", false).action(async (opts) => {
+  return new Command67("start").description("Start the Actant daemon").option("--foreground", "Run in foreground (don't daemonize)", false).action(async (opts) => {
     const client = new RpcClient(defaultSocketPath());
     const alive = await client.ping();
     if (alive) {
@@ -2069,7 +2144,7 @@ function createDaemonStartCommand(printer = defaultPrinter) {
           process.exit(0);
         });
         await daemon.start();
-        printer.log(`${chalk17.green("Daemon started (foreground).")} PID: ${process.pid}`);
+        printer.log(`${chalk19.green("Daemon started (foreground).")} PID: ${process.pid}`);
         printer.dim("Press Ctrl+C to stop.");
         await new Promise(() => {
         });
@@ -2107,7 +2182,7 @@ function createDaemonStartCommand(printer = defaultPrinter) {
       if ("connected" in child && child.connected) child.disconnect();
       child.unref();
       if (healthy) {
-        printer.log(`${chalk17.green("Daemon started.")} PID: ${child.pid}`);
+        printer.log(`${chalk19.green("Daemon started.")} PID: ${child.pid}`);
       } else {
         const stderr = Buffer.concat(stderrChunks).toString().trim();
         printer.error("Daemon process started but is not responding.");
@@ -2119,9 +2194,9 @@ function createDaemonStartCommand(printer = defaultPrinter) {
 }
 
 // src/commands/daemon/stop.ts
-import { Command as Command67 } from "commander";
+import { Command as Command68 } from "commander";
 function createDaemonStopCommand(printer = defaultPrinter, client) {
-  return new Command67("stop").description("Stop the Actant daemon").action(async () => {
+  return new Command68("stop").description("Stop the Actant daemon").action(async () => {
     const rpc = client ?? new RpcClient(defaultSocketPath());
     try {
       await rpc.call("daemon.shutdown", {});
@@ -2133,10 +2208,10 @@ function createDaemonStopCommand(printer = defaultPrinter, client) {
 }
 
 // src/commands/daemon/status.ts
-import { Command as Command68 } from "commander";
-import chalk18 from "chalk";
+import { Command as Command69 } from "commander";
+import chalk20 from "chalk";
 function createDaemonStatusCommand(printer = defaultPrinter) {
-  return new Command68("status").description("Check if the daemon is running").option("-f, --format <format>", "Output format: table, json, quiet", "table").action(async (opts) => {
+  return new Command69("status").description("Check if the daemon is running").option("-f, --format <format>", "Output format: table, json, quiet", "table").action(async (opts) => {
     const client = new RpcClient(defaultSocketPath());
     try {
       const result = await client.call("daemon.ping", {});
@@ -2156,7 +2231,7 @@ function createDaemonStatusCommand(printer = defaultPrinter) {
       } else if (opts.format === "quiet") {
         printer.log("stopped");
       } else {
-        printer.log(chalk18.red("Daemon is not running."));
+        printer.log(chalk20.red("Daemon is not running."));
         printer.dim("Start with: actant daemon start");
       }
       process.exitCode = 1;
@@ -2166,7 +2241,7 @@ function createDaemonStatusCommand(printer = defaultPrinter) {
 
 // src/commands/daemon/index.ts
 function createDaemonCommand(printer) {
-  const cmd = new Command69("daemon").description("Manage the Actant daemon");
+  const cmd = new Command70("daemon").description("Manage the Actant daemon");
   cmd.addCommand(createDaemonStartCommand(printer));
   cmd.addCommand(createDaemonStopCommand(printer));
   cmd.addCommand(createDaemonStatusCommand(printer));
@@ -2174,11 +2249,11 @@ function createDaemonCommand(printer) {
 }
 
 // src/commands/proxy.ts
-import { Command as Command70 } from "commander";
-import { spawn as spawn2 } from "child_process";
+import { Command as Command71 } from "commander";
+import { spawn as spawn3 } from "child_process";
 import { createInterface as createInterface3 } from "readline";
 function createProxyCommand(printer = defaultPrinter) {
-  return new Command70("proxy").description("Run an ACP proxy for an agent (stdin/stdout ACP protocol)").argument("<name>", "Agent name to proxy").option("--lease", "Use Session Lease mode (requires running agent)", false).option("-t, --template <template>", "Template name (auto-creates instance if not found)").action(async (name, opts) => {
+  return new Command71("proxy").description("Run an ACP proxy for an agent (stdin/stdout ACP protocol)").argument("<name>", "Agent name to proxy").option("--lease", "Use Session Lease mode (requires running agent)", false).option("-t, --template <template>", "Template name (auto-creates instance if not found)").action(async (name, opts) => {
     if (opts.lease) {
       await runSessionLease(name, printer);
     } else {
@@ -2243,7 +2318,7 @@ async function runDirectBridge(name, opts, printer) {
     const command = targetInstance.command;
     const args = targetInstance.args;
     const env = { ...process.env, ...targetInstance.env };
-    child = spawn2(command, args, {
+    child = spawn3(command, args, {
       cwd: workspaceDir,
       stdio: ["pipe", "pipe", "pipe"],
       env
@@ -2496,14 +2571,14 @@ function writeAcpError(id, code, message) {
 }
 
 // src/commands/self-update.ts
-import { Command as Command71 } from "commander";
-import { spawn as spawn3 } from "child_process";
+import { Command as Command72 } from "commander";
+import { spawn as spawn4 } from "child_process";
 import { writeFileSync, mkdirSync, readFileSync, existsSync as existsSync2 } from "fs";
 import { join as join2 } from "path";
 import { homedir } from "os";
-import chalk19 from "chalk";
+import chalk21 from "chalk";
 function createSelfUpdateCommand() {
-  return new Command71("self-update").description("Update Actant from local source").option("--source <path>", "Source directory path").option("--check", "Only check for updates, don't apply").option("--force", "Skip active session warnings").option("--dry-run", "Show what would be done without doing it").option("--no-agent", "Skip agent supervisor, run script directly").option("--skip-build", "Skip build step (use pre-built dist)").action(async (opts) => {
+  return new Command72("self-update").description("Update Actant from local source").option("--source <path>", "Source directory path").option("--check", "Only check for updates, don't apply").option("--force", "Skip active session warnings").option("--dry-run", "Show what would be done without doing it").option("--no-agent", "Skip agent supervisor, run script directly").option("--skip-build", "Skip build step (use pre-built dist)").action(async (opts) => {
     const actantHome = process.env.ACTANT_HOME || join2(homedir(), ".actant");
     let devSourcePath = opts.source;
     if (!devSourcePath) {
@@ -2516,7 +2591,7 @@ function createSelfUpdateCommand() {
     }
     if (!devSourcePath) {
       console.error(
-        chalk19.red(
+        chalk21.red(
           "No source path specified. Use --source <path> or set devSourcePath in ~/.actant/config.json"
         )
       );
@@ -2551,37 +2626,37 @@ function createSelfUpdateCommand() {
     };
     mkdirSync(actantHome, { recursive: true });
     writeFileSync(manifestPath, JSON.stringify(manifest, null, 2));
-    console.log(chalk19.cyan("=== Actant Self-Update ==="));
+    console.log(chalk21.cyan("=== Actant Self-Update ==="));
     console.log(`Update ID: ${updateId}`);
     console.log(`Source: ${devSourcePath}`);
     const scriptPath = join2(devSourcePath, "scripts", "self-update.js");
     const scriptArgs = ["--manifest", manifestPath];
     if (opts.dryRun) scriptArgs.push("--dry-run");
     if (opts.skipBuild) scriptArgs.push("--skip-build");
-    console.log(chalk19.gray(`Spawning: node ${scriptPath} ${scriptArgs.join(" ")}`));
-    const child = spawn3("node", [scriptPath, ...scriptArgs], {
+    console.log(chalk21.gray(`Spawning: node ${scriptPath} ${scriptArgs.join(" ")}`));
+    const child = spawn4("node", [scriptPath, ...scriptArgs], {
       detached: !opts.noAgent,
       stdio: opts.noAgent ? "inherit" : "ignore"
     });
     if (!opts.noAgent) {
       child.unref();
-      console.log(chalk19.green("Update script spawned in background. Check logs at:"));
-      console.log(chalk19.gray(`  ${join2(actantHome, "logs", `update-${updateId}.log`)}`));
+      console.log(chalk21.green("Update script spawned in background. Check logs at:"));
+      console.log(chalk21.gray(`  ${join2(actantHome, "logs", `update-${updateId}.log`)}`));
     } else {
       child.on("exit", (code) => {
         if (code === 0) {
-          console.log(chalk19.green("\nUpdate completed successfully!"));
+          console.log(chalk21.green("\nUpdate completed successfully!"));
         } else if (code === 1) {
-          console.log(chalk19.yellow("\nUpdate failed, rolled back to previous version."));
+          console.log(chalk21.yellow("\nUpdate failed, rolled back to previous version."));
         } else {
-          console.log(chalk19.red("\nSevere failure \u2014 manual intervention may be needed."));
+          console.log(chalk21.red("\nSevere failure \u2014 manual intervention may be needed."));
         }
       });
     }
   });
 }
 function showVersionCheck(sourcePath, actantHome) {
-  console.log(chalk19.cyan("=== Version Check ==="));
+  console.log(chalk21.cyan("=== Version Check ==="));
   try {
     const pkg = JSON.parse(readFileSync(join2(sourcePath, "package.json"), "utf-8"));
     console.log(`Source version: ${pkg.version || "unknown"}`);
@@ -2597,14 +2672,790 @@ function showVersionCheck(sourcePath, actantHome) {
   }
 }
 
+// src/commands/setup/setup.ts
+import { Command as Command73 } from "commander";
+import chalk29 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 chalk22 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(`
+${chalk22.cyan("[ Step 1/7 ]")} ${chalk22.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):
+  ${chalk22.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 chalk23 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(`
+${chalk23.cyan("[ Step 2/7 ]")} ${chalk23.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(chalk23.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 ${chalk23.cyan(apiKeyEnvName)} \u5DF2\u8BBE\u7F6E:
+  ${chalk23.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 chalk24 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(`
+${chalk24.cyan("[ Step 3/7 ]")} ${chalk24.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(chalk24.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 chalk25 from "chalk";
+async function materializeAgent(printer, client) {
+  printer.log(`
+${chalk25.cyan("[ Step 4/7 ]")} ${chalk25.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(chalk25.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 chalk26 from "chalk";
+import { isWindows as isWindows2 } from "@actant/shared";
+async function configureAutostart(printer) {
+  printer.log(`
+${chalk26.cyan("[ Step 5/7 ]")} ${chalk26.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: ${chalk26.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(chalk26.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(chalk26.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(chalk26.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 chalk27 from "chalk";
+async function helloWorld(printer, client, createdAgents) {
+  printer.log(`
+${chalk27.cyan("[ Step 6/7 ]")} ${chalk27.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(chalk27.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(chalk27.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 chalk28 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(`
+${chalk28.cyan("[ Step 7/7 ]")} ${chalk28.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(`    ${chalk28.cyan("actant self-update")}          \u4ECE\u6E90\u7801\u6784\u5EFA\u5E76\u66F4\u65B0`);
+  printer.dim(`    ${chalk28.cyan("actant self-update --check")}  \u68C0\u67E5\u7248\u672C\u5DEE\u5F02`);
+  printer.dim(`    ${chalk28.cyan("npm install -g @actant/cli")} \u4ECE npm \u66F4\u65B0`);
+}
+
+// src/commands/setup/setup.ts
+function createSetupCommand(printer = defaultPrinter) {
+  return new Command73("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(chalk29.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(chalk29.dim("\n  \u5DF2\u53D6\u6D88\u8BBE\u7F6E\u5411\u5BFC"));
+        return;
+      }
+      presentError(err, printer);
+      process.exitCode = 1;
+    }
+  });
+}
+function printBanner(printer) {
+  printer.log("");
+  printer.log(chalk29.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(chalk29.cyan("\u2551") + chalk29.bold("   Actant Setup Wizard                       ") + chalk29.cyan("\u2551"));
+  printer.log(chalk29.cyan("\u2551") + chalk29.dim("   Build, manage, and compose AI agents       ") + chalk29.cyan("\u2551"));
+  printer.log(chalk29.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(chalk29.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(chalk29.green.bold("  Setup Complete!"));
+  printer.log(chalk29.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(`    ${chalk29.cyan("actant daemon start")}     \u542F\u52A8 Daemon`);
+  printer.log(`    ${chalk29.cyan("actant template list")}    \u6D4F\u89C8\u6A21\u677F`);
+  printer.log(`    ${chalk29.cyan("actant agent list")}       \u67E5\u770B Agent`);
+  printer.log(`    ${chalk29.cyan("actant agent chat <n>")}   \u4E0E Agent \u5BF9\u8BDD`);
+  printer.log(`    ${chalk29.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: spawn5 } = await import("child_process");
+    const { join: join8 } = await import("path");
+    const { isWindows: isWindows3, isSingleExecutable: isSingleExecutable2 } = await import("@actant/shared");
+    let child;
+    if (isSingleExecutable2()) {
+      child = spawn5(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() ? spawn5(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 Command74("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 +3470,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 +3483,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-ZVBJSFT5.js");
       await startRepl(client, sock);
       return;
     }
@@ -2660,4 +3512,4 @@ export {
   createProgram,
   run
 };
-//# sourceMappingURL=chunk-2FKBVXMH.js.map
+//# sourceMappingURL=chunk-664FYMDI.js.map