@agentprojectcontext/apx 1.18.0 → 1.19.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agentprojectcontext/apx",
-  "version": "1.18.0",
+  "version": "1.19.0",
   "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/core/config.js

@@ -50,7 +50,7 @@ const DEFAULT_CONFIG = {
     name: "apx",
     model: "",                          // e.g. "ollama:llama3.2:3b"
     system: "",                         // optional override; defaults baked into super-agent.js
-    permission_mode: "automatico",       // total | automatico | permiso
+    permission_mode: "total",            // total | automatico | permiso
     allowed_tools: [],                   // used by permission_mode="permiso"
   },
   engines: {

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,17 @@ 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.
 
+# Cómo se reciben los mensajes de audio
+Cuando el usuario manda un audio por Telegram, el sistema lo transcribe
+automáticamente y te lo entrega en este formato:
+[audio] <texto transcripto del audio>
+
+Cuando veas "[audio]" al inicio del mensaje, significa que el usuario HABLÓ ese
+mensaje — lo que viene después es la transcripción exacta de lo que dijo.
+Tratalo exactamente igual que si el usuario lo hubiera escrito, pero sabiendo
+que fue hablado. Nunca le digas al usuario que "no escuchaste nada" o que "no
+hay ningún audio" — el audio YA fue procesado y lo tenés en texto delante tuyo.
+
 # 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 +73,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 +114,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.
@@ -235,7 +276,7 @@ export async function runSuperAgent({
     .map((p) => `  ${p.id}: ${p.id === 0 ? "[default]" : "[project]"} "${p.name}" (${p.path})`)
     .join("\n");
 
-  const permissionMode = sa.permission_mode || "automatico";
+  const permissionMode = sa.permission_mode || "total";
   const allowedTools = Array.isArray(sa.allowed_tools) ? sa.allowed_tools : [];
   const permissionNote = [
     "# Permission mode",