@agentprojectcontext/apx 1.62.0 → 1.63.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agentprojectcontext/apx",
-  "version": "1.62.0",
+  "version": "1.63.0",
   "description": "APX — unified CLI + daemon for the Agent Project Context (APC) standard.",
   "publishConfig": {
     "access": "public"

package/skills/apx/SKILL.md

@@ -39,6 +39,11 @@ apx <command> --help
 ## Core commands you'll actually use
 
 ```bash
+# One-shot super-agent call
+apx exec "prompt"               # default 'cli' channel
+apx exec --code "prompt"        # 'code' channel: coding system prompt + git/code tools
+apx exec --channel <name> "…"   # explicit channel (cli, code, api, …)
+
 # Project + daemon
 apx status                      # daemon health
 apx project list                # registered projects

package/src/interfaces/cli/commands/exec.js

@@ -31,6 +31,33 @@ export function resolveExecRequest(args) {
   };
 }
 
+// Valid channel strings the daemon knows how to route.
+const KNOWN_CHANNELS = new Set(Object.values(CHANNELS));
+
+/**
+ * Resolve which channel `apx exec` should tag the turn with.
+ * Default: CHANNELS.CLI (unchanged behaviour).
+ *   --code / -c        → CHANNELS.CODE (coding system prompt + code tools)
+ *   --channel <name>   → explicit channel (must be a known channel string)
+ */
+export function resolveExecChannel(args) {
+  const flags = args?.flags || {};
+  if (flags.code) return CHANNELS.CODE;
+
+  const raw = flags.channel;
+  if (raw && raw !== true) {
+    const channel = String(raw).toLowerCase();
+    if (!KNOWN_CHANNELS.has(channel)) {
+      throw new Error(
+        `apx exec: unknown channel "${raw}". Known channels: ${[...KNOWN_CHANNELS].join(", ")}`
+      );
+    }
+    return channel;
+  }
+
+  return CHANNELS.CLI;
+}
+
 async function readPromptFromStdin() {
   const fs = await import("node:fs");
   if (process.stdin.isTTY) return "";
@@ -57,14 +84,14 @@ export async function cmdExec(args) {
   }
   if (!prompt) {
     throw new Error(
-      'apx exec: prompt is empty. Usage: apx exec "prompt" | apx exec -a <agent> "prompt" | apx exec -- "prompt"'
+      'apx exec: prompt is empty. Usage: apx exec "prompt" | apx exec --code "prompt" | apx exec -a <agent> "prompt" | apx exec -- "prompt"'
     );
   }
 
   const pid = await resolveProjectId(args?.flags?.project);
   const body = {
     prompt,
-    channel: CHANNELS.CLI,
+    channel: resolveExecChannel(args),
     channelMeta: { cwd: process.cwd() },
   };
   if (args.flags.model && args.flags.model !== true) body.model = args.flags.model;

package/src/interfaces/cli/index.js

@@ -1100,12 +1100,15 @@ const HELP_TOPICS = new Map(Object.entries({
     summary: "One-shot LLM call. Default target is the APX super-agent (daemon); use -a for an APC agent slug.",
     usage: [
       "apx exec \"<prompt>\" [--model <id>] [--project <name|id|path>]",
+      "apx exec --code \"<prompt>\"   (coding channel: code system prompt + git tools)",
       "apx exec -- \"<prompt>\"",
       "apx exec -a <agent> \"<prompt>\" [--model <id>]",
       "apx exec <agent> \"<prompt>\"  (legacy positional agent)",
     ],
     options: [
       ["-a, --agent <slug>", "APC agent slug (omit for super-agent default)."],
+      ["-c, --code", "Run on the 'code' channel (coding system prompt + code tools)."],
+      ["--channel <name>", "Explicit channel (cli, code, api, …). Default cli."],
       ["--model <id>", "Override configured model."],
       ["--max-tokens N", "Output token limit."],
       ["--temperature T", "Sampling temperature."],
@@ -1113,6 +1116,7 @@ const HELP_TOPICS = new Map(Object.entries({
     ],
     examples: [
       "apx exec \"What time is it in UTC?\"",
+      "apx exec --code \"refactor the auth middleware\"",
       "apx exec -- \"decime qué hora es\"",
       "apx exec -a reviewer \"Summarize your role\"",
       "apx exec reviewer \"Summarize your role\" --model gpt-5.2",
@@ -2090,7 +2094,7 @@ function buildHelp(version) {
 
     hSec("LLM / Code"),
     hCmd("apx code",                   36, "APX terminal coding assistant"),
-    hCmd("apx exec \"prompt\"",         36, "super-agent (default)  --model <id>  -a <agent> for APC slug"),
+    hCmd("apx exec \"prompt\"",         36, "super-agent (default)  --code coding channel  -a <agent> for APC slug"),
     hCmd("apx chat <agent>",           36, "interactive agent REPL  --conversation <id>"),
     hCmd("apx search \"query\"",       36, "web search (ddg | brave | browser)  --mode <m>  -n N"),
     hCmd("apx conversations list",     36, "stored exec/chat conversations for <agent>"),
@@ -2241,6 +2245,11 @@ function findHelpTopic(argv) {
   return { global: true };
 }
 
+// Flags that never take a value. Without this the parser would greedily
+// swallow the following positional (e.g. `apx exec --code "hi"` would set
+// flags.code = "hi" and drop the prompt). Boolean flags always resolve to true.
+const BOOLEAN_FLAGS = new Set(["code", "verbose"]);
+
 function parseArgs(argv) {
   const args = { _: [], flags: {} };
   for (let i = 0; i < argv.length; i++) {
@@ -2253,7 +2262,9 @@ function parseArgs(argv) {
     if (a.startsWith("--")) {
       const key = a.slice(2);
       const next = argv[i + 1];
-      if (next === undefined || next.startsWith("--")) {
+      if (BOOLEAN_FLAGS.has(key)) {
+        args.flags[key] = true;
+      } else if (next === undefined || next.startsWith("--")) {
         args.flags[key] = true;
       } else {
         // support repeated flags (e.g. --env A=1 --env B=2)
@@ -2269,6 +2280,8 @@ function parseArgs(argv) {
       args.flags.n = argv[++i];
     } else if (a === "-a") {
       args.flags.agent = argv[++i];
+    } else if (a === "-c") {
+      args.flags.code = true;
     } else {
       args._.push(a);
     }