poe-code 3.0.19 → 3.0.20

package/dist/index.js

@@ -13758,13 +13758,6 @@ var require_dist = __commonJS({
   }
 });
 
-// packages/agent-skill-config/src/templates/poe-generate.md
-var require_poe_generate = __commonJS({
-  "packages/agent-skill-config/src/templates/poe-generate.md"(exports, module) {
-    module.exports = '---\nname: poe-generate\ndescription: \'Poe code generation skill\'\n---\n\n# poe-code generate\n\nUse `poe-code generate` to create text, images, audio, or video via the Poe API.\n\n## Text generation\n\n```bash\npoe-code generate "Write a short function that parses a JSON string safely."\n```\n\nSpecify the model/bot:\n\n```bash\n# CLI option\npoe-code generate --model "gpt-4.1" "Summarize this codebase change."\n\n# Some agent runtimes call the model selector `--bot`\npoe-code generate --bot "gpt-4.1" "Summarize this codebase change."\n```\n\n## Media generation\n\nThe CLI supports media generation as subcommands:\n\n```bash\npoe-code generate image "A 3D render of a rubber duck wearing sunglasses" --model "gpt-image-1" -o duck.png\npoe-code generate video "A cinematic timelapse of a city at night" --model "veo" -o city.mp4\npoe-code generate audio "A calm 10 second lo-fi beat" --model "audio-model" -o beat.wav\n```\n\nSome agent runtimes expose the same media types as flags. If available, these are equivalent:\n\n```bash\npoe-code generate --image "A 3D render of a rubber duck wearing sunglasses" --bot "gpt-image-1" -o duck.png\npoe-code generate --video "A cinematic timelapse of a city at night" --bot "veo" -o city.mp4\npoe-code generate --audio "A calm 10 second lo-fi beat" --bot "audio-model" -o beat.wav\n```\n\n## Tips\n\n- Use `--param key=value` to pass provider/model parameters (repeatable).\n- Use `--output <path>` (or `-o`) for media outputs.\n';
-  }
-});
-
 // src/cli/program.ts
 import { Command } from "commander";
 
@@ -15074,6 +15067,26 @@ function createLogger(emitter) {
 }
 var logger = createLogger();
 
+// packages/design-system/src/components/command-errors.ts
+function formatCommandNotFound(input) {
+  const unknown2 = input.unknownCommand.length > 0 ? input.unknownCommand : "<command>";
+  return {
+    label: `${typography.bold("Unknown command:")} ${text.command(unknown2)}`,
+    hint: `${text.muted("Run")} ${text.usageCommand(input.helpCommand)} ${text.muted("for available commands.")}`
+  };
+}
+function formatCommandNotFoundPanel(input) {
+  const message = formatCommandNotFound({
+    unknownCommand: input.unknownCommand,
+    helpCommand: input.helpCommand
+  });
+  return {
+    title: input.title ?? "command not found",
+    label: message.label,
+    footer: message.hint
+  };
+}
+
 // packages/design-system/src/acp/index.ts
 var acp_exports = {};
 __export(acp_exports, {
@@ -15148,6 +15161,9 @@ function renderError(message) {
 function intro(title) {
   Ie(text.intro(title));
 }
+function introPlain(title) {
+  Ie(title);
+}
 function outro(message) {
   Se(message);
 }
@@ -15293,8 +15309,11 @@ function createLoggerFactory(emitter, theme) {
           emitter(title);
           return;
         }
-        const formatted = theme?.intro ? theme.intro(title) : title;
-        intro(formatted);
+        if (theme?.intro) {
+          introPlain(theme.intro(title));
+          return;
+        }
+        intro(title);
       },
       resolved(label, value) {
         if (emitter) {
@@ -19807,7 +19826,7 @@ function registerGenerateCommand(program, container) {
       );
       return;
     }
-    intro(text.intro("generate"));
+    intro("generate");
     const client = await resolveClient(container);
     const response = await withSpinner({
       message: `Generating with ${model}...`,
@@ -19838,7 +19857,7 @@ function registerGenerateCommand(program, container) {
       );
       return;
     }
-    intro(text.intro("generate text"));
+    intro("generate text");
     const client = await resolveClient(container);
     const response = await withSpinner({
       message: `Generating with ${model}...`,
@@ -19875,7 +19894,7 @@ function registerMediaSubcommand(generate2, program, container, type) {
       );
       return;
     }
-    intro(text.intro(`generate ${type}`));
+    intro(`generate ${type}`);
     const client = await resolveClient(container);
     const saved = await withSpinner({
       message: `Generating ${type} with ${model}...`,
@@ -33171,6 +33190,155 @@ function parseMcpOutputFormatPreferences(value) {
   return preferences;
 }
 
+// src/utils/execution-context.ts
+import { dirname } from "node:path";
+import { fileURLToPath } from "node:url";
+function detectExecutionContext(input) {
+  const { argv, env, moduleUrl } = input;
+  if (isDevelopmentMode(argv, env)) {
+    return createDevelopmentContext(moduleUrl);
+  }
+  if (isNpxExecution(env)) {
+    const version2 = detectNpxVersion(env);
+    return createNpxContext(version2);
+  }
+  return {
+    mode: "global",
+    command: {
+      command: "poe-code",
+      args: []
+    }
+  };
+}
+function isDevelopmentMode(argv, env) {
+  const scriptPath = argv[1] ?? "";
+  if (scriptPath.endsWith(".ts") || scriptPath.includes("/src/")) {
+    return true;
+  }
+  if (env.npm_lifecycle_event === "dev") {
+    return true;
+  }
+  const nodeOptions = env.NODE_OPTIONS ?? "";
+  if (nodeOptions.includes("tsx") || nodeOptions.includes("ts-node")) {
+    return true;
+  }
+  return false;
+}
+function isNpxExecution(env) {
+  const execPath = env.npm_execpath ?? "";
+  if (execPath.includes("npx") || execPath.includes("npm")) {
+    const packagePath = env.npm_package_json ?? "";
+    if (packagePath.includes("_npx") || packagePath.includes(".npm/_cacache")) {
+      return true;
+    }
+  }
+  if (env.npm_command === "exec") {
+    return true;
+  }
+  return false;
+}
+function detectNpxVersion(env) {
+  const packageJson = env.npm_package_json ?? "";
+  const packageVersion = env.npm_package_version ?? "";
+  if (packageJson.includes("@beta") || packageVersion.includes("beta")) {
+    return "beta";
+  }
+  if (packageJson.includes("@latest")) {
+    return "latest";
+  }
+  return "default";
+}
+function createDevelopmentContext(moduleUrl) {
+  const modulePath = fileURLToPath(moduleUrl);
+  const srcIndex = modulePath.lastIndexOf("/src/");
+  const projectRoot = srcIndex !== -1 ? modulePath.substring(0, srcIndex) : dirname(dirname(modulePath));
+  return {
+    mode: "development",
+    command: {
+      command: "npm",
+      args: ["--silent", "--prefix", projectRoot, "run", "dev", "--"]
+    }
+  };
+}
+function createNpxContext(version2) {
+  const packageSpec = version2 === "default" ? "poe-code" : `poe-code@${version2}`;
+  return {
+    mode: version2 === "default" ? "npx" : `npx-${version2}`,
+    command: {
+      command: "npx",
+      args: ["--yes", packageSpec]
+    }
+  };
+}
+function toMcpServerCommand(execCommand, subcommand) {
+  return {
+    command: execCommand.command,
+    args: [...execCommand.args, subcommand]
+  };
+}
+function formatCliHelpCommand(context, args) {
+  const base = formatCliUsageCommand(context);
+  const trailing = args.join(" ");
+  if (trailing.length === 0) {
+    return base;
+  }
+  return `${base} ${trailing}`;
+}
+function formatCliUsageCommand(context) {
+  switch (context.mode) {
+    case "development":
+      return "npm run dev --";
+    case "npx":
+      return "npx poe-code";
+    case "npx-latest":
+      return "npx poe-code@latest";
+    case "npx-beta":
+      return "npx poe-code@beta";
+    case "global":
+    default:
+      return "poe-code";
+  }
+}
+function getCurrentExecutionContext(moduleUrl) {
+  return detectExecutionContext({
+    argv: process.argv,
+    env: process.env,
+    moduleUrl
+  });
+}
+
+// src/cli/command-not-found.ts
+function throwCommandNotFound(input) {
+  const { container, scope, unknownCommand, helpArgs, moduleUrl } = input;
+  const context = detectExecutionContext({
+    argv: process.argv,
+    env: container.env.variables,
+    moduleUrl
+  });
+  const helpCommand = formatCliHelpCommand(context, helpArgs);
+  const panel = formatCommandNotFoundPanel({
+    title: scope === "cli" ? "command not found" : `${scope} command not found`,
+    unknownCommand,
+    helpCommand
+  });
+  const logger2 = container.loggerFactory.create({
+    dryRun: false,
+    verbose: false,
+    scope
+  });
+  const shouldRenderIntroOutro = container.dependencies.logger == null;
+  if (shouldRenderIntroOutro) {
+    logger2.intro(panel.title);
+    M2.message(panel.label, { symbol: symbols.errorResolved });
+    outro(panel.footer);
+  } else {
+    logger2.error(`${panel.label}
+${panel.footer}`);
+  }
+  process.exitCode = 1;
+  throw new SilentError();
+}
+
 // packages/agent-mcp-config/src/configs.ts
 var agentMcpConfigs = {
   "claude-code": {
@@ -33386,100 +33554,6 @@ async function unconfigure(agentId, serverName, options) {
   );
 }
 
-// src/utils/execution-context.ts
-import { dirname } from "node:path";
-import { fileURLToPath } from "node:url";
-function detectExecutionContext(input) {
-  const { argv, env, moduleUrl } = input;
-  if (isDevelopmentMode(argv, env)) {
-    return createDevelopmentContext(moduleUrl);
-  }
-  if (isNpxExecution(env)) {
-    const version2 = detectNpxVersion(env);
-    return createNpxContext(version2);
-  }
-  return {
-    mode: "global",
-    command: {
-      command: "poe-code",
-      args: []
-    }
-  };
-}
-function isDevelopmentMode(argv, env) {
-  const scriptPath = argv[1] ?? "";
-  if (scriptPath.endsWith(".ts") || scriptPath.includes("/src/")) {
-    return true;
-  }
-  if (env.npm_lifecycle_event === "dev") {
-    return true;
-  }
-  const nodeOptions = env.NODE_OPTIONS ?? "";
-  if (nodeOptions.includes("tsx") || nodeOptions.includes("ts-node")) {
-    return true;
-  }
-  return false;
-}
-function isNpxExecution(env) {
-  const execPath = env.npm_execpath ?? "";
-  if (execPath.includes("npx") || execPath.includes("npm")) {
-    const packagePath = env.npm_package_json ?? "";
-    if (packagePath.includes("_npx") || packagePath.includes(".npm/_cacache")) {
-      return true;
-    }
-  }
-  if (env.npm_command === "exec") {
-    return true;
-  }
-  return false;
-}
-function detectNpxVersion(env) {
-  const packageJson = env.npm_package_json ?? "";
-  const packageVersion = env.npm_package_version ?? "";
-  if (packageJson.includes("@beta") || packageVersion.includes("beta")) {
-    return "beta";
-  }
-  if (packageJson.includes("@latest")) {
-    return "latest";
-  }
-  return "default";
-}
-function createDevelopmentContext(moduleUrl) {
-  const modulePath = fileURLToPath(moduleUrl);
-  const srcIndex = modulePath.lastIndexOf("/src/");
-  const projectRoot = srcIndex !== -1 ? modulePath.substring(0, srcIndex) : dirname(dirname(modulePath));
-  return {
-    mode: "development",
-    command: {
-      command: "npm",
-      args: ["--silent", "--prefix", projectRoot, "run", "dev", "--"]
-    }
-  };
-}
-function createNpxContext(version2) {
-  const packageSpec = version2 === "default" ? "poe-code" : `poe-code@${version2}`;
-  return {
-    mode: version2 === "default" ? "npx" : `npx-${version2}`,
-    command: {
-      command: "npx",
-      args: ["--yes", packageSpec]
-    }
-  };
-}
-function toMcpServerCommand(execCommand, subcommand) {
-  return {
-    command: execCommand.command,
-    args: [...execCommand.args, subcommand]
-  };
-}
-function getCurrentExecutionContext(moduleUrl) {
-  return detectExecutionContext({
-    argv: process.argv,
-    env: process.env,
-    moduleUrl
-  });
-}
-
 // src/cli/commands/mcp.ts
 var DEFAULT_MCP_AGENT = "claude-code";
 function createMcpServerEntry() {
@@ -33506,7 +33580,16 @@ function buildHelpText() {
   return lines.join("\n");
 }
 function registerMcpCommand(program, container) {
-  const mcp = program.command("mcp").description("MCP server commands").addHelpText("after", buildHelpText()).action(async function() {
+  const mcp = program.command("mcp").description("MCP server commands").addHelpText("after", buildHelpText()).action(function() {
+    if (this.args.length > 0) {
+      throwCommandNotFound({
+        container,
+        scope: "mcp",
+        unknownCommand: this.args.at(0) ?? "",
+        helpArgs: ["mcp", "--help"],
+        moduleUrl: import.meta.url
+      });
+    }
     this.help();
   });
   mcp.command("serve").description("Run MCP server on stdin/stdout").option(
@@ -33660,14 +33743,17 @@ function resolveAgentSupport2(input, registry2 = agentSkillConfigs) {
 }
 
 // packages/agent-skill-config/src/templates.ts
+import { readFile as readFile3 } from "node:fs/promises";
 var templatesCache2 = null;
 async function getTemplates2() {
   if (templatesCache2) {
     return templatesCache2;
   }
-  const poeGenerateTemplate = await Promise.resolve().then(() => __toESM(require_poe_generate(), 1)).then(
-    (m2) => m2.default
+  const poeGenerateTemplateUrl = new URL(
+    "./templates/poe-generate.md",
+    import.meta.url
   );
+  const poeGenerateTemplate = await readFile3(poeGenerateTemplateUrl, "utf8");
   templatesCache2 = {
     "poe-generate.md": poeGenerateTemplate
   };
@@ -33770,7 +33856,16 @@ function buildHelpText2() {
   ].join("\n");
 }
 function registerSkillCommand(program, container) {
-  const skill = program.command("skill").description("Skill directory commands").addHelpText("after", buildHelpText2()).action(async function() {
+  const skill = program.command("skill").description("Skill directory commands").addHelpText("after", buildHelpText2()).action(function() {
+    if (this.args.length > 0) {
+      throwCommandNotFound({
+        container,
+        scope: "skill",
+        unknownCommand: this.args.at(0) ?? "",
+        helpArgs: ["skill", "--help"],
+        moduleUrl: import.meta.url
+      });
+    }
     this.help();
   });
   skill.command("configure [agent]").description("Install skill directories for an agent").option("--agent <name>", "Agent to configure skills for").option("--local", "Use local scope (in the current project)").option("--global", "Use global scope (in the user home directory)").action(async (agentArg, options) => {
@@ -34131,60 +34226,92 @@ var package_default = {
 };
 
 // src/cli/program.ts
-function formatHelpText() {
-  const commandWidth = 11;
-  const cmd = (name, args) => {
-    const padded = name.padEnd(commandWidth);
-    const argument = args ? ` ${text.argument(args)}` : "";
-    return `  ${text.command(padded)}${argument}`;
+function formatCommandHeader(cmd) {
+  const parts = [];
+  let current = cmd;
+  while (current) {
+    const name = current.name();
+    if (name === "poe-code") {
+      break;
+    }
+    if (name.length > 0) {
+      parts.push(name);
+    }
+    current = current.parent ?? null;
+  }
+  return `Poe - ${parts.reverse().join(" ")}`;
+}
+function formatHelpText(input) {
+  const commandRows = [
+    {
+      name: "configure",
+      args: "[agent]",
+      description: "Configure a coding agent (claude-code, codex, opencode)"
+    },
+    {
+      name: "unconfigure",
+      args: "<agent>",
+      description: "Remove a previously applied configuration"
+    },
+    {
+      name: "spawn",
+      args: "<agent> [prompt]",
+      description: "Launch a coding agent"
+    },
+    {
+      name: "generate",
+      args: "[type]",
+      description: "Call Poe models via CLI (text/image/video/audio)"
+    },
+    {
+      name: "mcp configure",
+      args: "[agent]",
+      description: "Configure Poe MCP for your coding agent"
+    },
+    {
+      name: "mcp unconfigure",
+      args: "<agent>",
+      description: "Remove Poe MCP configuration from your agent"
+    },
+    {
+      name: "mcp serve",
+      args: "",
+      description: "Run the Poe MCP server on stdin/stdout"
+    },
+    {
+      name: "skill configure",
+      args: "[agent]",
+      description: "Configure agent skills to call Poe models"
+    },
+    {
+      name: "skill unconfigure",
+      args: "[agent]",
+      description: "Remove agent skills configuration"
+    }
+  ];
+  const nameWidth = Math.max(0, ...commandRows.map((row) => row.name.length));
+  const argsWidth = Math.max(
+    0,
+    ...commandRows.map((row) => row.args.length)
+  );
+  const cmd = (row) => {
+    const name = text.command(row.name.padEnd(nameWidth));
+    const args = row.args.length > 0 ? text.argument(row.args.padEnd(argsWidth)) : " ".repeat(argsWidth);
+    return `  ${name} ${args}  ${row.description}`;
   };
-  const example = (value) => `                                 ${text.example(value)}`;
-  const opt = (flag, desc) => `  ${text.option(flag.padEnd(27))}${desc}`;
   return [
-    text.heading("Configure coding agents to use the Poe API."),
+    text.heading("Poe - poe-code"),
     "",
-    `${text.section("Usage:")} ${text.usageCommand("poe-code")} ${text.argument("<command> [...options]")}`,
+    "Configure coding agents to use the Poe API.",
     "",
-    text.section("Commands:"),
-    cmd("configure", "[agent]") + "            Configure developer tooling for Poe API",
-    example("poe-code configure claude-code"),
+    `${text.section("Usage:")} ${text.usageCommand(input.usageCommand)} ${text.argument("<command> [...args]")}`,
     "",
-    cmd("unconfigure", "<agent>") + "       Remove existing Poe API tooling configuration",
-    example("poe-code unconfigure codex"),
-    "",
-    cmd("install", "[agent]") + "            Install tooling for a configured agent",
-    example("poe-code install opencode"),
-    "",
-    cmd("spawn", "<agent> [prompt]") + "   Run a single prompt through a configured agent CLI",
-    example('poe-code spawn codex "Say hello"'),
-    "",
-    cmd("wrap", "<agent>") + "            Run an agent CLI with Poe isolated configuration",
-    example("poe-code wrap claude-code --help"),
-    "",
-    cmd("test", "[agent]") + "            Run agent health checks",
-    example("poe-code test codex"),
-    "",
-    cmd("generate", "[type]") + "         Generate text or media via Poe API",
-    example('poe-code generate "What is 2+2?"'),
-    "",
-    cmd("login", "") + "                          Store a Poe API key for reuse across commands",
-    "",
-    cmd("mcp", "[subcommand]") + "        MCP server commands",
-    example("poe-code mcp configure claude-code"),
-    "",
-    cmd("skill", "[subcommand]") + "      Skill directory commands",
-    example("poe-code skill configure claude-code"),
-    "",
-    text.section("Options:"),
-    opt("-y, --yes", "Accept defaults without prompting"),
-    opt("--dry-run", "Simulate commands without writing changes"),
-    opt("--verbose", "Show verbose logs"),
-    opt("-V, --version", "Output the version number"),
-    opt("-h, --help", "Display help for command"),
+    text.section("Commands:"),
+    ...commandRows.map(cmd),
     "",
-    opt("<command> --help", "Print help text for command"),
+    `${text.muted("Run")} ${text.usageCommand(input.helpCommand)} ${text.muted("for command options.")}`,
     "",
-    `${text.muted("Learn more about Poe:")}            ${text.link("https://poe.com")}`,
+    `${text.muted("Learn more about Poe:")}            ${text.link("https://poe.com/api")}`,
     `${text.muted("GitHub:")}                          ${text.link("https://github.com/poe-platform/poe-code")}`
   ].join("\n");
 }
@@ -34205,7 +34332,7 @@ function formatSubcommandHelp(cmd, helper) {
   const indentBlock = (value) => value.split("\n").map((line) => `${indent}${line}`).join("\n");
   const formatList = (items) => items.map(indentBlock).join("\n");
   const output = [];
-  output.push(text.heading(`Poe - ${cmd.name()}`), "");
+  output.push(text.heading(formatCommandHeader(cmd)), "");
   output.push(
     `${text.section("Usage:")} ${text.usageCommand(helper.commandUsage(cmd))}`,
     ""
@@ -34275,10 +34402,20 @@ function createProgram(dependencies) {
 }
 function bootstrapProgram(container) {
   const program = new Command();
-  program.name("poe-code").description("Configure Poe API integrations for local developer tooling.").option("-y, --yes", "Accept defaults without prompting.").option("--dry-run", "Simulate commands without writing changes.").option("--verbose", "Show verbose logs.").helpOption("-h, --help", "Display help for command").configureHelp({
+  const executionContext = detectExecutionContext({
+    argv: process.argv,
+    env: container.env.variables,
+    moduleUrl: import.meta.url
+  });
+  const usageCommand = formatCliUsageCommand(executionContext);
+  const helpCommand = formatCliHelpCommand(executionContext, [
+    "<command>",
+    "--help"
+  ]);
+  program.name("poe-code").description("Configure Poe API integrations for local developer tooling.").option("-y, --yes", "Accept defaults without prompting.").option("--dry-run", "Simulate commands without writing changes.").option("--verbose", "Show verbose logs.").helpOption("-h, --help", "Display help for command").showHelpAfterError(false).showSuggestionAfterError(true).configureHelp({
     formatHelp: (cmd, helper) => {
       if (cmd.name() === "poe-code") {
-        return formatHelpText();
+        return formatHelpText({ usageCommand, helpCommand });
       }
       return formatSubcommandHelp(cmd, helper);
     }
@@ -34294,8 +34431,18 @@ function bootstrapProgram(container) {
   registerLoginCommand(program, container);
   registerMcpCommand(program, container);
   registerSkillCommand(program, container);
-  program.action(() => {
-    program.outputHelp();
+  program.action(function() {
+    const args = this.args;
+    if (args.length > 0) {
+      throwCommandNotFound({
+        container,
+        scope: "cli",
+        unknownCommand: args.at(0) ?? "",
+        helpArgs: ["--help"],
+        moduleUrl: import.meta.url
+      });
+    }
+    this.outputHelp();
   });
   return program;
 }