@agentprojectcontext/apx 1.15.1 → 1.15.3

package/package.json

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

package/src/cli/commands/setup.js

@@ -192,9 +192,20 @@ export async function cmdSetup() {
   // ── Language ────────────────────────────────────────────────────────────────
   console.log();
   console.log(b("  Language:"));
-  console.log(di("  The super-agent will always respond in your language."));
+  console.log(di("  Used for audio transcription, super-agent replies, and Telegram messages."));
+  console.log(di("  Enter a 2-letter ISO 639-1 code. Common codes:"));
+  console.log(di("    es=Spanish  en=English  pt=Portuguese  fr=French  de=German"));
+  console.log(di("    it=Italian  zh=Chinese  ja=Japanese    ko=Korean  ar=Arabic"));
   console.log();
-  const language = await ask("  Your language (e.g. English, Spanish, Portuguese): ") || "English";
+  let language = "";
+  while (!language) {
+    const raw = (await ask("  Language code [en]: ")).trim().toLowerCase() || "en";
+    if (/^[a-z]{2}$/.test(raw)) {
+      language = raw;
+    } else {
+      console.log(`  ${c.yellow}Please enter exactly 2 letters (e.g. es, en, pt).${c.reset}`);
+    }
+  }
 
   // ── Summary ─────────────────────────────────────────────────────────────────
   console.log();
@@ -236,6 +247,8 @@ export async function cmdSetup() {
     cfg.telegram.chat_id = chatId;
   }
 
+  cfg.user = { ...(cfg.user || {}), language };
+
   writeConfig(cfg);
   console.log(`\n  ${gr("✓")} Config saved to ${di("~/.apx/config.json")}`);
 
@@ -282,7 +295,7 @@ export async function cmdSetup() {
 async function sendTelegramWakeup({ botToken, chatId, language, model }) {
   const prompt =
     `You are APX, an AI agent assistant that just came online for the first time. ` +
-    `Write a short, enthusiastic wake-up message in ${language}. ` +
+    `Write a short, enthusiastic wake-up message in the language with ISO 639-1 code "${language}". ` +
     `Structure it in exactly 3 short lines: ` +
     `1) An energetic line announcing you are online (use ⚡ emoji). ` +
     `2) Say you don't have a name yet and ask the user what they'd like to call you. ` +
@@ -321,18 +334,20 @@ async function sendTelegramWakeup({ botToken, chatId, language, model }) {
   });
 }
 
-// Minimal fallback messages per common language (used only if daemon can't respond)
+// Minimal fallback messages per ISO 639-1 code (used only if daemon can't respond)
+const WAKEUP_FALLBACK = {
+  es: "⚡ ¡APX está en línea y listo!\nAún no tengo nombre — ¿cómo te gustaría llamarme?\n¿Y a vos, cómo te llamo?",
+  pt: "⚡ APX está online e pronto!\nAinda não tenho nome — como você gostaria de me chamar?\nE você, como devo te chamar?",
+  fr: "⚡ APX est en ligne et prêt !\nJe n'ai pas encore de nom — comment souhaitez-vous m'appeler ?\nEt vous, comment dois-je vous appeler ?",
+  de: "⚡ APX ist online und bereit!\nIch habe noch keinen Namen — wie möchten Sie mich nennen?\nUnd Sie, wie soll ich Sie nennen?",
+  it: "⚡ APX è online e pronto!\nNon ho ancora un nome — come vorresti chiamarmi?\nE tu, come ti chiamo?",
+  zh: "⚡ APX 已上线，随时待命！\n我还没有名字——你想叫我什么？\n你希望我怎么称呼你？",
+  ja: "⚡ APXがオンラインになりました！\nまだ名前がありません — 何と呼びたいですか？\nあなたのことは何とお呼びすればよいですか？",
+  ko: "⚡ APX가 온라인 상태입니다!\n아직 이름이 없어요 — 어떻게 불러주실 건가요?\n그리고 당신은 어떻게 불러드릴까요?",
+};
 function languageFallback(lang) {
-  const l = lang.toLowerCase();
-  if (/spanish|arg|lat/i.test(l))
-    return "⚡ APX is online and ready to work.\nI do not have a name yet. What would you like to call me?\nAnd what should I call you?";
-  if (/portugu|brasil/i.test(l))
-    return "⚡ APX is online and ready to work.\nI do not have a name yet. What would you like to call me?\nAnd what should I call you?";
-  if (/franc|french/i.test(l))
-    return "⚡ APX is online and ready to work.\nI do not have a name yet. What would you like to call me?\nAnd what should I call you?";
-  if (/deutsch|german/i.test(l))
-    return "⚡ APX is online and ready to work.\nI do not have a name yet. What would you like to call me?\nAnd what should I call you?";
-  if (/ital/i.test(l))
-    return "⚡ APX is online and ready to work.\nI do not have a name yet. What would you like to call me?\nAnd what should I call you?";
-  return "⚡ I'm awake and ready to go! APX is online.\nI don't have a name yet — what would you like to call me?\nAnd you, what's your name or what should I call you?";
+  return (
+    WAKEUP_FALLBACK[lang.toLowerCase().slice(0, 2)] ||
+    "⚡ I'm awake and ready to go! APX is online.\nI don't have a name yet — what would you like to call me?\nAnd you, what's your name or what should I call you?"
+  );
 }

package/src/cli/commands/update.js

@@ -4,6 +4,29 @@ import { getLatestVersion } from "../../core/update-check.js";
 
 const PACKAGE_NAME = "@agentprojectcontext/apx";
 
+function isNewer(cur, lat) {
+  const parse = (v) => v.replace(/^v/, "").split(".").map(Number);
+  const [ma, mi, pa] = parse(cur);
+  const [mb, mib, pb] = parse(lat);
+  if (mb > ma) return true;
+  if (mb === ma && mib > mi) return true;
+  if (mb === ma && mib === mi && pb > pa) return true;
+  return false;
+}
+
+function hasPnpmGlobal() {
+  const r = spawnSync("pnpm", ["--version"], { encoding: "utf8", stdio: "pipe" });
+  if (r.status !== 0) return false;
+  // pnpm needs PNPM_HOME configured to manage global packages
+  const check = spawnSync("pnpm", ["root", "-g"], { encoding: "utf8", stdio: "pipe" });
+  return check.status === 0 && !!check.stdout?.trim();
+}
+
+function daemonRunning() {
+  const r = spawnSync("apx", ["daemon", "status", "--json"], { encoding: "utf8", stdio: "pipe" });
+  try { return JSON.parse(r.stdout)?.running === true; } catch { return false; }
+}
+
 export async function cmdUpdate(args, currentVersion) {
   const force = args.flags.force || args.flags.yes || args.flags.y;
 
@@ -15,24 +38,12 @@ export async function cmdUpdate(args, currentVersion) {
     process.exit(1);
   }
 
-  const current = currentVersion;
-
-  function isNewer(cur, lat) {
-    const parse = (v) => v.replace(/^v/, "").split(".").map(Number);
-    const [ma, mi, pa] = parse(cur);
-    const [mb, mib, pb] = parse(lat);
-    if (mb > ma) return true;
-    if (mb === ma && mib > mi) return true;
-    if (mb === ma && mib === mi && pb > pa) return true;
-    return false;
-  }
-
-  if (!isNewer(current, latest)) {
-    console.log(`✅ Already up to date (${current})`);
+  if (!isNewer(currentVersion, latest)) {
+    console.log(`✅ Already up to date (${currentVersion})`);
     return;
   }
 
-  console.log(`\n  Current: ${current}`);
+  console.log(`\n  Current: ${currentVersion}`);
   console.log(`  Latest:  ${latest}`);
 
   if (!force) {
@@ -43,20 +54,41 @@ export async function cmdUpdate(args, currentVersion) {
     }
   }
 
-  console.log(`\nRunning: npm install -g ${PACKAGE_NAME}@${latest}\n`);
-  const result = spawnSync(
-    "npm",
-    ["install", "-g", `${PACKAGE_NAME}@${latest}`],
-    { stdio: "inherit" }
-  );
+  // Stop daemon before replacing the binary so Node doesn't lock files on Windows.
+  const wasDaemonRunning = daemonRunning();
+  if (wasDaemonRunning) {
+    process.stdout.write("\nStopping daemon... ");
+    spawnSync("apx", ["daemon", "stop"], { stdio: "inherit" });
+    console.log("stopped.");
+  }
+
+  // Prefer pnpm global if configured, fall back to npm.
+  const usePnpm = hasPnpmGlobal();
+  const pm = usePnpm ? "pnpm" : "npm";
+  const installArgs = usePnpm
+    ? ["add", "-g", `${PACKAGE_NAME}@${latest}`]
+    : ["install", "-g", `${PACKAGE_NAME}@${latest}`];
+
+  console.log(`\nInstalling ${PACKAGE_NAME}@${latest} via ${pm}...\n`);
+  const result = spawnSync(pm, installArgs, { stdio: "inherit" });
 
   if (result.status !== 0) {
     console.error(`\n❌ Update failed (exit ${result.status})`);
+    if (wasDaemonRunning) {
+      console.log("Restarting daemon with old version...");
+      spawnSync("apx", ["daemon", "start"], { stdio: "inherit" });
+    }
     process.exit(result.status || 1);
   }
 
-  console.log(`\n✅ Updated to ${latest}. Restart any running apx daemon:`);
-  console.log(`   apx daemon stop && apx daemon start`);
+  // Restart daemon with new version.
+  if (wasDaemonRunning) {
+    process.stdout.write("\nStarting daemon... ");
+    spawnSync("apx", ["daemon", "start"], { stdio: "inherit" });
+    console.log("done.");
+  }
+
+  console.log(`\n✅ Updated to ${latest}.`);
 }
 
 function confirm(prompt) {

package/src/core/config.js

@@ -32,6 +32,9 @@ const DEFAULT_CONFIG = {
   host: "127.0.0.1",
   log_level: "info",
   projects: [],
+  user: {
+    language: "en",  // ISO 639-1 two-letter code; used by transcription, super-agent, and wake-up message
+  },
   telegram: {
     enabled: false,
     bot_token: "",
@@ -87,6 +90,7 @@ export function mergeDefaults(cfg) {
   return {
     ...DEFAULT_CONFIG,
     ...cfg,
+    user: { ...DEFAULT_CONFIG.user, ...(cfg.user || {}) },
     telegram: {
       ...DEFAULT_CONFIG.telegram,
       ...(cfg.telegram || {}),

package/src/core/scaffold.js

@@ -176,7 +176,12 @@ export function installIdeSkills(root, targetIds = null) {
   return results;
 }
 
-// Install bundled APX/APC skills + runtime docs to global ~/.../skills/ dirs.
+// Install bundled APX/APC skills to global ~/.../skills/ dirs.
+// Only apx and apc-context are installed everywhere — they teach IDE tools
+// (Claude Code, Cursor, Codex) about the APX CLI and APC project standard.
+// Runtime CLI skills (claude-code, codex-cli, etc.) are APX-internal; APX
+// loads them from src/daemon/runtime-skills/ at startup and does NOT push
+// them to other tools' global skill dirs.
 // Returns an array of result objects with { dir, skill, status }.
 export function installGlobalSkills() {
   const results = [];
@@ -186,7 +191,8 @@ export function installGlobalSkills() {
   const apcRaw = readBundledSkill("apc-context");
   if (apxRaw) skills.push({ slug: "apx", md: apxRaw });
   if (apcRaw) skills.push({ slug: "apc-context", md: apcRaw });
-  skills.push(...readRuntimeSkillFiles());
+  // Runtime skills (claude-code, codex-cli, opencode-cli, openrouter, …) are
+  // NOT included here — they are APX-only internals, not for IDE consumption.
 
   for (const base of GLOBAL_SKILL_DIRS) {
     for (const { slug, md } of skills) {

package/src/daemon/transcription.js

@@ -55,9 +55,16 @@ async function getConfig() {
     const cfg = readConfig() || {};
     const t = cfg.transcription || {};
     const openaiKey = cfg.engines?.openai?.api_key || process.env.OPENAI_API_KEY || "";
+    // Use user.language as default for transcription language if not explicitly set.
+    // Explicit transcription.local.language always wins; "auto" means fall back to user.language.
+    const userLang = cfg.user?.language || "";
+    const localBase = { ...DEFAULT_LOCAL, ...(t.local || {}) };
+    if ((!localBase.language || localBase.language === "auto") && userLang) {
+      localBase.language = userLang;
+    }
     return {
       provider: t.provider || "auto",
-      local: { ...DEFAULT_LOCAL, ...(t.local || {}) },
+      local: localBase,
       openaiKey,
     };
   } catch {