@agentprojectcontext/apx 1.18.0 → 1.19.1

package/package.json

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

package/src/cli/commands/status.js

@@ -79,17 +79,43 @@ export async function cmdStatus() {
   }
 
   // ── Telegram ───────────────────────────────────────────────────────────────
+  // Prefer the daemon's live view (real polling state). Fall back to the
+  // config file only when the daemon is unreachable. The config check must
+  // honour BOTH the legacy top-level bot_token AND per-channel tokens.
   console.log(sec("Telegram"));
   const tg = cfg.telegram || {};
-  if (tg.enabled && tg.bot_token) {
-    console.log(`  ${ok("enabled")}`);
-    console.log(`${key("chat_id")}${val(tg.chat_id || "(not set)")}`);
-    console.log(`${key("bot_token")}${DI}${maskToken(tg.bot_token)}${R}`);
-    if (tg.channels?.length) {
-      console.log(`${key("channels")}${val(tg.channels.length + " configured")}`);
+  let tgLive = null;
+  if (daemonOk) {
+    try { tgLive = await http.get("/telegram/status"); } catch {}
+  }
+
+  if (tgLive) {
+    const channels = tgLive.channels || [];
+    const polling = channels.filter((c) => c.polling).length;
+    if (!tgLive.enabled) {
+      console.log(`  ${off("disabled in config")}   run: ${CY}apx setup${R}`);
+    } else if (channels.length === 0) {
+      console.log(`  ${off("enabled, no channels")}   run: ${CY}apx setup${R}`);
+    } else if (polling === 0) {
+      console.log(`  ${err("enabled, not polling")}   run: ${CY}apx telegram start${R}`);
+    } else {
+      console.log(`  ${ok("polling")}   ${val(`${polling}/${channels.length} channel${channels.length !== 1 ? "s" : ""}`)}`);
+    }
+    for (const c of channels) {
+      const mark = c.polling ? `${GR}●${R}` : `${RE}○${R}`;
+      const tok = c.bot_token_present ? "" : ` ${DI}(no token)${R}`;
+      const lastErr = c.last_error ? `  ${RE}${c.last_error}${R}` : "";
+      console.log(`${key(c.name)}${mark} ${DI}chat ${c.chat_id || "(unset)"}${R}${tok}${lastErr}`);
     }
   } else {
-    console.log(`  ${off("disabled")}   run: ${CY}apx setup${R}`);
+    // Daemon down — best-effort from config. Token may be top-level or per-channel.
+    const hasToken = !!tg.bot_token || (tg.channels || []).some((c) => c.bot_token);
+    if (tg.enabled && hasToken) {
+      console.log(`  ${off("configured")}   ${DI}daemon down — start it to see live status${R}`);
+      console.log(`${key("channels")}${val((tg.channels?.length || 1) + " configured")}`);
+    } else {
+      console.log(`  ${off("disabled")}   run: ${CY}apx setup${R}`);
+    }
   }
 
   // ── Projects ───────────────────────────────────────────────────────────────
@@ -114,11 +140,6 @@ export async function cmdStatus() {
   console.log();
 }
 
-function maskToken(token) {
-  if (!token || token.length < 12) return "***";
-  return token.slice(0, 6) + "…" + token.slice(-4);
-}
-
 function formatUptime(s) {
   if (!s) return "?";
   if (s < 60) return `${s}s`;

package/src/cli/commands/telegram.js

@@ -36,6 +36,29 @@ export async function cmdTelegramStatus() {
   }
 }
 
+export async function cmdTelegramStart() {
+  const r = await http.post("/telegram/start", {});
+  const channels = r.status?.channels || [];
+  const polling = channels.filter((c) => c.polling).length;
+  if (channels.length === 0) {
+    console.log("⚠️  no telegram channels configured — run: apx telegram setup");
+    return;
+  }
+  if (polling === 0) {
+    console.log("⚠️  polling did not start — check telegram.enabled in ~/.apx/config.json and that a bot_token is set");
+    for (const c of channels) {
+      if (c.last_error) console.log(`   ${c.name}: ${c.last_error}`);
+    }
+    return;
+  }
+  console.log(`✅ telegram polling (${polling}/${channels.length} channel${channels.length !== 1 ? "s" : ""})`);
+}
+
+export async function cmdTelegramStop() {
+  await http.post("/telegram/stop", {});
+  console.log("⏹  telegram polling stopped (config unchanged — apx telegram start to resume)");
+}
+
 export function cmdTelegramSetup() {
   console.log(`Edit ~/.apx/config.json — telegram section:
 

package/src/cli/index.js

@@ -52,6 +52,8 @@ import {
   cmdTelegramSend,
   cmdTelegramStatus,
   cmdTelegramSetup,
+  cmdTelegramStart,
+  cmdTelegramStop,
 } from "./commands/telegram.js";
 import { cmdMessagesTail, cmdMessagesSearch, cmdMessagesChat } from "./commands/messages.js";
 import { cmdLog } from "./commands/log.js";
@@ -598,13 +600,15 @@ const HELP_TOPICS = new Map(Object.entries({
   telegram: topic({
     title: "apx telegram",
     summary: "Configure, inspect, and send through the Telegram bridge.",
-    usage: ["apx telegram <send|status|setup> [args] [--flags]"],
+    usage: ["apx telegram <send|status|start|stop|setup> [args] [--flags]"],
     commands: [
       ["send \"text\"", "Send a Telegram message."],
       ["status", "Show Telegram plugin status."],
+      ["start", "Start polling on every configured channel."],
+      ["stop", "Stop polling (config stays intact)."],
       ["setup", "Print setup guidance."],
     ],
-    examples: ["apx telegram status", "apx telegram send \"hello\" --chat 123456"],
+    examples: ["apx telegram status", "apx telegram start", "apx telegram send \"hello\" --chat 123456"],
   }),
   "telegram send": topic({
     title: "apx telegram send",
@@ -626,6 +630,18 @@ const HELP_TOPICS = new Map(Object.entries({
     usage: ["apx telegram status"],
     examples: ["apx telegram status"],
   }),
+  "telegram start": topic({
+    title: "apx telegram start",
+    summary: "Start Telegram polling on every configured channel.",
+    usage: ["apx telegram start"],
+    examples: ["apx telegram start"],
+  }),
+  "telegram stop": topic({
+    title: "apx telegram stop",
+    summary: "Stop Telegram polling (config stays intact; resume with apx telegram start).",
+    usage: ["apx telegram stop"],
+    examples: ["apx telegram stop"],
+  }),
   "telegram setup": topic({
     title: "apx telegram setup",
     summary: "Print Telegram setup guidance.",
@@ -1441,6 +1457,8 @@ async function dispatch(cmd, rest) {
         const a = parseArgs(rest.slice(1));
         if (sub === "send") await cmdTelegramSend(a);
         else if (sub === "status") await cmdTelegramStatus();
+        else if (sub === "start") await cmdTelegramStart();
+        else if (sub === "stop") await cmdTelegramStop();
         else if (sub === "setup") cmdTelegramSetup();
         else die(`unknown telegram subcommand: ${sub || "(none)"}`);
         break;

package/src/daemon/api.js

@@ -442,6 +442,28 @@ export function buildApi({ projects, registries, plugins, scheduler, version, st
     res.json(telegram.status());
   });
 
+  // POST /telegram/start  — (re)start polling for every configured channel.
+  app.post("/telegram/start", (_req, res) => {
+    if (!telegram) return res.status(503).json({ error: "telegram plugin not loaded" });
+    try {
+      telegram.start();
+      res.json({ ok: true, status: telegram.status() });
+    } catch (e) {
+      res.status(502).json({ error: e.message });
+    }
+  });
+
+  // POST /telegram/stop  — stop polling on every channel (config stays intact).
+  app.post("/telegram/stop", (_req, res) => {
+    if (!telegram) return res.status(503).json({ error: "telegram plugin not loaded" });
+    try {
+      telegram.stop();
+      res.json({ ok: true, status: telegram.status() });
+    } catch (e) {
+      res.status(502).json({ error: e.message });
+    }
+  });
+
   app.post("/telegram/send", async (req, res) => {
     const { chat_id, text, channel } = req.body || {};
     if (!text) return res.status(400).json({ error: "text required" });

package/src/daemon/plugins/telegram.js

@@ -344,6 +344,8 @@ class ChannelPoller {
     while (this.polling) {
       try {
         const updates = await this._getUpdates();
+        // A successful poll clears any stale error so status reflects recovery.
+        this.lastError = null;
         for (const u of updates) {
           await this._handleUpdate(u);
           this.offset = u.update_id + 1;

package/src/daemon/super-agent.js

@@ -42,6 +42,11 @@ You are **APX** — Manuel's personal assistant running on his Mac.
 You are NOT a code analyzer, NOT a generic chatbot, NOT a tutor.
 You are an **action agent**: you USE TOOLS to do real things on Manuel's system.
 
+# Sobre Manuel (el usuario)
+- Se llama **Manuel**, es un desarrollador argentino.
+- Está en **Argentina**, timezone **UTC-3**. Cuando hables de horarios, asumí UTC-3 salvo que diga otra cosa.
+- Habla **español rioplatense** (voseo). Hablale así.
+
 # Language — non-negotiable
 ALWAYS reply in **Spanish (rioplatense, voseo when natural)** unless Manuel
 explicitly writes to you in another language for that turn. The user is an
@@ -49,6 +54,11 @@ Argentinian developer; English replies feel broken to him. If you find
 yourself writing English, stop and rewrite in Spanish before sending.
 This rule beats every other formatting hint below.
 
+# Mensajes de audio
+Si un mensaje empieza con "[audio]", lo que sigue es la transcripción de un
+audio que el usuario habló. Tratalo como su mensaje normal — no digas que "no
+escuchaste nada".
+
 # What you must NOT do
 - Do NOT explain code or write essays about "the provided snippet".
 - Do NOT describe what a tool *would* do — call it and report the result.
@@ -57,15 +67,39 @@ This rule beats every other formatting hint below.
 - If a user message is short or ambiguous, ASK one short clarifying question
   in Spanish — do not invent a topic.
 
-# How you operate
-You are the **APX dispatcher** — the daemon-level agent that runs above all APC projects.
-
-APX is a local daemon + CLI for APC projects. User-level runtime state lives under ~/.apx/:
-- ~/.apx/config.json: daemon config, engines, Telegram, super-agent settings
-- ~/.apx/projects/default: your default APX workspace; use it for system-level work when the user does not name a project
-- ~/.apx/agents: vault of reusable agent templates
-- ~/.apx/messages: global channel logs such as Telegram
+# Qué es APX y qué sos vos
+**Vos SOS el superagente de APX.** No sos un modelo genérico — sos el agente
+dispatcher que corre dentro del daemon de APX, y el usuario te habla por Telegram.
+
+APX es un daemon + CLI local para proyectos APC (Agent Project Context):
+- El daemon corre en localhost:7430 y mantiene estado en ~/.apx/
+- ~/.apx/config.json: config del daemon, engines, Telegram, ajustes del superagente
+- ~/.apx/projects/default: tu workspace por defecto; usalo para trabajo de sistema cuando el usuario no nombra un proyecto
+- ~/.apx/agents: vault de templates de agentes reutilizables
+- ~/.apx/messages: logs de canales globales como Telegram
+- Los **proyectos** son carpetas en disco con AGENTS.md y .apc/project.json (agentes, memorias, skills, hints de MCP, comandos, routines). Por ahora el único proyecto del usuario se llama \`default\`.
+
+Comandos de la CLI de APX (por si el usuario pregunta cómo hacer algo):
+- \`apx daemon start|stop|status|logs\` — controlar el daemon
+- \`apx status\` — estado completo de un vistazo (daemon, superagente, engines, Telegram, proyectos)
+- \`apx code\` — asistente de coding en terminal (TUI)
+- \`apx log\` / \`apx log -f\` — ver/seguir el log unificado en ~/.apx/logs/apx.log
+- \`apx update\` — actualizar APX a la última versión de npm
+- \`apx search <query>\` — buscar en mensajes/proyectos
+- \`apx project add <path>\` — registrar un proyecto
+- \`apx telegram status|start|stop|send\` — controlar el canal de Telegram
+- \`apx routine list|add|run\` — routines programadas
+- \`apx permission show|set\` — modo de permisos
+- \`apx setup\` — wizard de configuración inicial
+
+Tus tools (resumen — usalas, no las describas): list_projects / list_agents /
+list_mcps / list_skills para inventario; read_file / list_files / read_agent_memory
+para leer; write_file / add_project / import_agent para mutar; run_shell para
+comandos; call_agent / call_runtime para delegar; send_telegram para mandar
+mensajes/fotos/audio; load_skill para traer docs; web_search / browser_screenshot
+para la web; set_identity para cambiar tu nombre/personalidad.
 
+# How you operate
 APC projects are filesystem projects anywhere on disk with AGENTS.md and .apc/project.json. They contain agents, memories, skills, MCP hints, commands, and routines. The default workspace is not a user project; it is your APX home workspace. Registered projects are listed below as a tiny index; call tools for details.
 
 Useful CLI facts:
@@ -74,6 +108,7 @@ Useful CLI facts:
 - Routine design: if the user asks for an agent to think, decide, write, or reply, create an exec_agent routine with spec.agent and spec.prompt. If the user asks APX itself to orchestrate tools or Telegram, create a super_agent routine. If the request is only a deterministic command, create a shell routine. If unclear, ask one short question: "agent routine or simple command routine?"
 - Routine schedules: APX supports standard cron expressions (e.g. '*/5 * * * *'), OR 'every:<number><s|m|h|d>' (e.g. 'every:60s'), OR 'once:<iso-8601>'.
 - Safe read-only shell checks such as apx --help, apx routine list, docker ps, find, ls, rg, grep can run in automatico without asking.
+- Búsquedas en el filesystem: usá herramientas específicas y eficientes — \`find <dir> -name <patrón>\`, \`fd <patrón>\`, \`rg <texto>\` / \`grep -rn <texto>\`, o glob patterns concretos. NUNCA uses \`ls -R\` ni \`ls\` recursivo sobre directorios grandes (volúmenes, home, raíz) — es lento, primitivo y trae basura. Acotá siempre el directorio de búsqueda y el patrón.
 
 Channel context:
 - If the context note says Telegram, you are replying through Telegram. Use plain text, brief replies, no markdown tables, no code fences unless needed, no long dumps.

package/src/tui/_shims/cli-logo.ts

@@ -2,16 +2,16 @@ export type LogoShape = { left: string[]; right: string[] }
 
 export const logo: LogoShape = {
   left: [
-    "  __   ____  _  _  ",
-    " /__\\ (  _ )( \\/ ) ",
-    "/ _ \\  ) __/  )  ( ",
-    "\\___/  (__) (__/\\_)",
+    "   _    ___ __  __",
+    "  /_\\  | _ \\\\ \\/ /",
+    " / _ \\ |  _/ >  < ",
+    "/_/ \\_\\|_|  /_/\\_\\",
   ],
   right: [
-    "  __   ____  _  _  ",
-    " / _\\ (  _ \\( \\/ ) ",
-    "/    \\ )___/ )  /  ",
-    "\\_/\\_/(__)  (__/   ",
+    "  ___   ___   ___   ___ ",
+    " / __| / _ \\ |   \\ | __|",
+    "| (__ | (_) || |) || _| ",
+    " \\___| \\___/ |___/ |___|",
   ],
 }