@agentprojectcontext/apx 1.25.0 → 1.27.1

package/src/cli-ts/commands/agent.ts

@@ -1,173 +0,0 @@
-import type { CommandModule, Argv, ArgumentsCamelCase } from "yargs";
-import { getHttp } from "../http.js";
-import { println, error, success, dim, highlight, table } from "../ui.js";
-
-interface GlobalArgs { project?: string }
-
-async function resolveProjectId(project?: string): Promise<string> {
-  const http = await getHttp();
-  const projects = (await http.get("/projects")) as Array<{ id: string; name: string; path: string }>;
-  if (!projects?.length) throw new Error("No projects registered. Run: apx init");
-  if (project) {
-    const match = projects.find(
-      (p) => p.id === project || p.name === project || p.path === project || p.path?.endsWith("/" + project),
-    );
-    if (!match) throw new Error(`Project not found: ${project}`);
-    return match.id;
-  }
-  return projects[0]!.id;
-}
-
-// ---------- list ----------
-
-const listCmd: CommandModule = {
-  command: "list",
-  aliases: ["ls"],
-  describe: "List agents in the current project",
-  handler: async (args: ArgumentsCamelCase<GlobalArgs>) => {
-    try {
-      const http = await getHttp();
-      const pid = await resolveProjectId(args.project as string | undefined);
-      const agents = (await http.get(`/projects/${pid}/agents`)) as Array<{
-        slug: string; role?: string; model?: string; description?: string;
-      }>;
-      if (!agents?.length) { println(dim("No agents found.")); return; }
-      table(
-        agents.map((a) => ({
-          Slug: a.slug,
-          Role: a.role || "-",
-          Model: a.model || "-",
-          Description: a.description ? a.description.slice(0, 50) : "-",
-        })),
-        ["Slug", "Role", "Model", "Description"],
-      );
-    } catch (err: unknown) {
-      error(err instanceof Error ? err.message : String(err));
-      process.exit(1);
-    }
-  },
-};
-
-// ---------- get / show ----------
-
-const getCmd: CommandModule = {
-  command: "get <slug>",
-  aliases: ["show"],
-  describe: "Show agent details and memory",
-  builder: (yargs: Argv) =>
-    yargs.positional("slug", { type: "string", demandOption: true, describe: "Agent slug" }),
-  handler: async (args: ArgumentsCamelCase<Record<string, unknown>>) => {
-    try {
-      const project = args.project as string | undefined;
-      const slug = args.slug as string;
-      const http = await getHttp();
-      const pid = await resolveProjectId(project);
-      const agent = (await http.get(`/projects/${pid}/agents/${slug}`)) as Record<string, unknown>;
-      process.stdout.write(JSON.stringify(agent, null, 2) + "\n");
-    } catch (err: unknown) {
-      error(err instanceof Error ? err.message : String(err));
-      process.exit(1);
-    }
-  },
-};
-
-// ---------- add / create ----------
-
-const addCmd: CommandModule = {
-  command: "add <slug>",
-  aliases: ["create"],
-  describe: "Create a new agent",
-  builder: (yargs: Argv) =>
-    yargs
-      .positional("slug", { type: "string", demandOption: true, describe: "Agent slug (identifier)" })
-      .option("role", { type: "string", describe: "Agent role (system prompt)" })
-      .option("model", { type: "string", describe: "LLM model (e.g. claude-sonnet-4-6)" })
-      .option("description", { alias: "d", type: "string", describe: "Short description" })
-      .option("skills", { type: "string", describe: "Comma-separated skill list" })
-      .option("language", { type: "string", describe: "Language code (e.g. en, es)" })
-      .option("tools", { type: "string", describe: "Comma-separated allowed tools" }),
-  handler: async (args: ArgumentsCamelCase<Record<string, unknown>>) => {
-    try {
-      const project = args.project as string | undefined;
-      const slug = args.slug as string;
-      const role = args.role as string | undefined;
-      const model = args.model as string | undefined;
-      const description = args.description as string | undefined;
-      const skills = args.skills as string | undefined;
-      const language = args.language as string | undefined;
-      const tools = args.tools as string | undefined;
-      const http = await getHttp();
-      const pid = await resolveProjectId(project);
-      const agent = await http.post(`/projects/${pid}/agents`, {
-        slug,
-        role,
-        model,
-        description,
-        skills: skills?.split(",").map((s) => s.trim()).filter(Boolean),
-        language,
-        tools: tools?.split(",").map((t) => t.trim()).filter(Boolean),
-      });
-      success(`Agent created: ${highlight(slug)}`);
-      process.stdout.write(JSON.stringify(agent, null, 2) + "\n");
-    } catch (err: unknown) {
-      error(err instanceof Error ? err.message : String(err));
-      process.exit(1);
-    }
-  },
-};
-
-// ---------- memory ----------
-
-const memoryCmd: CommandModule = {
-  command: "memory <slug>",
-  describe: "Read or write agent memory",
-  builder: (yargs: Argv) =>
-    yargs
-      .positional("slug", { type: "string", demandOption: true, describe: "Agent slug" })
-      .option("append", { type: "boolean", default: false, describe: "Append stdin to memory" })
-      .option("replace", { type: "boolean", default: false, describe: "Replace memory with stdin" }),
-  handler: async (args: ArgumentsCamelCase<Record<string, unknown>>) => {
-    try {
-      const project = args.project as string | undefined;
-      const slug = args.slug as string;
-      const append = args.append as boolean;
-      const replace = args.replace as boolean;
-      const http = await getHttp();
-      const pid = await resolveProjectId(project);
-      if (append || replace) {
-        const chunks: Buffer[] = [];
-        for await (const chunk of process.stdin) chunks.push(chunk as Buffer);
-        const body = Buffer.concat(chunks).toString();
-        if (append) {
-          const existing = (await http.get(`/projects/${pid}/agents/${slug}/memory`)) as { body: string };
-          await http.put(`/projects/${pid}/agents/${slug}/memory`, { body: (existing.body || "") + "\n" + body });
-        } else {
-          await http.put(`/projects/${pid}/agents/${slug}/memory`, { body });
-        }
-        success("Memory updated.");
-      } else {
-        const mem = (await http.get(`/projects/${pid}/agents/${slug}/memory`)) as { body: string };
-        process.stdout.write(mem.body || "");
-      }
-    } catch (err: unknown) {
-      error(err instanceof Error ? err.message : String(err));
-      process.exit(1);
-    }
-  },
-};
-
-// ---------- parent ----------
-
-export const agentCmd: CommandModule = {
-  command: "agent",
-  aliases: ["agents"],
-  describe: "Manage APC agents",
-  builder: (yargs: Argv) =>
-    yargs
-      .command(listCmd)
-      .command(getCmd)
-      .command(addCmd)
-      .command(memoryCmd)
-      .demandCommand(1, "Specify an agent subcommand"),
-  handler: () => {},
-};

package/src/cli-ts/commands/chat.ts

@@ -1,119 +0,0 @@
-import type { CommandModule, Argv, ArgumentsCamelCase } from "yargs";
-import { getHttp, type StreamEvent } from "../http.js";
-import { error, println, dim } from "../ui.js";
-import { createInterface } from "node:readline";
-
-interface GlobalArgs { project?: string }
-
-async function resolveProjectId(project?: string): Promise<string> {
-  const http = await getHttp();
-  const projects = (await http.get("/projects")) as Array<{ id: string; name: string; path: string }>;
-  if (!projects?.length) throw new Error("No projects registered. Run: apx init");
-  if (project) {
-    const match = projects.find(
-      (p) => p.id === project || p.name === project || p.path === project || p.path?.endsWith("/" + project),
-    );
-    if (!match) throw new Error(`Project not found: ${project}`);
-    return match.id;
-  }
-  return projects[0]!.id;
-}
-
-export const chatCmd: CommandModule = {
-  command: "chat [agent]",
-  describe: "Start an interactive multi-turn chat with an agent",
-  builder: (yargs: Argv) =>
-    yargs
-      .positional("agent", {
-        type: "string",
-        default: "default",
-        describe: "Agent slug (defaults to super-agent)",
-      })
-      .option("model", { type: "string", describe: "Override model" })
-      .option("conversation", {
-        alias: "c",
-        type: "string",
-        describe: "Continue an existing conversation ID",
-      }),
-  handler: async (
-    args: ArgumentsCamelCase<Record<string, unknown>>,
-  ) => {
-    try {
-      const project = args.project as string | undefined;
-      const agent = args.agent as string;
-      const model = args.model as string | undefined;
-      const http = await getHttp();
-      const pid = await resolveProjectId(project);
-      let conversationId = args.conversation as string | undefined;
-
-      if (!process.stdin.isTTY) {
-        // Non-interactive: read one prompt from stdin
-        const chunks: Buffer[] = [];
-        for await (const chunk of process.stdin) chunks.push(chunk as Buffer);
-        const prompt = Buffer.concat(chunks).toString().trim();
-        if (!prompt) throw new Error("No prompt provided via stdin.");
-        const result = (await http.post(`/projects/${pid}/agents/${agent}/chat`, {
-          prompt,
-          model,
-          conversation_id: conversationId,
-        })) as { conversation_id: string; text: string };
-        process.stdout.write(result.text + "\n");
-        return;
-      }
-
-      // Interactive REPL
-      println(dim(`APX Chat — agent: ${agent}  (type /exit or ctrl+c to quit)`));
-
-      const rl = createInterface({ input: process.stdin, output: process.stderr, terminal: true });
-      rl.setPrompt("\x1b[96m> \x1b[0m");
-      rl.prompt();
-
-      rl.on("line", async (line) => {
-        const text = line.trim();
-        if (!text) { rl.prompt(); return; }
-        if (text === "/exit" || text === "/quit") { rl.close(); return; }
-
-        rl.pause();
-        try {
-          // Try streaming first
-          let responded = false;
-          try {
-            const result = await http.streamPost(
-              `/projects/${pid}/super-agent/chat/stream`,
-              { prompt: text, model, previousMessages: [] },
-              (ev: StreamEvent) => {
-                if (ev.type === "chunk" && typeof ev.chunk === "string") {
-                  process.stdout.write(ev.chunk);
-                  responded = true;
-                }
-              },
-            ) as { text?: string };
-            if (!responded && result?.text) process.stdout.write(result.text);
-            process.stdout.write("\n");
-          } catch {
-            // Fall back to non-streaming agent chat
-            const result = (await http.post(`/projects/${pid}/agents/${agent}/chat`, {
-              prompt: text,
-              model,
-              conversation_id: conversationId,
-            })) as { conversation_id: string; text: string };
-            conversationId = result.conversation_id;
-            process.stdout.write(result.text + "\n");
-          }
-        } catch (err: unknown) {
-          error(err instanceof Error ? err.message : String(err));
-        }
-        rl.resume();
-        rl.prompt();
-      });
-
-      rl.on("close", () => {
-        println(dim("\nGoodbye."));
-        process.exit(0);
-      });
-    } catch (err: unknown) {
-      error(err instanceof Error ? err.message : String(err));
-      process.exit(1);
-    }
-  },
-};

package/src/cli-ts/commands/daemon.ts

@@ -1,112 +0,0 @@
-import type { CommandModule, Argv, ArgumentsCamelCase } from "yargs";
-import { getHttp } from "../http.js";
-import { println, error, success, dim } from "../ui.js";
-import { spawn } from "node:child_process";
-
-// ---------- status ----------
-
-const statusCmd: CommandModule = {
-  command: "status",
-  describe: "Show daemon status",
-  handler: async () => {
-    try {
-      const http = await getHttp();
-      const health = (await http.get("/health")) as {
-        status: string; version?: string; uptime_s?: number;
-      };
-      success(`Daemon running  version=${health.version ?? "?"}  uptime=${health.uptime_s ?? "?"}s`);
-    } catch {
-      error("Daemon is not running.");
-      process.exit(1);
-    }
-  },
-};
-
-// ---------- start ----------
-
-const startCmd: CommandModule = {
-  command: "start",
-  describe: "Start the APX daemon in the background",
-  handler: async () => {
-    try {
-      const http = await getHttp();
-      await http.get("/health");
-      println(dim("Daemon is already running."));
-    } catch {
-      const daemon = spawn("apx-daemon", [], {
-        detached: true,
-        stdio: "ignore",
-      });
-      daemon.unref();
-      success("Daemon started.");
-    }
-  },
-};
-
-// ---------- stop ----------
-
-const stopCmd: CommandModule = {
-  command: "stop",
-  describe: "Gracefully stop the APX daemon",
-  handler: async () => {
-    try {
-      const http = await getHttp();
-      await http.post("/admin/shutdown", {});
-      success("Daemon stopped.");
-    } catch (err: unknown) {
-      error(err instanceof Error ? err.message : String(err));
-      process.exit(1);
-    }
-  },
-};
-
-// ---------- logs ----------
-
-const logsCmd: CommandModule = {
-  command: "logs",
-  describe: "Stream daemon logs",
-  builder: (yargs: Argv) =>
-    yargs.option("tail", {
-      alias: "n",
-      type: "number",
-      default: 50,
-      describe: "Number of lines to show",
-    }),
-  handler: async (args: ArgumentsCamelCase<Record<string, unknown>>) => {
-    try {
-      const tail = (args.tail as number) ?? 50;
-      const { homedir } = await import("node:os");
-      const { createReadStream } = await import("node:fs");
-      const { createInterface } = await import("node:readline");
-      const logPath = `${homedir()}/.apx/daemon.log`;
-      try {
-        const rl = createInterface({ input: createReadStream(logPath), crlfDelay: Infinity });
-        const lines: string[] = [];
-        for await (const line of rl) lines.push(line);
-        const tailLines = lines.slice(-tail);
-        tailLines.forEach((l) => println(l));
-      } catch {
-        error(`Log file not found: ${logPath}`);
-        process.exit(1);
-      }
-    } catch (err: unknown) {
-      error(err instanceof Error ? err.message : String(err));
-      process.exit(1);
-    }
-  },
-};
-
-// ---------- parent ----------
-
-export const daemonCmd: CommandModule = {
-  command: "daemon",
-  describe: "Manage the APX background daemon",
-  builder: (yargs: Argv) =>
-    yargs
-      .command(statusCmd)
-      .command(startCmd)
-      .command(stopCmd)
-      .command(logsCmd)
-      .demandCommand(1, "Specify a daemon subcommand"),
-  handler: () => {},
-};

package/src/cli-ts/commands/exec.ts

@@ -1,109 +0,0 @@
-import type { CommandModule, Argv, ArgumentsCamelCase } from "yargs";
-import { getHttp, type StreamEvent } from "../http.js";
-import { error } from "../ui.js";
-
-interface GlobalArgs { project?: string }
-
-async function resolveProjectId(project?: string): Promise<string> {
-  const http = await getHttp();
-  const projects = (await http.get("/projects")) as Array<{ id: string; name: string; path: string }>;
-  if (!projects?.length) throw new Error("No projects registered. Run: apx init");
-  if (project) {
-    const match = projects.find(
-      (p) => p.id === project || p.name === project || p.path === project || p.path?.endsWith("/" + project),
-    );
-    if (!match) throw new Error(`Project not found: ${project}`);
-    return match.id;
-  }
-  return projects[0]!.id;
-}
-
-export const execCmd: CommandModule = {
-  command: "exec <agent> [prompt..]",
-  aliases: ["run"],
-  describe: "Run a one-shot prompt through an agent (non-interactive)",
-  builder: (yargs: Argv) =>
-    yargs
-      .positional("agent", { type: "string", demandOption: true, describe: "Agent slug" })
-      .positional("prompt", { type: "string", array: true, describe: "Prompt text" })
-      .option("model", { type: "string", describe: "Override model" })
-      .option("max-tokens", { type: "number", describe: "Max output tokens" })
-      .option("temperature", { type: "number", describe: "Sampling temperature (0–1)" })
-      .option("format", {
-        choices: ["text", "json"] as const,
-        default: "text" as const,
-        describe: "Output format",
-      })
-      .option("stream", {
-        type: "boolean",
-        default: true,
-        describe: "Stream output as it arrives",
-      }),
-  handler: async (
-    args: ArgumentsCamelCase<Record<string, unknown>>,
-  ) => {
-    try {
-      const project = args.project as string | undefined;
-      const agent = args.agent as string;
-      const promptArgs = args.prompt as string[] | undefined;
-      const model = args.model as string | undefined;
-      const maxTokens = args.maxTokens as number | undefined;
-      const temperature = args.temperature as number | undefined;
-      const format = args.format as "text" | "json";
-      const stream = args.stream as boolean;
-
-      // Build prompt from args + stdin
-      let prompt = (promptArgs ?? []).join(" ");
-      if (!process.stdin.isTTY) {
-        const chunks: Buffer[] = [];
-        for await (const chunk of process.stdin) chunks.push(chunk as Buffer);
-        const piped = Buffer.concat(chunks).toString().trim();
-        if (piped) prompt = prompt ? prompt + "\n\n" + piped : piped;
-      }
-      if (!prompt) throw new Error("No prompt provided. Pass text as argument or via stdin.");
-
-      const http = await getHttp();
-      const pid = await resolveProjectId(project);
-      const body = {
-        prompt,
-        model,
-        maxTokens,
-        temperature,
-      };
-
-      if (stream) {
-        // Try streaming endpoint first
-        try {
-          const result = await http.streamPost(
-            `/projects/${pid}/super-agent/chat/stream`,
-            { ...body, contextNote: `Agent: ${agent}` },
-            (ev: StreamEvent) => {
-              if (ev.type === "chunk" && typeof ev.chunk === "string") {
-                process.stdout.write(ev.chunk);
-              }
-              if (ev.type === "event" && ev.event === "assistant_text" && typeof (ev as Record<string, unknown>).text === "string") {
-                process.stdout.write((ev as Record<string, unknown>).text as string);
-              }
-            },
-          ) as { text?: string };
-          if (!result?.text) process.stdout.write("\n");
-          return;
-        } catch {
-          // Fall through to non-streaming
-        }
-      }
-
-      const result = (await http.post(`/projects/${pid}/agents/${agent}/exec`, body)) as {
-        text: string; usage?: { input_tokens: number; output_tokens: number };
-      };
-      if (format === "json") {
-        process.stdout.write(JSON.stringify(result, null, 2) + "\n");
-      } else {
-        process.stdout.write(result.text + "\n");
-      }
-    } catch (err: unknown) {
-      error(err instanceof Error ? err.message : String(err));
-      process.exit(1);
-    }
-  },
-};