autohand-cli 0.6.0 → 0.6.2

package/dist/chunk-X7EWON4T.js

@@ -0,0 +1,105 @@
+import {
+  AUTOHAND_PATHS
+} from "./chunk-SN7D2PJO.js";
+
+// src/commands/agents-new.ts
+import path from "path";
+import fs from "fs-extra";
+import chalk from "chalk";
+import enquirer from "enquirer";
+var metadata = {
+  command: "/agents new",
+  description: "create a new sub-agent from a description",
+  implemented: true,
+  prd: "prd/sub_agents_architecture.md"
+};
+async function createAgent(ctx) {
+  const answers = await enquirer.prompt([
+    {
+      type: "input",
+      name: "name",
+      message: "Agent name (e.g., Researcher, QA Tester)",
+      validate: (val) => typeof val === "string" && val.trim() ? true : "Name is required"
+    },
+    {
+      type: "input",
+      name: "description",
+      message: "Briefly describe what the agent should do"
+    }
+  ]);
+  const name = answers.name.trim();
+  const description = answers.description.trim();
+  if (!name) {
+    console.log(chalk.gray("Canceled: no name provided."));
+    return null;
+  }
+  const filename = await ensureUniqueFilename(name);
+  const filePath = path.join(getAgentsDir(), filename);
+  const prompt = buildPrompt(name, description);
+  let content;
+  try {
+    const completion = await ctx.llm.complete({
+      messages: [
+        {
+          role: "system",
+          content: "You generate concise markdown definitions for sub-agents. Output only markdown with no code fences. Keep it short but complete."
+        },
+        { role: "user", content: prompt }
+      ],
+      maxTokens: 600
+    });
+    content = completion.content.trim();
+  } catch (error) {
+    console.error(chalk.red(`Failed to generate agent: ${error.message}`));
+    return null;
+  }
+  try {
+    await fs.ensureDir(getAgentsDir());
+    await fs.writeFile(filePath, content + "\n", "utf8");
+    console.log(chalk.green(`Saved new agent to ${filePath}`));
+  } catch (error) {
+    console.error(chalk.red(`Failed to save agent: ${error.message}`));
+    return null;
+  }
+  return null;
+}
+function buildPrompt(name, description) {
+  return [
+    `Create a sub-agent markdown file for "${name}".`,
+    description ? `Agent description: ${description}` : "",
+    "Structure it as:",
+    "# <Name>",
+    "## Purpose",
+    "## Operating Mode (bullet list)",
+    "## Tools (bullet list; mention existing CLI tools and constraints briefly)",
+    "## Output Contract (what to return to main agent)",
+    "Be concise, 120-160 words total."
+  ].filter(Boolean).join("\n");
+}
+function getAgentsDir() {
+  return AUTOHAND_PATHS.agents;
+}
+function slugify(input) {
+  return input.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "") || "agent";
+}
+async function ensureUniqueFilename(name) {
+  const base = slugify(name);
+  const dir = getAgentsDir();
+  let candidate = `${base}.md`;
+  let counter = 1;
+  while (await fs.pathExists(path.join(dir, candidate))) {
+    candidate = `${base}-${counter}.md`;
+    counter += 1;
+  }
+  return candidate;
+}
+
+export {
+  metadata,
+  createAgent
+};
+/**
+ * @license
+ * Copyright 2025 Autohand AI LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */

package/dist/chunk-XARAKKJ4.js

@@ -0,0 +1,197 @@
+import {
+  AUTOHAND_PATHS
+} from "./chunk-IAOMCEYU.js";
+
+// src/commands/agents.ts
+import chalk from "chalk";
+
+// src/core/agents/AgentRegistry.ts
+import fs from "fs/promises";
+import os from "os";
+import path from "path";
+import { z } from "zod";
+var AgentConfigSchema = z.object({
+  description: z.string(),
+  systemPrompt: z.string(),
+  tools: z.array(z.string()),
+  model: z.string().optional()
+});
+var AgentRegistry = class _AgentRegistry {
+  constructor() {
+    this.agents = /* @__PURE__ */ new Map();
+    this.externalPaths = [];
+    this.agentsDir = AUTOHAND_PATHS.agents;
+  }
+  static getInstance() {
+    if (!_AgentRegistry.instance) {
+      _AgentRegistry.instance = new _AgentRegistry();
+    }
+    return _AgentRegistry.instance;
+  }
+  /**
+   * Set external agent paths from config
+   * Supports tilde (~) expansion for home directory
+   */
+  setExternalPaths(paths) {
+    this.externalPaths = paths.map(
+      (p) => p.startsWith("~") ? path.join(os.homedir(), p.slice(1)) : p
+    );
+  }
+  /**
+   * Get configured external paths
+   */
+  getExternalPaths() {
+    return [...this.externalPaths];
+  }
+  /**
+   * Scans the agents directory and all external paths for agent configurations.
+   */
+  async loadAgents() {
+    this.agents.clear();
+    await this.loadAgentsFromDir(this.agentsDir, "user");
+    for (const extPath of this.externalPaths) {
+      await this.loadAgentsFromDir(extPath, "external");
+    }
+  }
+  /**
+   * Load agents from a specific directory
+   */
+  async loadAgentsFromDir(dir, source) {
+    try {
+      if (source === "user") {
+        await fs.mkdir(dir, { recursive: true });
+      }
+      const exists = await fs.access(dir).then(() => true).catch(() => false);
+      if (!exists) {
+        return;
+      }
+      const files = await fs.readdir(dir);
+      for (const file of files) {
+        const filePath = path.join(dir, file);
+        const stat = await fs.stat(filePath).catch(() => null);
+        if (!stat?.isFile()) {
+          continue;
+        }
+        if (file.endsWith(".json")) {
+          await this.loadJsonAgent(filePath, source);
+          continue;
+        }
+        if (file.endsWith(".md") || file.endsWith(".markdown")) {
+          await this.loadMarkdownAgent(filePath, source);
+        }
+      }
+    } catch (error) {
+      if (source === "user") {
+        console.error(`Error loading agents from ${dir}:`, error);
+      }
+    }
+  }
+  getAgent(name) {
+    return this.agents.get(name);
+  }
+  getAllAgents() {
+    return Array.from(this.agents.values());
+  }
+  getAgentsDirectory() {
+    return this.agentsDir;
+  }
+  /**
+   * Get agents filtered by source
+   */
+  getAgentsBySource(source) {
+    return this.getAllAgents().filter((a) => a.source === source);
+  }
+  async loadJsonAgent(filePath, source) {
+    const name = path.basename(filePath, ".json");
+    try {
+      const content = await fs.readFile(filePath, "utf-8");
+      const json = JSON.parse(content);
+      const config = AgentConfigSchema.parse(json);
+      if (!this.agents.has(name)) {
+        this.agents.set(name, { name, path: filePath, source, ...config });
+      }
+    } catch (error) {
+      console.warn(`Failed to load agent '${name}': ${error.message}`);
+    }
+  }
+  async loadMarkdownAgent(filePath, source) {
+    const name = path.basename(filePath, path.extname(filePath));
+    try {
+      const content = await fs.readFile(filePath, "utf-8");
+      const description = extractMarkdownTitle(content) || `Agent ${name}`;
+      const definition = {
+        name,
+        path: filePath,
+        source,
+        description,
+        systemPrompt: content,
+        tools: [],
+        model: void 0
+      };
+      if (!this.agents.has(name)) {
+        this.agents.set(name, definition);
+      }
+    } catch (error) {
+      console.warn(`Failed to load agent '${name}': ${error.message}`);
+    }
+  }
+};
+function extractMarkdownTitle(content) {
+  const lines = content.split(/\r?\n/);
+  for (const line of lines) {
+    const trimmed = line.trim();
+    if (!trimmed) continue;
+    if (trimmed.startsWith("#")) {
+      return trimmed.replace(/^#+\s*/, "").trim() || null;
+    }
+    return trimmed;
+  }
+  return null;
+}
+
+// src/commands/agents.ts
+var metadata = {
+  command: "/agents",
+  description: "list available sub-agents (markdown or json)",
+  implemented: true,
+  prd: "prd/sub_agents_architecture.md"
+};
+async function handler() {
+  const registry = AgentRegistry.getInstance();
+  await registry.loadAgents();
+  const agents = registry.getAllAgents();
+  if (agents.length === 0) {
+    return `No agents found in ${chalk.cyan(registry.getAgentsDirectory())}.
+Create a markdown file (e.g., helper.md) there to define a new sub-agent.`;
+  }
+  let output = chalk.bold("Available Agents:\n\n");
+  for (const agent of agents) {
+    output += `${chalk.green("\u{1F916} " + agent.name)}
+`;
+    output += `  ${chalk.gray(agent.description)}
+`;
+    output += `  ${chalk.blue("Path:")} ${agent.path}
+`;
+    if (agent.model) {
+      output += `  ${chalk.yellow("Model:")} ${agent.model}
+`;
+    }
+    if (agent.tools?.length) {
+      output += `  ${chalk.blue("Tools:")} ${agent.tools.join(", ")}
+`;
+    }
+    output += "\n";
+  }
+  return output.trim();
+}
+
+export {
+  AgentRegistry,
+  metadata,
+  handler
+};
+/**
+ * @license
+ * Copyright 2025 Autohand AI LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */

package/dist/chunk-Y6JDGDEE.js

@@ -0,0 +1,197 @@
+import {
+  AUTOHAND_PATHS
+} from "./chunk-WTEZYXD2.js";
+
+// src/commands/agents.ts
+import chalk from "chalk";
+
+// src/core/agents/AgentRegistry.ts
+import fs from "fs/promises";
+import os from "os";
+import path from "path";
+import { z } from "zod";
+var AgentConfigSchema = z.object({
+  description: z.string(),
+  systemPrompt: z.string(),
+  tools: z.array(z.string()),
+  model: z.string().optional()
+});
+var AgentRegistry = class _AgentRegistry {
+  constructor() {
+    this.agents = /* @__PURE__ */ new Map();
+    this.externalPaths = [];
+    this.agentsDir = AUTOHAND_PATHS.agents;
+  }
+  static getInstance() {
+    if (!_AgentRegistry.instance) {
+      _AgentRegistry.instance = new _AgentRegistry();
+    }
+    return _AgentRegistry.instance;
+  }
+  /**
+   * Set external agent paths from config
+   * Supports tilde (~) expansion for home directory
+   */
+  setExternalPaths(paths) {
+    this.externalPaths = paths.map(
+      (p) => p.startsWith("~") ? path.join(os.homedir(), p.slice(1)) : p
+    );
+  }
+  /**
+   * Get configured external paths
+   */
+  getExternalPaths() {
+    return [...this.externalPaths];
+  }
+  /**
+   * Scans the agents directory and all external paths for agent configurations.
+   */
+  async loadAgents() {
+    this.agents.clear();
+    await this.loadAgentsFromDir(this.agentsDir, "user");
+    for (const extPath of this.externalPaths) {
+      await this.loadAgentsFromDir(extPath, "external");
+    }
+  }
+  /**
+   * Load agents from a specific directory
+   */
+  async loadAgentsFromDir(dir, source) {
+    try {
+      if (source === "user") {
+        await fs.mkdir(dir, { recursive: true });
+      }
+      const exists = await fs.access(dir).then(() => true).catch(() => false);
+      if (!exists) {
+        return;
+      }
+      const files = await fs.readdir(dir);
+      for (const file of files) {
+        const filePath = path.join(dir, file);
+        const stat = await fs.stat(filePath).catch(() => null);
+        if (!stat?.isFile()) {
+          continue;
+        }
+        if (file.endsWith(".json")) {
+          await this.loadJsonAgent(filePath, source);
+          continue;
+        }
+        if (file.endsWith(".md") || file.endsWith(".markdown")) {
+          await this.loadMarkdownAgent(filePath, source);
+        }
+      }
+    } catch (error) {
+      if (source === "user") {
+        console.error(`Error loading agents from ${dir}:`, error);
+      }
+    }
+  }
+  getAgent(name) {
+    return this.agents.get(name);
+  }
+  getAllAgents() {
+    return Array.from(this.agents.values());
+  }
+  getAgentsDirectory() {
+    return this.agentsDir;
+  }
+  /**
+   * Get agents filtered by source
+   */
+  getAgentsBySource(source) {
+    return this.getAllAgents().filter((a) => a.source === source);
+  }
+  async loadJsonAgent(filePath, source) {
+    const name = path.basename(filePath, ".json");
+    try {
+      const content = await fs.readFile(filePath, "utf-8");
+      const json = JSON.parse(content);
+      const config = AgentConfigSchema.parse(json);
+      if (!this.agents.has(name)) {
+        this.agents.set(name, { name, path: filePath, source, ...config });
+      }
+    } catch (error) {
+      console.warn(`Failed to load agent '${name}': ${error.message}`);
+    }
+  }
+  async loadMarkdownAgent(filePath, source) {
+    const name = path.basename(filePath, path.extname(filePath));
+    try {
+      const content = await fs.readFile(filePath, "utf-8");
+      const description = extractMarkdownTitle(content) || `Agent ${name}`;
+      const definition = {
+        name,
+        path: filePath,
+        source,
+        description,
+        systemPrompt: content,
+        tools: [],
+        model: void 0
+      };
+      if (!this.agents.has(name)) {
+        this.agents.set(name, definition);
+      }
+    } catch (error) {
+      console.warn(`Failed to load agent '${name}': ${error.message}`);
+    }
+  }
+};
+function extractMarkdownTitle(content) {
+  const lines = content.split(/\r?\n/);
+  for (const line of lines) {
+    const trimmed = line.trim();
+    if (!trimmed) continue;
+    if (trimmed.startsWith("#")) {
+      return trimmed.replace(/^#+\s*/, "").trim() || null;
+    }
+    return trimmed;
+  }
+  return null;
+}
+
+// src/commands/agents.ts
+var metadata = {
+  command: "/agents",
+  description: "list available sub-agents (markdown or json)",
+  implemented: true,
+  prd: "prd/sub_agents_architecture.md"
+};
+async function handler() {
+  const registry = AgentRegistry.getInstance();
+  await registry.loadAgents();
+  const agents = registry.getAllAgents();
+  if (agents.length === 0) {
+    return `No agents found in ${chalk.cyan(registry.getAgentsDirectory())}.
+Create a markdown file (e.g., helper.md) there to define a new sub-agent.`;
+  }
+  let output = chalk.bold("Available Agents:\n\n");
+  for (const agent of agents) {
+    output += `${chalk.green("\u{1F916} " + agent.name)}
+`;
+    output += `  ${chalk.gray(agent.description)}
+`;
+    output += `  ${chalk.blue("Path:")} ${agent.path}
+`;
+    if (agent.model) {
+      output += `  ${chalk.yellow("Model:")} ${agent.model}
+`;
+    }
+    if (agent.tools?.length) {
+      output += `  ${chalk.blue("Tools:")} ${agent.tools.join(", ")}
+`;
+    }
+    output += "\n";
+  }
+  return output.trim();
+}
+
+export {
+  AgentRegistry,
+  metadata,
+  handler
+};
+/**
+ * @license
+ * Copyright 2025 Autohand AI LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */